如何将现有项目上传至 GitHub

作者：Nicholas Cerminara

GitHub 是一个云托管的 Git 管理工具。Git 即分布式版本控制，意味着整个存储库和全部历史都将存在于您放置的位置。人们多在业务与开发的工作流程中使用 GitHub，用其托管储存库的备份。GitHub 还支持您与同事、朋友、组织等合作，这使它的功能变得更加强大。

本教程将向您介绍如何获取您正在开发的项目，并将其上传至 GitHub 上。

前期准备

为初始化存储库(repo)，并将其上传至 GitHub，您将需要：

一个可用的 GitHub 账户
本地电脑中安装了 git

第一步：创建一个 GitHub 存储库

警告：在本教程的其它部分中，我们将用 sammy 代替您的 GitHub 用户名，用 my-new-project 作为您创建的存储库名。但您需要将这些占位符替换成您的实际用户名和存储库名。这十分重要。

第二步：初始化项目文件夹中的 Git

导航到您要添加的文件夹后，在终端中运行下面的命令。

初始化 Git 存储库

首先确认您位于要上传的 GitHub 项目的根目录中，然后运行：

（注意：如果您已经初始化过 Git 存储库，您可以跳过这条命令）

$ git init

这一步会在您的项目文件夹中创建一个隐藏的 .git 目录。git 软件会识别该目录，并用它来存储项目的所有元数据和版本历史。

将文件添加至 Git 索引

$ git add -A

git add 命令用于告诉 git 需要提交哪些文件，-A (或 -–all) 参数表示“包括全部文件”。

提交已添加的文件

$ git commit -m 'Added my project

git commit 命令会创建一个新提交（commit），其中包含所有已“添加的”文件。-m (或 --message)可用来设置伴随它的信息，以帮助未来的引用理解该提交。在以下例子中，我们添加的信息是 “Added my project”

添加新的远程源

$ git remote add origin git@github.com:sammy/my-new-project.git

注意：请记住，您需要将标记部分的用户名与存储库名称替换成您自己的。

在 git 中，“远程(remote)”指的是同一存储库的远程版本，通常位于某个服务器上（本例中为 GitHub）。“origin”是 git 给远程服务器的默认名称（您可以有多个远程服务器），因此，git remote add origin 指示 git 为这个存储库添加默认服务器的 URL。

上传至 GitHub

$ git push -u -f origin main

-u (或 --set-upstream)标记将远程 origin 设置为上游引用。这样，您稍后就可以执行 git push 与 git pull 命令，且无需指定 origin。因为该情况下，我们一直需要用到 GitHub。

-f (或 --force)标记代表强制(force)，将覆盖远程目录中的所有目录。这里，我们用它来覆盖 GitHub 自动初始化后得到的默认 README。

注意：如果您在 GitHub 中创建项目时并未包括默认的 README，-f 标记就可以不用。

全部代码

git init
git add -A
git commit -m 'Added my project'
git remote add origin git@github.com:sammy/my-new-project.git
git push -u -f origin main