Git这个东西懂的人觉得它理所应当不懂的人光下载安装就能折腾一下午尤其是当你面对官网那堆英文选项、Windows安装向导里一连串看不懂的勾选框、Mac上莫名弹出来的权限警告还有Linux发行版之间完全不一样的包管理器时心态很容易崩。这份教程就干一件事把Git从下载、安装到配置、上手从头到尾捋一遍Win、Mac、Linux三个平台全覆盖能让你照着一步步点下去、敲下去就能顺利跑起来不走弯路。我默认看这篇的人大概率是刚接触Git的新手但也不排除有些人装到一半遇到问题搜到这里来。所以我会把安装过程中的每个关键选项都拆开讲明白不光是“让你这么选”还会说清楚为什么这么选。装完之后怎么验证、怎么配置姓名邮箱、怎么生成SSH密钥、怎么处理最常见的报错也都一并写上。1. 下载前先弄明白的三件事1.1 第一件事确认系统里有没有Git很多人上来就直奔官网下载其实你电脑里可能已经装过Git了纯粹是没发现或者装了旧版本自己忘了。先花10秒查一下系统里是否已经有Git能省掉很多重复劳动。Windows用户按Win键输入cmd或者powershell热词里有人问“为什么win加r打不开cmd”这个后面我会在问题排查里说一下通常的解法打开命令行窗口后输入git --version如果系统提示“git不是内部或外部命令”那说明确实没装继续往下看。如果返回了一串版本号比如git version 2.47.1.windows.1那说明你电脑上已经有Git了直接跳到第5章的配置部分就行或者选择更新到最新版本。Mac用户更隐蔽因为macOS有时候会自带一个Git的“壳”你敲git --version可能会弹出“安装命令行开发者工具”的提示框也可能直接告诉你版本号。先敲一下再决定要不要单独装Git。Linux用户则分情况Ubuntu/Debian系偶尔会在某些镜像里预装Git但大多数精简安装的服务器是不带的。用git --version查一下就知道。1.2 第二件事为什么建议大家只认官网下载Git官网地址是git-scm.com我不知道该用什么词反复强调但请一定只从官网或者系统官方的软件仓库下载。很多人搜索“Git下载”结果点进了各种所谓的“高速下载站”“软件园”下载下来一堆流氓捆绑软件、浏览器主页被篡改甚至下到木马这种现象在Windows平台尤其常见。官网下载页是git-scm.com/downloads它会自动识别你当前的操作系统页面顶部一般会显示“Downloads for Windows”或“Downloads for macOS”之类的提示。没识别出来也没关系页面上有Windows、macOS、Linux三个显眼的图标点进去就是对应的安装包列表。有人嫌官网下载慢这个确实是实际问题。如果你是Windows用户可以复制安装包的文件名去搜索引擎找国内大学或开源镜像站的资源但我只建议找那几个公认靠谱的镜像站。这个属于国内网络环境的常规操作不展开新手如果怕麻烦就老老实实从官网下耐心等一会儿Git安装包才几十MB大多数情况下不会慢到离谱。1.3 第三件事三大平台该选哪个版本包搞清楚官方下载页面长什么样之后对应平台的选择逻辑是这样的Windows用户认准64位64-bit版本。现在绝大多数电脑都是64位系统下载64-bit Git for Windows Setup这个文件准没错。除非你的电脑配置还停留在十几年前的32位系统才需要选32-bit。macOS用户需要留意芯片类型。2020年之后的M系列芯片M1/M2/M3/M4选择macOS Apple Silicon对应的安装包Intel芯片的Mac选择macOS Intel对应的安装包。选错也没关系系统会提示“无法打开”或架构不符换一个就行。Linux用户一般不需要去官网下载因为Linux系统的软件包管理机制会自动匹配当前系统架构x86_64、aarch64等直接在终端里用包管理器安装就行了这个在第4章会详细说。这第一步看似简单但确认好这三个前提后面能省很多麻烦。2. Windows安装全流程每一步都不白点2.1 安装向导里的关键选项拆解Windows版Git的安装界面是英文的很多人一看就慌其实真正需要你动脑子的选项不超过5个其余全用默认值就行。我把安装流程从头到尾过一遍重点讲那些容易被忽略但会影响使用体验的选项。下载好的文件通常叫Git-2.x.x-64-bit.exe双击运行如果弹出用户账户控制窗口点“是”。第一页是GNU通用公共许可证直接下一步接下来是选择安装路径建议保持默认的C:\Program Files\Git不推荐改到中文路径或带空格的特殊路径下免得以后某些工具识别出问题。真正值得注意的是以下几个界面第一个是Select Components选择组件。默认会勾选“Windows Explorer integration”在右键菜单里加Git Bash Here和Git GUI Here两个入口、“Git LFS”大文件存储、“Associating .git configuration files”等。我的建议是保持全选默认尤其是“Git Bash Here”这个选项它会在你鼠标右键时多出一个启动Git Bash的入口对新手来说比手动找终端再切目录方便太多了。如果没勾选后期想补也能通过重新运行安装程序来加。第二个是Select Default Editor默认编辑器。默认是Vim这个选择对新手最不友好——当你执行git commit需要编辑提交信息时会一头扎进Vim的界面里不知道怎么保存退出最后只能强制关掉终端提交也失败了。我强烈建议在这里选择“使用Visual Studio Code”或“使用Notepad”前提是你电脑上装了这些编辑器。如果下拉框里没有你的编辑器就选“Use Vimthe default text editor”先跳过后面可以用git config --global core.editor code --wait命令改成VS Code。这个步骤很重要不然第一次commit就能让你怀疑人生。第三个是Adjusting your PATH environment调整PATH环境变量。这个选项极其关键务必选择中间那个“Git from the command line and also from 3rd-party software”。如果你选了默认的“仅从Git Bash使用Git”那么打开CMD或PowerShell时输入git会提示找不到命令你会误以为安装失败了。选中间这个才能让git命令在CMD、PowerShell、各代码编辑器内置终端里都能直接使用。第四个是Choosing the SSH executable选择SSH可执行文件。保持默认“Use bundled OpenSSH”就行。这是Git自带的SSH客户端跟Windows系统自带的OpenSSH功能上没太大差别用默认的省心。第五个是Choosing HTTPS transport backendHTTPS传输后端。默认“Use the native Windows Secure Channel library”就好这是让Git调用Windows自带的证书库去完成HTTPS请求的处理在国内环境下连接Gitee、GitLab之类服务时兼容性和稳定性反而比另一个选项好。第六个是Configuring the line ending conversions配置行结束符转换。这个选项建议Windows用户使用默认的第一项“Checkout Windows-style commit Unix-style line endings”它的作用是当你从仓库里拉取代码时Git会自动把换行符转换成Windows的CRLF格式让本地的编辑器、IDE能正确显示当你提交代码时又自动转换成Unix/Linux标准的LF格式。这样的好处是保证仓库里的文件始终是LF换行避免团队里有人用Windows、有人用Mac/Linux时因为换行符差异产生一堆无意义的diff记录。第七个是选择终端模拟器默认“MinTTY”就行它比旧版的Windows Console更好用支持颜色高亮和调整窗口大小。最后一个是额外的文件性能配置默认选项就好。一路点“Install”等待安装进度条跑完勾选“Launch Git Bash”就能进入Git Bash窗口到这里Windows部分就算装完了。2.2 装完之后怎么验证装完之后别急着关安装程序先做两个最简单的验证动作确认Git真的能用并且路径没问题。第一个动作在桌面空白处点右键如果菜单里出现了“Git Bash Here”和“Git GUI Here”说明右键集成没问题。点开“Git Bash Here”窗口会是一个类Linux风格的黑框光标闪烁。在里面输入git --version如果返回类似git version 2.47.1.windows.1的信息那恭喜你安装成功。第二个动作打开CMD或PowerShell输入同样的命令。如果你在CMD里也能看到版本号说明PATH环境变量配置生效了后面用VS Code或者IDEA的内置终端时就能直接用git命令。如果CMD里提示不是内部或外部命令大概率是安装时PATH选项选错了或者装完之后没开新窗口环境变量要新窗口才生效。重新打开一个CMD再试如果还不行就只能重新运行安装包把PATH选项改成中间那个。2.3 这一栏最容易翻车的坑Windows平台装Git有几个坑几乎每个新手都会踩我集中列一下第一右键菜单里没有Git Bash Here。多半是安装时取消了“Windows Explorer integration”选项。不需要卸载重装直接重新运行安装程序在Select Components那一步勾选它然后一路下一步完成。第二CMD里无法识别git命令。这个前面说过了重点排查PATH选项。另外注意改完环境变量后一定要重新打开CMD旧窗口读到的还是修改前的环境变量。第三安装过程中杀毒软件报警。如果你用的是360、电脑管家这类软件安装Git时偶尔会弹出拦截提示。Git本身是开源软件官网下载的安装包一般不会有什么问题但杀软误判的情况偶有发生。遇到这种弹窗可以先把杀软退出安装完再打开或者把它加入信任区。第四第一次启动Git Bash窗口一闪而过就退出了。这种情况比较少但如果出现多半是终端模拟器配置冲突或环境变量有问题。试着用CMD输入bash来看报错信息能把原因暴露得更清楚。3. Mac安装先查自带版本再动手3.1 macOS可能自带GitMac用户有个天然优势macOS上可能已经自带了Git但它藏在一个比较深的地方而且不是你主动装的话Apple不会把它公开放到正常的PATH环境变量里。你打开“终端”Launchpad-其他-终端或按Command空格搜Terminal输入git命令git --version如果系统弹出一个英文提示框写着“需要安装命令行开发者工具”之类的说明你电脑上确实没有可用的Git需要通过该提示框安装或者跳过它自己手动装。如果直接返回了版本号说明Git已经存在。这时你看一下版本号比如git version 2.39.3 (Apple Git-145)这个“Apple Git”字样说明它是苹果官方编译的版本。能用但版本号可能偏旧。对于学习使用来说完全够但如果你想用最新版Git的特性或者不想等苹果更新系统才更新Git那最好还是自己装一份新版的。3.2 三条安装路线对比Mac上装Git有三种主流方式官方安装包、Homebrew、Xcode Command Line Tools。我分别说一下优缺点和适用人群。第一种从官网下载macOS安装包。在git-scm.com/downloads的macOS页面里根据你芯片类型下载dmg文件双击打开里面有一个.pkg文件双击按提示安装。这个方式直观跟你平时装Mac软件差不多装完就是最新版跟系统自带的那份旧版不冲突。好处是官网版本更新及时不需要额外依赖坏处是以后要更新Git时还得重新去官网下载安装。第二种Homebrew安装。这是macOS上非常流行的包管理器热词里有人问“mac安装homebrew报错”说明很多人已经在用了或者尝试装过一半没成功。如果你已经装好了Homebrew那Git的安装就一句话brew install gitHomebrew会自动处理依赖、下载最新版、配置好PATH。以后升级也方便一条brew upgrade git搞定。Homebrew安装Git是很多老开发者的首选。第三种通过Xcode Command Line Tools。前面提到当你敲git --version弹出需要安装提示框时点安装就可以自动装好一套命令行工具里面包含Git、Clang编译器、make等一堆开发工具链。这个方式最省心但你装到的版本随macOS版本而定不一定是最新的。3.3 按步骤走完处理Gatekeeper拦截如果你决定用官网dmg安装包按这个流程走第一步打开git-scm.com/downloads页面会提醒你选择Apple Silicon还是Intel不确定自己芯片类型的点左上角苹果图标-“关于本机”看“芯片”一栏写着Apple M系列就是Apple Silicon写着Intel就是Intel。第二步下载dmg后双击挂载Mac习惯叫挂载虚拟磁盘里面有个git-2.x.x-intel-universal.pkg或类似名字的安装包双击开始安装。第三步安装过程中可能会弹“无法打开因为Apple无法检查其是否包含恶意软件”或者要求输入管理员密码。前者是GatekeepermacOS的应用程序安全检测机制拦住了非App Store下载的应用。解决办法是打开“系统设置-隐私与安全性”往下找“安全性”区域会看到“已阻止使用...因为来自身份不明的开发者”点“仍要打开”再重新运行安装包就行。或者更省事的方式是按住Control键再点安装包图标弹出的菜单里选“打开”。装完之后重新开一个终端窗口执行git --version注意看返回的版本号。如果版本号和你从官网下载的一致说明新版Git生效了。如果显示的还是Apple Git那个旧版本说明系统PATH里旧版Git的路径排在了新版前面。检查一下which git看它定位到了哪里。常见情况是/usr/bin/git系统自带和/usr/local/bin/git官网安装的优先级问题。对新手来说最简单的解法是执行export PATH/usr/local/bin:$PATH如果你想永久生效把这一行加到~/.zshrc文件末尾然后执行source ~/.zshrc重载配置。4. Linux安装包管理器搞定大半4.1 Debian/Ubuntu系Linux用户应该对“包管理器”这个词不陌生但刚转向Linux的开发者可能还不太清楚为什么推荐用包管理器安装Git而不是去官网下载源码编译。原因很简单Git是一个跟系统底层交互较多的软件通过包管理器安装会自动处理依赖、动态库、PATH配置和后续的升级维护你不需要关心文件装到了哪里。自己下载源码用make install编译安装虽然也能成功但后续更新得手动重新编译相当麻烦。Debian/Ubuntu系列的安装命令很简单sudo apt update sudo apt install git -y第一行是刷新软件仓库索引第二行是从仓库安装Git。装完后验证git --versionUbuntu/Debian官方仓库里的Git版本可能不是最新的但绝对稳定对绝大多数开发场景来说完全够用。4.2 RHEL/CentOS系含Rocky/AlmaCentOS 7及更早的版本使用yumCentOS 8及之后的版本、Rocky Linux、AlmaLinux、Fedora这些使用dnf。先确认你的系统是哪个版本再选对应的命令。如果是CentOS 7或基于它构建的其他系统比如某些云服务器的默认镜像sudo yum install git -y如果是CentOS 8、Rocky Linux 8、AlmaLinux 8或Fedorasudo dnf install git -y这类系统有个特点yum/dnf仓库中的Git版本通常偏旧。如果你对版本有硬性要求比如要使用Git的一些新特性可以考虑添加EPEL仓库或者直接下载Git源码编译。但对大多数使用者来说仓库版本稳定够用不需要折腾。4.3 Arch与其它杂牌发行版的处理逻辑Arch Linux以及Manjaro等基于Arch的发行版包管理器是pacmansudo pacman -S gitArch的滚动更新机制保证了你装到的Git版本几乎永远是当前最新版。SUSE/openSUSE使用zyppersudo zypper install gitGentoo使用emerge这里不细说Gentoo用户普遍已经有自己的一套习惯。总的来说Linux安装Git的核心逻辑就一句话不要从源码开始折腾先认准你系统对应的包管理器搜索一下git这个包名安装它基本不会出问题。如果包管理器里找不到那多半是软件源镜像源配置有问题换一个国内可用的镜像源再update一下就行。另外提醒一点热词里出现“虚拟机安装linux蓝屏”这个跟Git本身关系不大但如果你的Linux是装在虚拟机里的安装Git时如果碰到网速慢、更新源超时大概率是虚拟机网络连接方式的问题。最简单的排查办法是把虚拟机网络改成NAT模式而不是桥接模式很多源更新失败的问题都能解决。5. 装完先别急着写代码这轮全局配置必须做5.1 用户信息与默认分支名Git能装好但直接开始用的话第一次提交时会报错提示需要设置你的身份信息。这个步骤相当于在Git里登记你的“签名”每次提交代码时提交记录里都会携带这个名字和邮箱。设置方式是在终端里执行git config --global user.name 你的名字 git config --global user.email 你的邮箱这里的名字用英文或拼音都行邮箱建议填你注册代码托管平台GitHub/Gitee时用的那个邮箱这样你提交的记录能被正确关联到你的账号。执行完可以用下面的命令验证是否设置成功git config --global --list另外建议把Git默认分支名从master改成main因为现在新项目默认用main作为主分支的做法更主流git config --global init.defaultBranch main这样你以后执行git init初始化新仓库时默认分支就是main省得后面还要手动改名称。5.2 换行符设置Windows用户尤其注意换行符问题在单机开发时影响不大一旦多人协作就变成一颗定时炸弹。Windows文件的换行是\r\n而Linux/macOS的换行是\n。如果团队里混合使用不同操作系统不小心把本地换行符直接提交进仓库会导致每次打开文件都有一大堆“整个文件被修改”的诡异diff记录。Windows用户在安装时如果保持默认选择就已经配置好了“checkout时转CRLF、commit时转LF”。这一套逻辑对新手最友好。如果你发现别人提交代码时没有这种换行符转换问题但自己提交时Git提示“warning: LF will be replaced by CRLF”或者反过来一般不必太在意那是Git在提醒你它做了自动转换。真要彻底关掉警告可以把autocrlf设置改成falsegit config --global core.autocrlf false但我不建议新手这么做保持默认更稳妥。5.3 记住凭据与中文路径显示优化Windows和Mac上做HTTPS操作比如通过http方式clone一个私有仓库时每次都要输入账号密码挺烦的。Git有自己的凭据管理器Windows版Git安装包自带“Git Credential Manager”它在第一次输入后会把凭据保存在Windows凭据管理器里之后自动使用。如果发现每次都要重新输入账号密码检查一下配置git config --global credential.helperWindows上输出一般是managerMac上如果没输出可以设置成osxkeychaingit config --global credential.helper osxkeychainLinux上一般用cache或store但这两个的安全性和体验都不如Windows/Mac那套方案。如果你在Linux上频繁使用HTTPS方式访问私有仓库更推荐直接用SSH方式一劳永逸。还有一个贯穿所有平台的小优化中文文件名显示问题。Windows的Git Bash默认情况下仓库里有中文文件名时执行git status会显示成八进制转义形式比如\346\265\213\350\257\225.txt这种乱码式输出。设置一下就能正常显示git config --global core.quotepath false这个设置很多人不知道但真的很实用。中文文件名、中文commit message都能正常显示了。5.4 SSH密钥生成连接GitHub/Gitee前必修课如果你打算用SSH方式连接代码托管平台GitHub、Gitee、GitLab等那就需要先生成SSH密钥。SSH密钥是一个公钥一个私钥的组合公钥放在代码托管平台私钥留在自己电脑里。推送代码时服务器通过公钥加密一个验证信息只有持有私钥的电脑才能解密从而确认“这确实是本人操作”。生成方式在不同平台完全一样打开终端Windows用Git Bash、Mac/Linux用系统终端执行ssh-keygen -t ed25519 -C 你的邮箱然后按三次回车或者自己设置私钥密码就会在默认位置生成密钥对。Windows路径是C:\Users\你的用户名\.ssh\id_ed25519Mac/Linux是~/.ssh/id_ed25519。公钥文件是id_ed25519.pub。接下来查看公钥内容cat ~/.ssh/id_ed25519.pub把输出的那一长串ssh-ed25519 ...复制下来。然后打开你的代码托管平台登录后找到“设置-SSH公钥”或“SSH Keys”入口标题随意填把公钥粘贴进去保存。测试是否配置成功ssh -T gitgitee.com如果Gitee返回“Hi 用户名Youve successfully authenticated”说明密钥配置成功。GitHub对应的是ssh -T gitgithub.com。这里有个常被忽视的坑Mac和Linux上即使密钥生成成功ssh-agent负责管理SSH密钥的后台服务也不一定自动加载这个新密钥连接远程仓库时可能报“Permission denied (publickey)”。手动把密钥加进去eval $(ssh-agent -s) ssh-add ~/.ssh/id_ed25519Windows的Git Bash一般不需要手动执行这一步装好的Git环境会自动加载。6. 高频命令与真实场景复盘6.1 新增提交的完整链路配置好Git之后第一次真正用Git建议跑通一个最简单的场景在任意文件夹里初始化一个仓库添加文件提交一次。这个流程覆盖了Git最核心的本地操作理解了它后面很多命令都能触类旁通。第一步新建一个项目文件夹并在终端里进入这个目录。Windows上可以右键文件夹选“Git Bash Here”Mac/Linux在终端里执行cd /path/to/your/project第二步初始化Git仓库git init这个命令会在当前目录下创建一个隐藏的.git文件夹里面保存了版本历史、分支指向等信息。它是Git仓库的核心以后不要手动去动它。第三步新建一个文件比如readme.md在里面随便写点内容。然后执行git status你会看到文件显示在“Untracked files”未跟踪文件列表里。这意味着Git知道有这个文件存在但还没纳入版本管理。第四步把文件加到暂存区git add readme.md或者更常用的是把所有变更加进来git add .暂存区可以理解成购物车——你把想提交的文件先放到这个区域然后统一执行提交。用git status再看一眼这个文件跑到了“Changes to be committed”下说明它已经准备好了。第五步提交到版本库git commit -m docs: 初始化项目说明文件这时如果弹出一个编辑器界面说明你装了默认的Vim且没有改默认编辑器或者你跳到下一步了。按我之前说的配置好core.editor为VS Code之后提交信息编辑体验会舒服很多。如果已经不小心进了Vim界面按:wq回车可以退出。提交成功后用git log --oneline就能看到这次的提交记录了。6.2 git commit --amend两种常用姿势热词里专门有人搜“git commit --amend怎么使用”这说明这个命令遇到的频率不低。它的作用是修改最近一次提交。两个最典型的使用场景第一个场景是提交信息写错了。你执行了git commit -m fix: 处理登录bug然后在代码评审时发现提交信息应该写成“fix: 修复登录接口超时问题”此时直接执行git commit --amend -m fix: 修复登录接口超时问题这个命令会“覆盖”掉最近一次提交把新的提交信息替换上去不会产生一条额外的“修正一下提交信息”的提交记录。第二个场景是漏提交了文件。你刚提交完突然发现少了一个文件或者某个文件有一行改动没加进去。先正常git add把遗漏内容加进暂存区然后再次执行git commit --amend不带-m的话会打开编辑器让你确认或修改提交信息保存退出后上一次提交就被替换成了包含遗漏文件的新提交。需要特别提醒的是--amend只能用于“还没有推送到远程仓库”的提交。如果这个提交已经推送到了远程分支而你又执行了amend远程和本地的提交历史就对不上了之后push会被强制要求强推造成其他协作者拉取冲突。新手在使用--amend前务必确认一下这个提交还没有push过。6.3 拉取推送时的冲突与解决办法本地提交做得再熟练早晚要接触远程仓库的协作。最常用的一对命令是git push把本地提交推送到远程和git pull把远程最新提交拉取到本地。以Gitee为例你先在网站上创建一个新仓库然后复制仓库的SSH地址形如gitgitee.com:用户名/仓库名.git。在本地仓库里执行关联远程仓库git remote add origin gitgitee.com:用户名/仓库名.gitorigin是Git对远程仓库的默认称呼叫它别的名字也行但大家都习惯叫origin。关联好之后推送到远程git push -u origin main-u的作用是把本地main分支和远程main分支建立跟踪关系以后就可以直接敲git push或git pull不用再带上分支名。如果团队协作中你和一个同事同时修改了文件的同一处地方你们先后推送后推送的那个人会收到冲突提示。Git不会直接帮你决定谁对谁错而是把冲突标记写进文件里格式大概长这样 HEAD 你本地的代码 远程拉下来的代码 远程分支名你需要打开这个文件手动选择保留哪部分内容删掉、、这些标记行然后重新git add和git commit。对于新手来说遇到冲突的第一反应千万别是慌。Git的冲突提示其实已经告诉你是谁改了什么冷静处理就行了。如果实在搞不定可以先用git stash把你的修改暂时藏起来执行git pull更新代码再执行git stash pop把修改还原回来此时如果还冲突就继续手动合并。7. 常见报错与排查速查7.1 出现频率最高的9个报错我定期会在技术社群里帮人看Git问题发现大部分新手遇到的报错就那几类把这几个记住基本能解决80%的困扰。报错信息原因解决办法git不是内部或外部命令Git没安装或PATH没配置重新安装并选对PATH选项新开终端窗口fatal: not a git repository当前目录不是Git仓库确认目录位置或先执行 git initAuthor identity unknown没设置user.name/user.email按第5章的全局配置设置Permission denied (publickey)SSH密钥未配置或ssh-agent没加载检查公钥是否粘贴到托管平台ssh-add添加私钥failed to push some refs本地落后于远程或远程有提交没拉取先git pull再pushrefusing to merge unrelated histories本地仓库和远程仓库没有共同的历史记录加--allow-unrelated-histories参数拉取LF will be replaced by CRLF换行符自动转换提示不影响功能可忽略或调core.autocrlfunable to access ... Could not resolve host网络无法访问远程仓库地址检查网络/代理配置国内可换镜像或改用SSHconnection reset by ...网络不稳定或代理异常重试或检查系统代理7.2 关于中文文件名变成\345\276的乱码这个问题Windows用户非常常见明明文件名是中文但执行git status时显示成\346\245\240.txt这种一串反斜杠数字。这是Git默认对非ASCII字符做的转义处理转义出来的数字其实是文件名的UTF-8字节码但人类根本没法直接读。前面第5章已经给过解决办法这里再强调一遍git config --global core.quotepath false设置完重新执行git status中文文件名就正常显示了。如果你已经遇到了这个问题但想确认这不是文件内容乱码放心这只是显示层面的问题文件内容实际没变。7.3 网络下载报错的常见疑点不管是下载Git安装包本身还是clone/拉取远程仓库网络问题都是绕不过去的坎。首先确认一件事你用的是HTTPS还是SSH方式。如果HTTPS clone仓库时报“Failed to connect to github.com port 443”这类错误多半是网络策略或代理问题。解决办法是尝试使用SSH方式clone或者检查你是否设置了系统代理。如果是下载Git安装包慢可以多试几次选择凌晨或工作日的空闲时段下载成功率会高很多。下载完成后建议验证一下文件哈希值官网下载页面会提供对应的SHA-256哈希值Windows下可以用PowerShell执行Get-FileHash 文件名Mac/Linux下用shasum -a 256 文件名比对结果和官网是否一致。这一步虽然啰嗦但能确认你下载的文件完整且未被篡改。热词里还有人搜“nasip port err(2)!”这个报错在Git环境下比较少见多半跟NAS或Docker容器里的git服务端口配置有关。如果是在NAS上用Git连接远程仓库遇到这个错优先检查NAS的端口映射和Git服务监听端口是否正确如果是本地容器环境检查容器端口是否暴露到宿主机。整体思路就是沿着网络路径逐层排查先ping宿主机再telnet端口最后看git输出日志。8. 最后聊几句实在的教程写到这里Git的下载、安装、配置、基本使用和常见问题都覆盖到了。我自己这些年用过非常多版本控制系统从SVN到Mercurial再到Git最终所有新项目都统一落在了Git上原因很简单它已经是整个行业的事实标准你遇到的问题几乎都有前人踩过坑并给出了答案。如果非要拎一条新手最该记住的经验我想说遇到Git报错别急着删掉重装。大部分报错都能通过git status、git log这两个命令看到端倪解决方案也成熟得很。把“看得懂状态、查得到历史”这两个基本功打好你就能在Git的世界里行走得很稳。最后分享一个我自己的小习惯在新电脑上装完Git后第一件事永远是执行下面三条命令想都不想git config --global user.name 你的名字 git config --global user.email 你的邮箱 git config --global core.quotepath false先把身份信息和中文显示问题解决掉后面所有操作都没那么多幺蛾子。至于换行符、默认编辑器、SSH密钥这些装完环境后花10分钟一次性配齐全程不超过一杯咖啡的时间。等你熟练了这套流程再回头看今天这些问题你会发现Git的安装和配置是整个使用过程中最简单的一环真正的乐趣在后面的版本管理和协作里。