如何将本地项目推送到GitHub：初学者指南

GitHub 是一个流行的代码托管和协作网站。如果你的电脑上有本地项目，并希望推送到 GitHub，本指南将一步步教你如何推送项目到 GitHub。让我们一步一步地了解整个过程，对于初学者来说，我们会详细解释每个细节。

先决条件

Git已安装在您的电脑上：您可以在终端里输入 git --version 来检查Git是否已经安装。如果没有安装，请下载Git，然后按照指示进行安装。

GitHub账号：如果您还没有GitHub账号，请在这里注册。

第一步：创建一个 GitHub 代码库

首先，你需要在 GitHub 上创建一个新建仓库，然后你可以提交你的本地项目。

去 GitHub：打开你的网页浏览器并访问一下 https://github.com。

登录 您的 GitHub 账号。

新建仓库：

• 在屏幕右上角找到 + 图标并点击它。
• 选择 新建仓库 选项。

仓库信息：

• 仓库名：给你的仓库起一个独一无二的名字（例如，my-local-project这样的形式）。
• 描述（可选）：为你的项目写一个简短的描述。
• 可见性：选择公开，让所有人都能看到你的项目，或者选择私有，让只有选定的人能访问你的项目。

初始化仓库时：不要勾选“将仓库初始化为包含 README 的选项”，因为我们推送的是一个已存在的项目。

点击“创建仓库”：你的新建GitHub仓库已经创建好了！

步骤 2：找到您的本地项目

现在你已经有了一个GitHub仓库准备好了，是时候开始你的本地项目工作了。

打开命令行：

• 在 Windows 上：您可以使用 Git Bash、命令行或任何终端程序。
• 在 Mac 或 Linux 上：直接使用终端。

导航到你的项目文件夹：在终端中使用 cd 命令导航到你的本地项目文件夹。例如（如下）：

请在命令行中运行 cd path/to/your/project 命令来切换到你的项目文件夹。这行命令用于切换到你的项目路径。

请确保你位于项目文件夹里。

接下来：在您的本地项目中初始化 Git 版本控制

在把项目推送到 GitHub 之前，如果你的项目文件夹还没有被初始化为 Git 仓库，你得先在项目文件夹中初始化 Git 版本控制系统。

初始化 Git 仓库：

如果你是第一次在你的机器上使用 Git，运行下面的命令来初始化 Git 仓库（仅第一次将你的本地仓库与远程仓库关联起来）：

    git init

这将初始化一个新的Git仓库。

这条命令会在你的项目文件夹里创建一个隐藏的 .git 文件夹（文件夹名以.开头），Git 会用它来跟踪你的项目。（按 Ctrl+H 可以显示隐藏文件）

查看状态：

您可以使用以下命令来查看代码仓库状态：

git 查看状态

这会显示出哪些文件现在可以被 Git 跟踪了。

第 4 步：将文件加入暂存区

要将你的项目推送到 GitHub，首先得把文件加到 Git 的暂存区里。

将所有文件添加到缓存区，运行以下命令来执行：

使用 `git add .` 命令将当前目录下的所有文件添加到暂存区。

在 git add 后面跟着的一个 . (点) 表示 "添加所有改动过的文件"。或者你可以指定个别文件。如果你想只添加特定的文件。

再次检查状态：

运行 git status 查看已暂存的变更。你应该能看到所有项目文件都列在已暂存的文件列表中。

第五步：保存更改

在 Git 中，commit 是用来保存你已暂存的更改。这样一来，在当前时刻为你的项目创建一个快照。

在提交更改时，并附上描述性的信息：

    git commit -m "第一次提交"

-m 标志允许你添加一条描述提交的说明，例如，对于第一次提交，你可以写“初始提交”作为说明。

步骤 6：将本地仓库链接到 GitHub

现在，你需要将你的本地 Git 仓库与你刚刚在 GitHub 上创建的那个仓库连接起来。

复制一下远程仓库URL ：

• 打开你的 GitHub 仓库页面。
• 点击绿色的 代码 按钮（通常是一个绿色的按钮，上面写着“代码”）。
• 复制 HTTPS 链接（它应该看起来像这样的格式：[https://github.com/用户名/仓库名.git](https://github.com/username/repository-name.git\).)）

将远程仓库添加到你的本地Git仓库:

在终端里运行以下命令将本地仓库链接到GitHub仓库：

将远程仓库添加到名为origin的源仓库。

git remote add origin https://github.com/username/repository-name.git

将 https://github.com/username/repository-name.git 替换为你 GitHub 仓库的具体网址。

第 7 步：上传本地项目到 GitHub

现在你已经可以将项目推送到了 GitHub。

推代码到GitHub仓库：

git push -u origin main

• -u 指定默认的上游仓库。

• origin 是默认的远程仓库名称。

• main 是 Git 中默认主分支的名称（在较旧版本中，这可能是 master）。

这会将你的项目文件夹上传到你的 GitHub 仓库的 main（或 master）分支。

步骤 8：在 GitHub 检查推送

推送代码之后，你可以在 GitHub 上检查项目的最新情况。

1. 回到 GitHub 上的仓库页面。
2. 刷新一下页面。
3. 现在你应该能看到仓库里的所有项目文件了。

恭喜你！你成功地将本地项目上传到了GitHub。

最后，我们得出结论是...

就这样！你现在知道如何将现有的本地项目推送到 GitHub 上了。这项技能对于项目合作、版本管理甚至代码部署来说非常重要。一旦你的项目上了 GitHub，你就可以跟别人分享，参与开源，或者甚至设置 CI/CD 流水线来实现自动部署。