1. Git与TortoiseGit环境部署全景指南
刚接触Windows开发的程序员经常会遇到版本控制的难题。Git作为当前最主流的分布式版本控制系统，配合TortoiseGit的图形化操作界面，能大幅降低学习曲线。我在团队新人培训时发现，90%的环境配置问题都集中在三个环节：安装顺序错误、换行符配置不当、密钥认证失败。下面我就用最直白的语言，带你完整走一遍这个流程。
首先明确几个基本概念：Git是核心引擎，负责所有版本控制的核心功能；TortoiseGit是外壳程序，提供右键菜单等图形界面。就像汽车发动机和方向盘的关系，必须先装Git再装TortoiseGit。我见过不少开发者反向操作，结果TortoiseGit找不到git.exe报错。整个部署过程可以分为四个关键阶段：Git安装配置 → TortoiseGit安装 → SSH密钥生成 → 远程仓库连接。每个阶段都有需要特别注意的技术细节。
2. Git安装详解与避坑指南
2.1 安装包获取与版本选择
官网下载永远是最稳妥的选择（git-scm.com/download/win）。有个冷知识：32位版本在老旧电脑上兼容性更好，但现代设备建议直接选择64位。最近帮同事排查一个诡异bug，最后发现是因为他误装了32位版本导致大文件操作异常。安装时记得勾选"Git Bash Here"和"Git GUI Here"选项，这两个右键菜单在后续操作中非常实用。
2.2 换行符配置的终极选择
安装过程中最重要的就是换行符(Line Ending)配置页面，这里埋着最多坑。Windows用CRLF，Linux/macOS用LF，跨平台协作时就会乱套。实测推荐选择**"Checkout Windows-style, commit Unix-style"**：
- 本地工作时自动转为CRLF（保证记事本等工具正常显示）
- 提交仓库时自动转回LF（确保跨平台一致性）
去年我们团队有个项目出现上千行冲突，根源就是有人选了第三项"Checkout as-is"。特别提醒：如果项目包含.sh、.py等脚本文件，务必保持LF格式，否则在Linux服务器上执行会报错。
2.3 环境变量配置技巧
安装向导默认会勾选"Git from the command line and also from 3rd-party software"，这个选项会自动配置PATH环境变量。有个常见误区：很多人以为勾选"Use Git Bash only"更安全，结果导致TortoiseGit无法调用Git命令。曾经有新人折腾两小时找不到原因，其实就是这个选项惹的祸。
3. TortoiseGit安装与初始配置
3.1 安装顺序与语言包陷阱
一定要在Git安装完成后再装TortoiseGit（官网：tortoisegit.org/download/）。有个容易忽略的细节：语言包必须在主程序之后安装。我遇到过有人同时下载主程序和中文包，然后先装语言包导致界面还是英文。安装时建议取消"Run First Start Wizard"选项，因为默认设置可能不适用国内网络环境。
3.2 关键路径配置
首次运行时需要指定git.exe路径，通常位于C:\Program Files\Git\bin\git.exe。这里有个隐藏技巧：如果安装时修改了Git的安装目录，可以通过右键菜单 → TortoiseGit → Settings → General页面重新指定。上周帮实习生解决的一个问题就是路径指向了旧版本Git，导致各种莫名错误。
3.3 用户信息全局配置
在Settings → Git页面设置user.name和user.email时，建议使用--global参数全局配置：
git config --global user.name "你的姓名" git config --global user.email "公司邮箱"注意邮箱必须与GitLab/GitHub账号一致，否则提交记录不会关联到你的账号。曾经有同事抱怨提交记录显示为陌生用户，排查发现他在不同电脑用了不同邮箱。
4. SSH密钥配置全流程
4.1 密钥生成最佳实践
使用PuTTYgen生成密钥时（开始菜单搜索即可），有三大要点：
- 密钥类型选择RSA（兼容性最好）
- 密钥长度至少2048位
- 生成过程中要不停移动鼠标增加熵值
保存私钥时建议用id_rsa.ppk命名，并存储在C:\Users\用户名\.ssh目录。关键提醒：一定要设置密钥密码（Key Passphrase），去年有同事私钥泄露导致代码被篡改。
4.2 GitLab密钥绑定
复制PuTTYgen生成的公钥（注意是上面文本框的内容）到GitLab的SSH Keys设置页面。常见错误是复制了错误内容，正确的公钥开头是ssh-rsa AAAAB...。完成绑定后，可以用以下命令测试连接：
ssh -T git@gitlab.example.com如果看到欢迎信息说明配置成功。最近GitLab升级后强制要求ED25519算法，传统RSA密钥需要额外配置。
4.3 Pageant自动加载方案
Pageant是TortoiseGit的密钥管理器，可以通过启动项自动加载密钥。创建包含以下内容的bat脚本：
start "" "C:\Program Files\TortoiseGit\bin\pageant.exe" "C:\Users\用户名\.ssh\id_rsa.ppk"将其放入启动文件夹（Win+R输入shell:startup）。有个实用技巧：给bat文件设置快捷键，需要时手动触发。遇到过Pageant崩溃导致提交失败的情况，重启Pageant就能解决。
5. 高频问题排查手册
5.1 克隆失败分析
当出现"Permission denied (publickey)"错误时，按以下步骤排查：
- 检查Pageant是否加载了正确密钥
- 运行
ssh -vT git@gitlab.example.com查看详细日志 - 确认GitLab账号有项目访问权限
上周处理的一个案例是用户同时存在多个密钥，需要在.ssh/config中指定：
Host gitlab.example.com IdentityFile ~/.ssh/id_rsa.ppk5.2 提交乱码解决方案
中文文件名出现乱码时，执行：
git config --global core.quotepath false同时确保TortoiseGit设置 → Git → Enable UTF-8 on commit勾选。这个坑我踩过三次，特别是从旧版本Git迁移时容易出现。
5.3 证书过期处理
遇到"SSL certificate problem"错误时，可能是系统证书过期。更新方法：
- 下载cacert.pem最新版
- 设置环境变量：
GIT_SSL_CAINFO=路径/cacert.pem - TortoiseGit设置 → Network → SSL CA证书路径
对于内网Git仓库，可能需要将CA证书导入Windows证书管理器。去年公司证书轮换时，这个问题困扰了整个开发团队两天。
