Windows 下安装 Git 和 Repo 的完整指南

在 Windows 上安装 Git 和 Repo 工具，是许多开发者和技术爱好者进行代码管理、尤其是参与大型开源项目（如 AOSP - Android 开放源代码项目）的第一步。对于刚接触的朋友来说，这个过程可能有些陌生。别担心，这篇文章将用最通俗易懂的语言，带你一步一步完成所有设置，让你轻松上手。

第一部分：安装 Git for Windows

Git 是一个分布式版本控制系统，是我们管理代码的基础工具。在 Windows 上安装它非常简单。

1. 下载 Git 安装程序

首先，我们需要获取 Git 的 Windows 版本安装包。请访问 Git 的官方网站下载页面。通常，网站会自动为你推荐适合 Windows 系统的“Standalone Installer”版本。直接点击下载 64 位或 32 位的安装程序即可，这取决于你的电脑系统类型（现在大多数电脑都是 64 位）。

2. 运行安装向导

下载完成后，双击运行你下载的 .exe 文件（例如 Git-2.xx.x-64-bit.exe）。安装过程基本就是一路点击“Next”，但有几个关键步骤需要注意一下：

选择安装路径：第一个界面是选择安装位置。除非你有特殊需求，否则直接使用它默认的路径（通常是 C:\Program Files\Git）就好，点击“Next”。
选择组件：接下来会问你要安装哪些组件。这里建议保持默认的全部勾选状态。其中“Git Bash Here”和“Git GUI Here”这两个选项非常实用，它们会在你右键点击文件夹时出现，方便你快速打开命令行或图形界面。
选择默认编辑器：这一步是选择 Git 提交代码时使用的文本编辑器。如果你不熟悉 Vim，建议在下拉菜单里选择“Notepad++”（如果你已安装）或“Windows 默认编辑器（Notepad）”，这样用起来更顺手。
调整 PATH 环境：这是很重要的一步！你会看到关于“Adjusting your PATH environment”的选项。请选择第二项：“Git from the command line and also from 3rd-party software”。这个选项会把 Git 的命令行工具添加到系统的 PATH 环境变量中，这样你就可以在任意位置（比如 PowerShell 或 CMD）直接使用 git 命令了。
选择 HTTPS 传输后端：使用默认的“Use the OpenSSL library”即可。
配置行尾转换：选择“Checkout Windows-style, commit Unix-style line endings”。这个设置能很好地处理 Windows 和 Linux/Unix 系统在换行符上的差异，避免很多不必要的麻烦。
选择终端模拟器：选择“Use MinTTY (the default terminal of MSYS2)”。MinTTY 的功能比 Windows 自带的控制台更强大，更好用。
其他选项：后续的几个选项，如“文件系统缓存”、“凭证管理器”等，都保持默认设置，一路“Next”到最后，点击“Install”开始安装。

3. 验证安装

安装完成后，你可以在开始菜单里找到“Git”文件夹，里面有“Git Bash”、“Git CMD”和“Git GUI”。为了验证是否安装成功，我们按 Win + R 键，输入 cmd 打开命令提示符，或者直接打开 PowerShell，然后输入：

git --version

如果屏幕上显示出类似 git version 2.xx.x.windows.1 的版本信息，那么恭喜你，Git 已经成功安装到你的 Windows 系统上了！

第二部分：安装并配置 Repo

Repo 并不是一个独立的程序，而是一个用 Python 编写的脚本，它帮助 Git 更好地管理由多个子项目（仓库）组成的大型项目。安装它需要几个步骤。

1. 安装 Python 环境

Repo 脚本需要 Python 环境才能运行。Windows 10 及更新版本通常已经自带了 Python。我们可以检查一下：在命令提示符或 PowerShell 中输入：

python --version

或

python3 --version

如果显示了 Python 3.x 的版本号（如 Python 3.9.6），说明已经安装。如果没有，你需要去 Python 官网下载 Windows 安装程序。安装时，务必记得勾选“Add Python 3.x to PATH” 这个选项，这样系统才能在任何地方找到 Python 命令。

2. 下载 Repo 启动器

Repo 工具本身是一个引导脚本。我们需要先把它下载下来。

