Git 安装与使用入门教程

本教程将引导你完成 Git 的安装、配置，并掌握最核心的操作：克隆远程仓库、添加、提交和推送你的代码。

第一步：安装 Git

首先，你需要在你的计算机上安装 Git。

Windows

1. 访问 Git 官网下载页面。
2. 下载适用于你系统的版本（通常是 64-bit）。
3. 运行下载的安装程序。在安装过程中，你可以直接使用默认设置，一路点击 "Next" 直到 "Finish" 即可。安装完成后，你可以在开始菜单找到 "Git Bash"，这是一个强大的命令行工具，推荐使用。

macOS

最简单的方式是使用 Homebrew 包管理器。打开“终端” (Terminal) 应用，执行以下命令：

# 如果你没有安装 Homebrew，先运行这个命令
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 使用 Homebrew 安装 Git
brew install git

另外，如果你安装了 Xcode 命令行工具 (Command Line Tools)，它也会附带安装 Git。

Linux (Debian/Ubuntu)

打开终端，执行以下命令：

sudo apt-get update
sudo apt-get install git

Linux (Fedora/CentOS)

打开终端，执行以下命令：

# Fedora
sudo dnf install git

# CentOS
sudo yum install git

第二步：首次运行 Git 前的配置

安装完成后，打开你的命令行工具（Windows 用户推荐使用 Git Bash，macOS/Linux 用户使用终端），进行全局配置，设置你的用户名和邮箱。这些信息会出现在你的每一次提交记录中。

# 设置你的用户名
git config --global user.name "Your Name"

# 设置你的邮箱地址
git config --global user.email "youremail@example.com"

注意：请将 "Your Name" 和 "youremail@example.com" 替换为你自己的真实信息，最好与你的 GitHub/GitLab 等代码托管平台账户保持一致。

第三步：拉取（克隆）远程仓库

“拉取”或“克隆”是指将一个远程服务器上（如 GitHub, GitLab）的仓库完整地复制到你的本地电脑上。

1. 获取仓库地址：在代码托管平台（如 GitHub）上，找到你想要克隆的仓库，点击绿色的 "Code" 按钮，复制 HTTPS 或 SSH 格式的 URL。对于初学者，HTTPS 更简单。

   例如：https://github.com/someuser/some-repo.git

2. 执行克隆命令：在命令行中，cd到你希望存放项目的文件夹，然后执行 git clone 命令。

   # 切换到你希望存放代码的目录
   cd /path/to/your/projects
   
   # 克隆远程仓库
   git clone https://github.com/someuser/some-repo.git
   

3. 进入项目目录：克隆完成后，会在当前目录下创建一个与仓库同名的文件夹。你需要进入这个文件夹来进行后续操作。

   cd some-repo
   

现在，你已经拥有了这个项目的一份本地副本。

第四步：添加、提交、推送本地文件

这是 Git 最核心的工作流：修改 -> 添加 -> 提交 -> 推送。

假设你已经在克隆下来的 some-repo 目录中。

1. 查看状态 (git status)

这是一个非常有用的命令，可以随时查看当前仓库的状态，比如哪些文件被修改了，哪些文件是新增的。

git status

2. 创建或修改文件

在项目目录中创建一个新文件，或修改一个已有的文件。 例如，我们创建一个 hello.txt 文件：

# 在当前目录下创建一个名为 hello.txt 的文件，并写入内容
echo "Hello Git World" > hello.txt

再次运行 git status，你会看到 Git 提示有一个“未跟踪的文件” (untracked files)。

3. 添加文件到暂存区 (git add)

在你提交之前，你需要告诉 Git 具体要提交哪些文件的改动。这个“准备提交”的区域被称为暂存区 (Staging Area)。

# 添加指定文件到暂存区
git add hello.txt

# 如果想添加所有修改和新增的文件，可以使用点号 .
# git add .

执行后，再次运行 git status，你会看到 hello.txt 已经变成了“准备提交的变更” (Changes to be committed)。

4. 提交变更到本地仓库 (git commit)

暂存区的文件准备好后，就可以将它们正式提交到你的本地仓库了。每一次提交都需要一条提交信息，用来简要描述这次提交做了什么改动。

# -m 参数后面跟着的就是本次提交的说明信息
git commit -m "Add hello.txt for tutorial"

提交完成后，你的本地仓库就已经保存了这次改动。

5. 推送变更到远程仓库 (git push)

本地提交只是保存在你自己的电脑上。为了让团队其他成员看到你的改动，或者为了在远程服务器上备份，你需要将本地的提交**推送 (push)**到远程仓库。

# 将本地的 main 分支推送到名为 origin 的远程仓库
git push origin main

• origin 是 Git 为你克隆的远程仓库起的默认名字。
• main 是当前主分支的名字（有些旧项目可能使用 master）。

执行该命令后，可能会提示你输入远程仓库（如 GitHub）的用户名和密码（或 token），按提示操作即可。

推送成功后，刷新你在 GitHub 上的仓库页面，就能看到你刚刚添加的 hello.txt 文件了。

总结：核心命令回顾

1. git clone [url]：克隆远程仓库到本地。
2. git status：查看当前工作区的状态。
3. git add [file] 或 git add .：将文件改动添加到暂存区。
4. git commit -m "message"：将暂存区的内容提交到本地仓库。
5. git push origin main：将本地仓库的提交推送到远程仓库。

掌握以上流程，你就已经具备了使用 Git进行基本协作开发的能力。祝你编码愉快！