导读

小白必看！还在为如何用 Git 把项目推送到 GitHub 抓狂吗？简单 6 步，让你从小白变高手，分分钟搞定本地项目上传！

使用工具

  • GitHub
  • Git
  • vscode

一、在 GitHub 上创建一个新仓库

  1. 打开 GitHub 网站 并登录。
  2. 点击右上角的 + 按钮，选择 New repository。
  3. 输入仓库名称并添加描述（可选）。
  4. 可以选择是否将仓库设为 Public（公开）或 Private（私有）。
  5. 点击 Create repository 按钮创建仓库。

你现在已经创建了一个 GitHub 远程仓库，但它还没有任何文件。接下来，我们将在本地初始化项目并将其与这个远程仓库关联。

二、初始化本地 Git 仓库

  1. 打开你的终端或命令行工具（在 Windows 上可以使用 Git Bash）。
  2. 进入到你的项目文件夹。可以使用以下命令：
    1
    cd path/to/your/project-folder
  3. 初始化 Git 仓库：
    1
    git init
    这个命令会在当前目录下创建一个 .git 文件夹，Git 会使用这个文件夹来跟踪和管理项目的版本。

    注意：.git 文件夹是 Git 的核心文件夹，里面存储了所有的版本控制信息。不要手动更改 .git 文件夹中的文件，以免影响 Git 仓库的正常工作。

三、将本地仓库与 GitHub 远程仓库关联

  1. 使用以下命令将本地项目与 GitHub 上的仓库关联：
    1
    git remote add origin https://github.com/your-username/your-repository-name.git
  2. 确认关联是否成功：
    1
    git remote -v
    执行这条命令后，应该会看到 origin 指向你在 GitHub 上的仓库地址。

四、将本地项目的代码添加到 Git 暂存区

  1. 使用以下命令将项目中的所有文件添加到 Git 的暂存区：
    1
    git add .
    • 其中，. 表示当前文件夹中的所有文件都会被添加。
    • git add 命令告诉 Git 哪些文件需要被跟踪，为下一步提交做准备。

五、提交代码到本地仓库

  1. 提交代码时，需要为这次提交添加一个说明：
    1
    git commit -m "first commit"
    • -m 表示提交时的说明信息。写上 “first commit” 或其他你认为合适的描述。
    • git commit 表示将代码正式提交到本地 Git 仓库，并创建一个保存点，便于后续恢复。

六、将代码推送到 GitHub 远程仓库

  1. 使用以下命令将本地代码推送到 GitHub：

    1
    git push -u origin master
    • -u 参数用于将本地的 master 分支与远程 origin 仓库的 master 分支关联起来。
    • origin 是远程仓库的名称，master 是分支名称。

    注意：这只是第一次推送时需要 -u 参数，以后只需使用以下命令：

    1
    git push origin master

这样可以将本地最新的代码推送到 GitHub 远程仓库中。

常见问题解答

  • Q： 我看不到 .git 文件夹，它在哪里？
    • A： .git 文件夹是一个隐藏文件夹，默认情况下系统会隐藏它。如果你想看到它，可以在文件管理器中启用“显示隐藏文件”选项。
  • Q： 为什么我在推送代码时要求输入 GitHub 用户名和密码？
    • A：如果你没有配置 SSH 密钥或使用 HTTPS 推送，GitHub 会要求你输入用户名和密码。建议使用 SSH 密钥进行身份验证，以减少手动输入用户名和密码的麻烦。

恭喜！到此为止，你已经成功将本地项目与 GitHub 远程仓库关联，并完成了代码的首次推送。下次需要更新代码时，只需执行以下命令即可：

1
2
3
git add .
git commit -m "your update message"
git push origin master

这样可以将最新的代码更新推送到远程仓库。