Windows 下 Git 和 GitHub 安装、配置及项目上传过程详解

Git 是一个分布式版本控制系统，用于跟踪文件的更改，协作开发，支持分支管理。GitHub 是一个托管 Git 仓库的云平台，可以方便地管理和分享你的代码。下面将详细介绍在 Windows 上安装 Git、配置 Git 和 GitHub，以及如何将项目上传到 GitHub。

1. 安装 Git

步骤 1: 下载 Git

  1. 打开 Git 官方网站：https://git-scm.com/
  2. 点击 Download 按钮，下载适用于 Windows 系统的 Git 安装包。

步骤 2: 安装 Git

  1. 双击下载的 .exe 安装包，启动 Git 安装程序。
  2. 在安装过程中，选择以下选项：
    • 选择安装路径：可以选择默认路径，也可以自定义路径。
    • 选择编辑器：Git 默认使用 Vim 编辑器，但可以选择其他编辑器（例如，选择 Visual Studio Code 或 Notepad++）。
    • Git 命令行工具选择：保持默认的选项（Git from the command line and also from 3rd-party software）。
    • 配置行结束符转换：建议选择 Checkout Windows-style, commit Unix-style line endings，这对于 Windows 用户是推荐配置。
    • 配置终端仿真：默认选择 Use MinTTY (the default terminal of MSYS2)，这样能提供一个更友好的命令行体验。
  3. 点击 Next 直到安装完成。

步骤 3: 验证安装

  1. 安装完成后，打开 Git Bash（安装时默认会安装 Git Bash）。
  2. 在 Git Bash 中输入以下命令以验证是否安装成功：git --version 如果显示类似 git version 2.x.x 的版本号，说明 Git 安装成功。

2. 配置 Git

在开始使用 Git 之前，需要配置你的用户名和电子邮件，这将用于标记每次提交。

步骤 1: 配置用户名和邮箱

  1. 打开 Git Bash，输入以下命令来配置用户名和邮箱：git config --global user.name "Your Name" git config --global user.email "your_email@example.com" 这里的 "Your Name" 和 "your_email@example.com" 需要替换成你自己的名字和邮箱地址。
  2. 可以通过以下命令来验证配置是否成功：git config --list 如果配置成功，会看到类似的输出：user.name=Your Name user.email=your_email@example.com

步骤 2: 配置默认文本编辑器

Git 会在需要输入信息时打开默认编辑器，例如 git commit 时输入提交信息。如果你想使用其他文本编辑器（如 VS Code），可以使用以下命令来配置默认编辑器：

git config --global core.editor "code --wait"

这样设置后，Git 会使用 Visual Studio Code 来编辑提交信息。

3. 安装 GitHub 客户端（可选）

GitHub 提供了 GitHub Desktop 客户端，它可以让你更轻松地使用 Git 和 GitHub。如果你不想手动操作命令行，可以安装并使用它。

  1. 下载 GitHub Desktop：https://desktop.github.com/
  2. 安装并登录你的 GitHub 账户。

GitHub Desktop 提供了图形界面，简化了许多 Git 操作，适合不熟悉命令行的用户。

4. 创建 GitHub 账户

  1. 打开 GitHub 官网：https://github.com
  2. 注册一个 GitHub 账户，填写用户名、邮箱和密码。

5. 生成 SSH 密钥并配置 GitHub（可选，但推荐使用 SSH）

为了便于与 GitHub 进行交互，建议使用 SSH 密钥进行身份验证。

步骤 1: 生成 SSH 密钥

  1. 打开 Git Bash，输入以下命令来生成 SSH 密钥：ssh-keygen -t rsa -b 4096 -C "your_email@example.com" 其中，your_email@example.com 要替换成你 GitHub 账户使用的邮箱地址。
  2. 然后会提示你输入文件名来保存密钥，直接按 Enter 键选择默认位置即可。
  3. 接下来会要求输入密码（可以选择为空），输入并确认。

步骤 2: 添加 SSH 密钥到 GitHub

  1. 复制生成的公钥：cat ~/.ssh/id_rsa.pub 将输出的密钥内容复制下来。
  2. 登录到 GitHub，点击右上角的头像，选择 Settings。
  3. 在左侧导航栏中选择 SSH and GPG keys。
  4. 点击 New SSH key，在 Title 字段输入一个描述（例如：My Windows PC），然后在 Key 字段粘贴之前复制的公钥。
  5. 点击 Add SSH key。

步骤 3: 测试 SSH 连接

在 Git Bash 中运行以下命令，检查 SSH 是否配置成功：

ssh -T git@github.com

如果一切配置正确，你会看到类似如下的信息：

Hi your_username! You've successfully authenticated, but GitHub does not provide shell access.

6. 将项目上传到 GitHub

步骤 1: 创建 GitHub 仓库

  1. 登录到 GitHub，点击右上角的加号（+），选择 New repository。
  2. 填写仓库名称、描述并选择是否公开（Public）或私有（Private）。
  3. 创建仓库。

步骤 2: 初始化 Git 仓库

  1. 打开 Git Bash，进入你的项目目录：cd path/to/your/project
  2. 初始化 Git 仓库：git init
  3. 将所有文件添加到 Git 仓库：git add .
  4. 提交更改：git commit -m "Initial commit"

步骤 3: 关联 GitHub 仓库并推送

  1. 将本地仓库与 GitHub 仓库关联。替换以下命令中的 your-username 和 your-repo 为你 GitHub 的用户名和仓库名称：git remote add origin git@github.com:your-username/your-repo.git
  2. 将本地代码推送到 GitHub 仓库：git push -u origin master 或者，如果你使用的是 main 分支：git push -u origin main

步骤 4: 验证上传

在 GitHub 上刷新你的仓库页面，应该能够看到上传的代码。

7. 使用 GitHub 提交更改（后续操作）

步骤 1: 拉取最新代码

在多人协作开发时，你可能需要从 GitHub 上拉取最新的代码：

git pull origin main

步骤 2: 提交代码

每次修改文件后，使用以下命令提交更改：

  1. 添加更改的文件：git add .
  2. 提交更改：git commit -m "Your commit message"
  3. 推送到 GitHub：git push origin main

8. 常用 Git 命令总结

  • 查看当前状态：git status
  • 查看提交历史：git log
  • 切换分支：git checkout <branch-name>
  • 创建新分支：git checkout -b <new-branch-name>
  • 合并分支：git merge <branch-name>
  • 删除分支：git branch -d <branch-name>
  • 查看远程仓库：git remote -v

总结

通过本教程，你已经学会了如何在 Windows 上安装 Git 和 GitHub，如何配置 Git 环境，以及如何将本地项目上传到 GitHub。掌握这些基本操作后，你就可以利用 Git 和 GitHub 进行版本控制、团队协作开发，并方便地管理你的项目代码。