Git 指南
Git 是分布式版本控制工具,用于记录代码历史、协作开发和回滚变更。这篇文档按下载安装、环境变量配置和安装验证的顺序整理。
Windows Git 下载和安装
git 下载地址,国内用户推荐使用清华源:
https://mirrors.tuna.tsinghua.edu.cn/github-release/git-for-windows/git/LatestRelease/
点击目前最新版本,例如 Git-2.54.0-64-bit.exe
备用镜像地址:
https://mirrors.ustc.edu.cn/github-release/git-for-windows/git/LatestRelease/ https://mirror.nju.edu.cn/github-release/git-for-windows/git/LatestRelease/ https://mirrors.huaweicloud.com/git-for-windows/
安装时选择默认选项即可。
配置环境变量
setx PATH "%PATH%;C:\Program Files\Git\cmd"
# 测试安装成功
git --version
linux/wsl 安装
sudo apt-get install git
# 测试安装成功
git --version
配置用户信息
在进行 commit 操作前,需要配置用户信息,包括用户名和邮箱,仅用于标识提交者,可任意填写。
git config --global user.name "Your Name"
git config --global user.email "youremail@domain.com"
参考学习资料
(可选)代理配置(HTTP vs SOCKS5 / SOCKS5h)
- Git 使用 HTTPS 协议 →
http和socks5/socks5h都可以 - Git 使用 SSH 协议 → 必须使用
socks5/socks5h(HTTP 代理不支持)
三种代理的本质区别
| 类型 | 层级 | 支持协议 | DNS 解析方式 | 典型用途 |
|---|---|---|---|---|
| HTTP | 应用层 | 仅 HTTP/HTTPS | 本地解析 | 最通用、兼容性最好 |
| SOCKS5 | 传输层 | 任意 TCP/UDP | 本地解析 | 通用隧道,可代理 SSH / Git / 数据库等任意 TCP |
| SOCKS5h | 传输层 | 任意 TCP/UDP | 远端代理解析 | DNS 也走代理,避免 DNS 污染,国内访问 GitHub 更稳定(推荐) |
| 场景 | 推荐 |
|---|---|
| 企业网络 / 仅 HTTPS clone | HTTP |
| 需要 SSH / 国内访问 GitHub / 使用 Clash/V2Ray | SOCKS5h |
配置命令
# 如果使用 GitHub 的 HTTPS 地址模式
git config --global http.proxy http://127.0.0.1:10809
git config --global https.proxy http://127.0.0.1:10809
# 如果你有本地 SOCKS 代理端口(如 10808),推荐使用 SOCKS5 / SOCKS5h
git config --global https.proxy socks5h://127.0.0.1:10808
git config --global http.proxy socks5h://127.0.0.1:10808
# 查看是否生效
git config --global --get http.proxy
git config --global --get https.proxy
# 配置信息可查阅 %USERPROFILE%\.gitconfig 或者 ~/.gitconfig 文件
# 测试连接
git ls-remote https://github.com/git/git
# - `ls-remote` 仅测试远程连接,不会下载代码
# - 若成功返回分支列表,说明代理正常
# 清除代理
git config --global --unset http.proxy
git config --global --unset https.proxy