1. 为什么2025年还要认真装一次Git很多人觉得Git安装就是一路“下一步”装完能敲git --version就算完事。我见过太多人栽在环境变量没配好、换行符把整个文件标记为修改、SSH密钥权限不对导致推送失败这些坑上。这篇文章面向的是刚接触版本控制的新手也适合那些装过Git但一直用得别扭、想彻底理清环境配置的老用户。我会以Win11为例把下载、安装、环境变量、SSH密钥、换行符、默认编辑器、代理配置这些环节全部拆开讲清楚每一步都说明为什么这么做以及不这么做会出什么问题。Git本质上是一个分布式版本控制系统它把每一次提交都存成一条完整的快照链而不是只存差异。这个设计决定了它可以在没有网络的情况下完成提交、回滚、分支切换等操作也决定了它的配置项会分散在系统级、用户级和仓库级三个层次。安装过程之所以重要是因为安装程序会决定Git的可执行文件放在哪里、默认的换行符策略是什么、SSH客户端用哪个、凭据管理器是否启用。这些选择一旦定下来后续改起来虽然可以但往往要翻文档、查配置远不如一开始就设对来得省心。Win11在这件事上有个特殊之处它的右键菜单改成了二级折叠样式而Git安装时勾选的“Git Bash Here”和“Git GUI Here”默认会注册到旧版菜单里。如果你不手动调整装完之后右键桌面可能看不到这两个选项会误以为安装失败。另外Win11对用户目录权限管得更严.ssh目录的权限如果不对SSH会直接拒绝使用密钥报出bad owner or permissions这类错误。这些细节在Win10时代不那么突出但在Win11上必须提前知道。下面我会按实际操作的顺序从下载安装包开始一直讲到用SSH成功推送到远程仓库中间穿插参数解释、配置命令和踩坑记录。你可以跟着一步步做也可以挑自己卡住的环节重点看。2. 下载与安装选对版本和选项2.1 下载渠道与版本选择Git for Windows的官方下载地址是git-scm.com打开后首页会自动识别你的系统并推荐对应版本。2025年当前稳定版是2.47.x系列建议直接下64位Standalone Installer不要下Portable版。Portable版虽然免安装但它不会自动配置环境变量也不会注册右键菜单对新手来说反而多出一堆手动步骤。下载时注意文件名的格式通常是Git-2.47.1-64-bit.exe这种。如果你在公司网络下可能会遇到下载速度极慢的情况这时候可以换用国内镜像站比如清华TUNA或阿里云的镜像。但要注意镜像站更新有延迟可能比官方慢一两个小版本对功能没有影响。提示不要从第三方下载站获取安装包那些站点经常捆绑推广软件而且版本可能被篡改。认准git-scm.com或可信的大学镜像站。2.2 安装向导逐项解读双击安装包后安装向导会依次询问一系列选项。很多人在这里一路默认结果后面用起来各种别扭。我把关键选项逐个说明。组件选择页默认勾选了“Windows Explorer integration”下的“Git Bash Here”和“Git GUI Here”这两个建议保留。另外“Associate .git* configuration files with the default text editor”也建议勾上这样双击.gitconfig文件会直接用编辑器打开方便改配置。“Use a TrueType font in all console windows”可以勾让Git Bash的字体更清晰。默认编辑器页默认是Vim但如果你不熟悉Vim的操作建议改成Nano或者你熟悉的编辑器。Vim对新手最大的问题是进去之后不知道怎么退出Esc然后:wq这套操作需要记。选Nano的话保存是CtrlO退出是CtrlX直观得多。如果你装了VS Code也可以选“Use Visual Studio Code as Gits default editor”但前提是VS Code已经装好并且code命令在PATH里。PATH环境变量页这是最关键的一步。三个选项分别是“Use Git from Git Bash only”、“Git from the command line and also from 3rd-party software”、“Use Git and optional Unix tools from the Command Prompt”。强烈建议选第二项。第一项意味着你只能在Git Bash里用Git在PowerShell或CMD里敲git会提示找不到命令。第三项会把Unix工具也加进PATH可能和系统自带的find、sort等命令冲突除非你明确需要那些工具否则不要选。SSH可执行文件页默认是“Use bundled OpenSSH”也就是用Git自带的SSH客户端。这个选择对绝大多数人来说是对的因为它和Git的版本匹配不会出现兼容问题。如果你已经有自己的SSH客户端并且有特殊配置需求可以选第二项但新手不建议。HTTPS传输后端页默认是“Use the OpenSSL library”保持默认即可。这个选项决定Git在用HTTPS协议访问远程仓库时用哪个库处理证书OpenSSL是跨平台的通用选择。换行符转换页这是第二个关键选项。三个选项分别是“Checkout Windows-style, commit Unix-style line endings”、“Checkout as-is, commit Unix-style line endings”、“Checkout as-is, commit as-is”。建议选第一项也就是常说的core.autocrlftrue。它的作用是检出文件时把LF转成CRLF提交时把CRLF转回LF。这样在Windows上编辑文件不会因为换行符问题导致整个文件被标记为修改同时推送到远程仓库的又是Unix风格的LF跨平台协作不会出乱子。终端模拟器页默认是“Use MinTTY”保持默认。MinTTY比Windows自带的控制台好用得多支持调整窗口大小、复制粘贴更顺手。额外选项页默认勾选“Enable file system caching”和“Enable Git Credential Manager”。前者提升性能后者帮你记住HTTPS方式的用户名和密码都建议保留。“Enable symbolic links”需要管理员权限普通用户可以不勾。安装完成后在开始菜单里能找到Git Bash、Git CMD、Git GUI三个入口。先打开Git Bash敲git --version如果输出版本号就说明安装成功。3. 环境配置让Git按你的习惯工作3.1 三个配置层级与查看方法Git的配置分三层系统级--system、用户级--global、仓库级--local。系统级对所有用户生效用户级对当前用户的所有仓库生效仓库级只对当前仓库生效。优先级是仓库级 用户级 系统级也就是说同一个配置项如果在多个层级都设置了仓库级会覆盖用户级。查看当前所有配置可以用git config --list加上--show-origin能看到每个配置项来自哪个文件。用户级配置文件在C:\Users\你的用户名\.gitconfig系统级在Git安装目录的etc\gitconfig。改配置时如果不加--global默认改的是仓库级所以设置用户信息时一定要加--global。3.2 必做的几项基础配置装完Git第一件事是设置用户名和邮箱因为每次提交都会记录这两个信息git config --global user.name 你的名字 git config --global user.email 你的邮箱example.com邮箱建议用你注册远程仓库时用的那个这样提交记录才能和你的账号关联上。如果公司有内部GitLab用公司邮箱如果用GitHub或Gitee用注册邮箱。第二件事是设置默认分支名。Git 2.28之后可以用init.defaultBranch指定新仓库的默认分支git config --global init.defaultBranch main不设的话默认是master虽然也能用但主流平台现在都推荐main提前设好省得以后改。第三件事是设置换行符策略安装时如果选了第一项这里其实已经配好了但可以确认一下git config --global core.autocrlf true第四件事是设置凭据管理器安装时勾了Git Credential Manager的话这里会自动配好。可以确认git config --global credential.helper manager这样用HTTPS方式推送时第一次输入账号密码后会被记住不用每次都输。3.3 中文乱码与路径问题Windows下Git Bash默认可能显示中文乱码原因是字符编码不一致。可以设置git config --global core.quotepath false git config --global i18n.commitEncoding utf-8 git config --global i18n.logOutputEncoding utf-8core.quotepath false让Git不把中文路径转义成八进制i18n两项保证提交信息和日志按UTF-8处理。另外在Git Bash窗口标题栏右键选Options在Text里把Locale设为zh_CNCharacter set设为UTF-8这样终端显示中文就正常了。注意core.quotepath这个配置在热词里出现过很多人搜它是因为git status显示的文件名是一串\344\275\240这样的转义字符设成false就恢复成正常中文了。4. SSH密钥配置从生成到推送4.1 为什么用SSH而不是HTTPSHTTPS方式每次推送都要验证身份虽然凭据管理器能记住但在多台机器、多个账号的场景下容易混乱。SSH方式用密钥对认证一次配置好之后推送拉取都不需要输密码而且密钥可以加passphrase保护安全性更高。远程仓库平台都支持SSH协议配置一次就能长期使用。SSH认证的原理是你本地生成一对密钥公钥放到远程仓库的账号设置里私钥留在本地。推送时远程服务器用公钥加密一段随机数据你的SSH客户端用私钥解密后发回去验证通过就建立连接。私钥永远不离开你的机器所以比密码方式安全。4.2 生成密钥对的完整步骤打开Git Bash先检查是否已有密钥ls -al ~/.ssh如果看到id_rsa和id_rsa.pub或id_ed25519和id_ed25519.pub说明已经有密钥了。没有的话用下面命令生成。现在推荐用Ed25519算法比RSA更短更安全ssh-keygen -t ed25519 -C 你的邮箱example.com-t指定算法-C是注释一般填邮箱方便识别。回车后会问保存路径直接回车用默认的~/.ssh/id_ed25519。然后问是否设置passphrase可以留空直接回车也可以设一个密码增加安全性。设了的话每次用密钥都要输这个密码可以用ssh-agent缓存避免重复输入。生成完用ls ~/.ssh能看到两个文件.pub结尾的是公钥另一个是私钥。查看公钥内容cat ~/.ssh/id_ed25519.pub输出是一行以ssh-ed25519开头的字符串复制整行。4.3 把公钥添加到远程仓库以GitHub为例登录后进Settings左侧选SSH and GPG keys点New SSH keyTitle随便填Key粘贴刚才复制的公钥内容保存。Gitee的操作类似在设置里找SSH公钥。GitLab在Preferences的SSH Keys里。添加完测试连接ssh -T gitgithub.com第一次连接会问是否信任主机指纹输yes。如果看到Hi 你的用户名! Youve successfully authenticated就说明配置成功。Gitee的话把域名换成gitee.com。4.4 Win11下的权限坑与解决Win11对.ssh目录的权限检查比Win10严格。如果.ssh目录或私钥文件的权限过于开放SSH会拒绝使用并报错bad owner or permissions on C:\\Users\\ThinkPad/.ssh/config这个错误在热词里出现过说明很多人遇到过。原因是Windows的权限继承机制让.ssh目录继承了父目录的权限导致其他用户或组也有读取权限。解决方法是在Git Bash里执行chmod 700 ~/.ssh chmod 600 ~/.ssh/id_ed25519 chmod 644 ~/.ssh/id_ed25519.pub chmod 600 ~/.ssh/config如果chmod不生效需要在Windows的文件属性里手动改。右键.ssh文件夹属性安全高级禁用继承然后删除所有继承的权限只保留你自己的用户账户权限设为完全控制。私钥文件同样处理只保留自己的读取权限。提示改权限时不要用管理员账户去改普通用户的.ssh目录否则可能把所有者改成管理员导致普通用户反而没权限。用当前登录的用户操作即可。4.5 多账号与config文件配置如果你同时用GitHub和Gitee或者有工作和个人两个账号需要配置~/.ssh/config文件来区分。创建或编辑该文件nano ~/.ssh/config写入类似内容Host github.com HostName github.com User git IdentityFile ~/.ssh/id_ed25519_github Host gitee.com HostName gitee.com User git IdentityFile ~/.ssh/id_ed25519_gitee这样访问不同域名时会自动用对应的私钥。生成密钥时用-f指定不同文件名即可。配置完同样要确保config文件权限是600。5. 常见问题与排查技巧实录5.1 安装后右键菜单找不到Git BashWin11的右键菜单默认是折叠的Git安装时注册的菜单项在“显示更多选项”里。如果你想让Git Bash直接出现在一级菜单有两个办法。一是按住Shift再右键会显示旧版完整菜单。二是改注册表把Win11右键菜单改回Win10样式这个操作在热词里也有很多人搜。具体是在管理员CMD里执行reg add HKCU\Software\Classes\CLSID\{86ca1aa0-34aa-4e8b-a509-50c905bae2a2}\InprocServer32 /f /ve然后重启资源管理器。想改回去就把这个注册表项删掉。不过改注册表有风险建议先备份。5.2 git status显示大量文件被修改但内容没变这是换行符问题。如果安装时没选core.autocrlftrue或者仓库里已有文件是LF而本地是CRLFGit会认为文件被修改了。解决方法是确认配置git config --global core.autocrlf true然后刷新索引git rm --cached -r . git reset --hard注意git reset --hard会丢弃未提交的修改操作前先确认没有需要保留的改动。如果仓库根目录有.gitattributes文件也可以在里面指定换行符策略比全局配置更精确。5.3 SSH连接超时或拒绝先检查网络是否能通ssh -vT gitgithub.com-v会输出详细日志能看到卡在哪一步。常见原因有公钥没添加到远程仓库、私钥权限不对、config文件有语法错误、防火墙拦截了22端口。如果22端口被拦可以改用HTTPS端口ssh -T -p 443 gitssh.github.com然后在~/.ssh/config里配置Host github.com的Port 443和HostName ssh.github.com。5.4 常见问题速查表问题现象可能原因解决方法git命令找不到PATH未配置重装并选第二项PATH选项中文文件名显示为转义字符core.quotepath为true设为false推送时提示权限拒绝公钥未添加或权限不对检查远程仓库公钥和本地文件权限每次推送都要输密码用了HTTPS且凭据未保存改用SSH或配置credential.helperbad owner or permissions.ssh目录权限过宽chmod 700和600换行符导致全文件修改core.autocrlf未设设为true并刷新索引Git Bash中文乱码终端编码非UTF-8设置Locale和Character set5.5 几个容易被忽略的实操心得第一安装路径不要带空格和中文。虽然Git本身支持但某些脚本和工具在处理带空格的路径时会出问题。默认的C:\Program Files\Git其实带空格如果你遇到奇怪的路径错误可以重装到C:\Git这样的纯英文无空格路径。第二git config --global改的是当前用户的配置如果你用管理员身份运行Git Bash改的是管理员的配置普通用户下不生效。所以配置时不要用管理员身份打开Git Bash。第三SSH密钥的passphrase如果设了又忘了只能重新生成密钥对没有找回的办法。所以要么不设要么记在安全的地方。第四Win11的Windows Terminal可以把Git Bash加进去作为profile这样在一个终端里就能切换PowerShell和Git Bash比单独开窗口方便。在Windows Terminal设置里添加新配置文件命令行填C:\Program Files\Git\bin\bash.exe图标可以选Git的图标。第五如果你同时装了Anaconda、Node.js、Python等多个开发环境PATH变量可能会很长Git的命令可能被其他同名命令覆盖。可以在Git Bash里用which git确认实际调用的是哪个路径的git确保是Git安装目录下的那个。6. 把Git融入日常开发流装好Git只是第一步真正提升效率的是把它和日常工具链串起来。比如在VS Code里内置的源代码管理面板就是调用Git命令配置好用户信息和SSH后可以直接在编辑器里提交、推送、拉取。VS Code的终端也可以设为Git Bash这样在编辑器里就能用熟悉的命令。如果你用PyCharm或IntelliJ IDEA在Settings的Version Control里可以指定Git可执行文件路径通常会自动检测到。配置好后IDE里的提交历史、分支管理、冲突解决都能可视化操作比命令行直观。对于Node.js项目npm install时如果依赖里有Git仓库地址会用系统的Git去克隆。所以Git配置正确与否会影响依赖安装。Python项目用pip从Git仓库安装包时同理。另外Git的全局忽略文件core.excludesfile可以配置一个统一的忽略规则避免每个仓库都写.gitignore。比如git config --global core.excludesfile ~/.gitignore_global然后在~/.gitignore_global里写*.log、.DS_Store、Thumbs.db这类通用忽略项。我在实际使用中的体会是Git的环境配置值得花半小时认真做一遍后面几年都省心。尤其是SSH密钥和换行符这两块配好了几乎不会再遇到推送失败或文件状态异常的问题。Win11的权限和右键菜单虽然有点折腾但按上面的步骤走一遍就能理顺。最后再分享一个小技巧把常用的Git命令设成alias比如git config --global alias.st status之后敲git st就等于git status能省不少敲键盘的时间。