在你的电脑上选择一个合适的位置来存放 Repo 脚本和相关代码。例如，你可以在 D:\ 盘下新建一个文件夹叫 MySource。
打开“Git Bash”（在开始菜单的 Git 文件夹里可以找到）。Git Bash 提供了一个类似 Linux 的环境，非常适合进行这些操作。
在 Git Bash 中，使用 cd 命令切换到你的工作目录：
```
cd /d/MySource
```
（注意：在 Git Bash 中，D:\ 盘被映射为 /d/）
下载 Repo 启动器。由于网络原因，直接访问 Google 的源可能比较困难。这里我们使用清华大学提供的镜像源，速度会快很多。执行以下命令：
```
curl -sSL https://mirrors.tuna.tsinghua.edu.cn/git/git-repo -o repo
```
这个命令会从清华镜像站下载一个名为 repo 的脚本文件到当前目录。

3. 配置 Repo 环境

为了让系统在任何地方都能识别 repo 命令，我们需要做一些配置。

方法一：创建可执行的批处理文件（推荐给新手） 在 Repo 脚本所在的目录（比如 D:\MySource）里，新建一个文本文件，将其重命名为 repo.bat（注意扩展名是 .bat）。然后用记事本等文本编辑器打开这个 repo.bat 文件，输入以下内容：

@echo off
set PYTHONIOENCODING=utf-8
python3 “D:\MySource\repo” %*

保存并关闭。这个批处理文件会调用 Python 来执行我们下载的 repo 脚本。

方法二：将 Repo 添加到系统 PATH（更一劳永逸）

将下载的 repo 脚本文件（注意，没有扩展名）移动到一个固定的、你容易记住的目录，例如 C:\Users\你的用户名\bin。如果 bin 文件夹不存在，就新建一个。
将上一步创建的 repo.bat 文件也移动到同一个目录（C:\Users\你的用户名\bin）。
将这个目录的路径添加到系统的 PATH 环境变量中。
- 在 Windows 搜索栏输入“环境变量”，选择“编辑系统环境变量”。
- 点击下方的“环境变量”按钮。
- 在“用户变量”或“系统变量”区域，找到名为 Path 的变量，选中并点击“编辑”。
- 点击“新建”，然后输入你存放 repo 和 repo.bat 的目录路径，例如 C:\Users\你的用户名\bin。
- 一路点击“确定”关闭所有窗口。

4. 验证 Repo 安装

打开一个新的命令提示符或 PowerShell 窗口（重要：必须新开一个，环境变量才会生效），输入：

repo --help

如果安装配置正确，你应该能看到一长串 Repo 命令的帮助信息，而不是“找不到命令”的错误提示。这说明 Repo 已经准备就绪了！

第三部分：初始化一个 Repo 工作目录（示例）

现在，让我们用 Repo 来初始化一个项目。这里以从清华大学镜像站同步 Android 源码的某个分支为例（这只是一个演示，实际同步需要巨大磁盘空间和很长时间）。

在你的工作目录（如 D:\MySource）下，创建一个用于存放 Android 源码的文件夹，并进入：
```
mkdir android-source
cd android-source
```
运行 Repo 初始化命令。我们需要告诉 Repo 项目的清单（manifest）仓库在哪里。使用清华镜像源：
```
repo init -u https://mirrors.tuna.tsinghua.edu.cn/git/AOSP/platform/manifest -b android-10.0.0_r1
```
这个命令会下载项目清单。-u 指定仓库地址，-b 指定分支。
如果这是你第一次运行 Repo，它可能会提示你配置用户名和邮箱，按照提示输入即可（可以和你的 Git 配置相同）：
```
git config --global user.name “Your Name”
git config --global user.email “you@example.com”
```
初始化成功后，你就可以使用 repo sync 命令来同步代码了（这一步非常耗时，仅作了解）。

避坑技巧与优化建议

网络问题：使用国内镜像源（如清华、中科大）是提升下载速度的关键，无论是安装 Python 包 (pip) 还是同步大型代码仓库。
权限问题：如果在运行 repo 时遇到权限错误，请确保你是在非系统管理员目录（比如用户目录或D盘）下操作，并以普通用户权限运行命令行工具。
Git Bash 是好朋友：在 Windows 上进行开发相关操作，强烈建议使用 Git Bash 而不是默认的 CMD。它提供了更强大的 Shell 功能和兼容性，很多 Linux 下的命令（如 ls, pwd, cat）都可以直接使用。
空间准备：像 AOSP 这样的项目，完整同步需要超过 200GB 的磁盘空间。请确保你的硬盘有足够空间。
更新 Repo：Repo 工具本身也会更新。你可以定期在 Git Bash 中运行 repo selfupdate 来更新到最新版本。