我见过太多人卡在Git这一步。不是技术有多难而是下载安装这块儿就被各种版本、各种报错劝退了。很多人写了好几年代码问起来还在用文件名_v2、文件名_final这种原始方式管理文件说实话我看着都替他们着急。Git这东西本质上就是个版本管理工具。你可以把它理解为给操作系统装上的时间机器——你写的文档、代码、哪怕是一篇几百行的配置脚本只要纳入Git管理每次改动都会被记得清清楚楚。改坏了能回退想对比不同版本能直接看差异团队协作也再不用发愁谁覆盖了谁的文件。不管你是搞开发、做数据分析、写技术文档还是纯粹想管理自己电脑上的重要文件Git都是绕不开的一个词。这篇教程不聊那些枯燥的源码编译思路只聚焦一件事怎么把Git干净利落地装到你电脑上并且完成那几项必须做的初始化配置。从选版本、走完安装向导到设置用户名邮箱和SSH密钥我把每一步的注意点都写在操作位置covers所有系统的常见坑。新手照着做就能跑通老人也能查漏补缺。1. 动手下载前先把这几件事想明白1.1 你究竟需要哪个版本的Git很多人上来就搜“Git最新版本下载”然后看到官网那一堆名词就懵了。实际上下载页面给出的版本对你来说没那么关键真正要考虑的是你的操作系统和CPU架构。先说个比较常见的认知误区Git不是版本越新越好。对于绝大多数使用者官方发布的稳定版非RC、非预览版就足够了。新版本往往带来新功能但偶尔也会引入一些兼容性问题。我自己比较习惯的做法是下载页面里标记为“Latest”的那个稳定版本如果它发布的日期在近三四个月内直接拿它如果太久没更新就往前翻一个版本避开一些潜在问题。另一个容易忽略的是系统架构。这两年新电脑基本都是ARM64架构的芯片但很多下载站点默认给的是x64的安装包装完倒是能跑但偶尔会遇到莫名的性能问题或者兼容性报错。在下载之前先确认一下你的系统版本Windows设置 → 系统 → 关于查看“系统类型”一栏标注的是x64还是ARM64macOS左上角苹果标志 → 关于本机 → 芯片类型Apple Silicon还是IntelLinux终端里执行uname -mx86_64或者aarch64拿着这个信息去官网选对应的安装包才能少走弯路。1.2 不同系统下载通道怎么选Git的获取渠道其实不止一个我按系统分类给你拆一下每种方式都说说它的优缺点。Windows系统官方渠道是git-scm.comGit的官方网站该站提供exe格式的安装程序属于最省事的方案。如果你想省去单独安装的步骤也可以在命令行包管理器里装在PowerShell中执行winget install --id Git.Git -e就能完成自动下载安装适合对命令行操作比较熟悉的用户。官网安装包的好处是选项可定制方便你手动勾选需要的组件winget的优点是快捷、能自动配置环境变量适合想省时间的场景。我自己的建议是第一次装还用官网安装包因为可以顺便看清每个安装选项的含义这套流程走一遍对Git的认识能上一个台阶。Linux系统不用去官网下载。主流发行版官方源里都有Git直接调包管理器即可。Debian和Ubuntu系执行sudo apt install gitRedHat系CentOS、Fedora执行sudo dnf install gitArch系执行sudo pacman -S git。这些命令装出来的版本可能不是最新的但胜在稳定而且与系统库的兼容性经过了充分测试适合作为主力开发环境。macOS系统macOS自带git在新版系统中输入git命令会提示安装Command Line Developer Tools。但如果你计划认真使用Git我不太建议只依赖系统自带的版本——它更新不够及时而且可配置性偏弱。推荐使用Homebrew安装执行brew install git就能得到最新版管理起来也方便。下载通道说到底没有绝对优劣关键是找一个稳定、可重复执行的渠道。你在教程里看到各种方法本质上都是让你能把Git可靠地装进系统里。2. 三个操作系统下的完整安装过程2.1 Windows端安装每个界面选项的含义Windows安装包是向导式的双击运行后一步步Next但中间有几个界面别闭着眼睛跳选错了后面会带来一些不必要的麻烦。第一个要留意的界面是“选择组件”。默认情况下Git Bash Here和Git GUI Here两个选项是勾选上的建议保持勾选。前者提供了Git自带的命令行环境里面很多指令和Linux一致后文讲的不少操作都可以在这个终端里执行强烈推荐保留。建议额外勾选Add a Git Bash Profile to Windows Terminal这个选项让Git Bash集成到Windows Terminal的标签页列表里多标签操作会舒服不少。如果看到Scalar、OpenSSL这类学术名词保留默认即可。第二个关键界面是“默认编辑器选择”。这个很重要它决定你之后每次提交代码时写提交信息的工具。默认给的是Vim但Vim的操作逻辑对不熟悉的老伙计们太不友好了——进去之后甚至不知道怎么保存退出指令是:wq写在这里怕你们急用。如果你电脑里装有VS Code这里直接选Use Visual Studio Code没装的话选Notepad或者直接选Vim都行后续也可以改配置。第三个关键界面是“调整PATH环境变量”。这里必须选第二项Git from the command line and also from 3rd-party software。选第一项意味着只能在Git Bash里用git命令在普通的PowerShell或CMD窗口打git会提示找不到命令选第二项则会自动把Git的bin目录加进系统PATH任何时候都能直接调git兼容性最好。第四个界面是“配置换行符转换”。下面三个选项分别是检出时转换、提交时转换回Windows风格↔Unix风格检出时不转换、提交时转换只把文件改为Unix风格再入库不转换文件保持原样我的选择永远是Checkout as-is, commit as-is也就是第三项。虽然这个方案在跨平台协作时偶尔会碰到换行符不一致的尴尬但对单人开发或纯Windows环境来说最省心而且这个选项切换成本低下次改也不麻烦。最后是“配置终端模拟器”和“额外功能开启”。终端模拟器选择MinTTY还是Windows自带的控制台窗口直观感受差别不大建议保留默认的MinTTY它的复制粘贴选中逻辑更适合命令行操作。额外功能里的文件系统缓存和符号链接支持前者保留后者不建议勾选——Windows上符号链接权限模型比较麻烦勾了反而容易报错。安装进度条跑完后桌面上不会自动生成什么图标别慌这是正常的。找到开始菜单里新出现的Git Bash或Git GUI也能打开终端输入git --version验证一下输出了版本号就说明装好了。2.2 Linux端安装一条命令搞定Linux下安装真就是一条命令的事但有两个容易出错的地方值得提前说。一是不要用源码编译安装。网上不少教程让你去官网下tar包自己编译操作繁琐且编译时间很长如果缺少依赖库还会直接编译失败。发行版仓库里的Git版本通常够用真的遇到必须用新版特性的需求再去考虑第三方维护的更新版本库。二是注意安装后补一个操作。装完后随便找个目录打开终端输入git --version如果系统提示找不到命令大概率是PATH环境变量里没有包含Git的安装路径。用which git查看实际安装位置再手动把路径加入PATH。Debian系安装过程中如果提示无法定位软件包先执行一遍sudo apt update刷新软件源缓存再重新执行安装命令就好。2.3 macOS端安装两种方案对比macOS装Git有个便利之处系统自带一个旧版本新用户可能分不清自己到底装没装。终端输入git --version如果弹出一个数字版本号系统自带的是能用的如果提示需要安装开发者工具并且弹窗引导你安装那说明你的系统里还没有Git。用Homebrew安装的话一整条链路比较顺brew install git装完同样验证版本。官方dmg安装包git-scm.com提供的macOS安装包也能用但它会覆盖系统自带环境影响面比Homebrew大一些如果你平时不搞太多自定义我还是推荐先用Homebrew方案卸载和升级都方便。3. 装完先别急着用这几项初始化必须做3.1 配置用户名和邮箱搞清楚两种配置级别Git本身不需要账号就能用它只认你在这台机器上留下的身份信息。你第一次提交代码时如果没设置用户名和邮箱Git会启动默认提示有的环境还会直接拦下你的提交操作。所以在正式开工之前必须先告诉Git你是谁。打开终端Windows用户打开Git Bash依次执行git config --global user.name 你的名字 git config --global user.email 你的邮箱注意邮箱不要求必须和你的代码托管平台注册邮箱一致但建议保持一致这样提交记录才能被正确关联到平台账号后文讲SSH配置时会再谈到。这里必须理解一个概念Git配置分三种级别优先级从高到低是仓库级local只在当前仓库生效存储在.git/config文件里全局级global对当前用户的所有仓库生效存储在用户主目录下的.gitconfig文件中系统级system对系统所有用户生效存储位置因系统而异日常使用用--global设置自己的身份就够了。我见过有人在单个项目仓库里用git config --local user.name覆盖全局设置这种做法适用于你同时维护多个账号身份比如工作账号和个人账号时的精细管理但新手不折腾。配置完之后可以查看一下自己的配置是否生效git config --global --list这个命令会列出所有全局配置项确认user.name和user.email都正确显示即可。改错配置也不麻烦用同样的命令重新执行一遍覆盖就行。3.2 设置全局忽略规则避免把垃圾文件提交入库Git有一个.gitignore文件的概念用来声明哪些文件和目录不被纳入版本管理。我当时刚接触Git时完全没意识到这东西有多重要直到某次把编译生成的缓存文件误提交进仓库拉代码的同事一堆莫名其妙的多余文件那一刻才真正理解了忽略规则的意义。全局的忽略规则通常放在用户主目录下一个叫.gitignore_global的文件里它和仓库内的.gitignore的区别在于全局规则作用于这台机器上的所有Git仓库适合放那些通用性的杂项操作系统的临时文件、编辑器的复用配置文件、各类IDE的目录等而仓库内的.gitignore则跟随这个仓库走更适合放项目特定产物。设置方法很简单先创建一个全局忽略文件然后告诉Git它的位置touch ~/.gitignore_global git config --global core.excludesfile ~/.gitignore_global打开这个文件把你想忽略的模式按行写进去。以下是一套Windows环境下比较通用的内容你可以直接抄# 系统文件 Thumbs.db Desktop.ini .DS_Store # 日志和临时文件 *.log *.tmp *.cache # 编译产物Java / C / Python target/ build/ dist/ __pycache__/ *.class *.o # 编辑器配置 .idea/ .vscode/ *.swp *~我建议每个人都建立自己的全局忽略文件哪怕你现在只有一个项目养成这个习惯能省掉未来很多精神损耗。3.3 换个顺手的分支名和编辑器Git默认的主分支名是master这个命名习惯来自多年前的版本管理世界到今天不少社区和开发团队已经切换到main。新装的Git默认还是master少数近期装在Windows上的会是init命令直接建main但传统环境里仍以master为主。如果你希望每次新建仓库时主分支叫main可以设置git config --global init.defaultBranch main这样执行git init新建仓库时默认分支就是main而不是master。这个改动不会影响已有的仓库已经建好的仓库分支名保持不变。编辑器配置也顺手设置一下。之前安装时如果选了VS Code这一项通常已经自动配好要是当时没注意在终端里补一条git config --global core.editor code --wait把code换成你熟悉的编辑器命令vim、nano、notepad等都行。配置这个的意义在于你以后做git commit不带-m参数时Git会打开这个编辑器让你填写提交信息选一个趁手的能减少很多抓狂时刻。4. 提交代码前的最后一公里SSH密钥配置4.1 生成SSH密钥的正确姿势很多教程把SSH配置放在最后讲我反而觉得这是安装之后最该优先完成的事。无论你用的是哪个代码托管平台SSH都比每次输入用户名密码方便得多一旦配好git clone、git push这些操作就不再需要反复验证身份。SSH密钥就是一对公钥和私钥。私钥留在本机公钥放到托管的仓库平台。每次Git与远程端通信时服务端会用公钥验证你这台机器是否可信整个过程密钥自动完成不需要你手动输密码。生成密钥的命令是ssh-keygen -t ed25519 -C 你的邮箱使用-t ed25519是因为Ed25519算法比传统的RSA密钥更短、生成更快、安全性也更好是目前公认的推荐选择。如果遇到特别老的系统或平台不支持Ed25519再改用ssh-keygen -t rsa -b 4096 -C 你的邮箱传统方式不过这种情况现在很少见了。运行命令后会出现三步交互提示密钥保存位置一般默认在你用户主目录下的.ssh/id_ed25519直接回车确认提示输入密码短语passphrase这是给私钥加的额外锁可选再次确认密码短语关于密码短语很多人纠结要不要设。我的建议是如果你不担心私钥文件被他人拿到并且每次推拉代码都不想再输一次密码那就留空直接回车。如果你对安全性要求很高担心自己的电脑被他人使用那就设一个。只是要记住设置密码短语后每次git操作都要输入一次不能跨终端共享所以大多人最终都会选择不设或使用代理工具管理。完成后输入ls ~/.ssh能看到两个文件id_ed25519私钥和id_ed25519.pub公钥。私钥千万不能泄露给任何人公钥可以随意给出去。这有点像银行卡号公钥和密码私钥的关系卡号可以给别人密码绝不行。还有一点值得提醒如果你的系统之前已经生成过密钥再次运行ssh-keygen会提示文件已存在询问是否覆盖。如果那是你已经配置过的密钥覆盖会导致和托管平台的绑定失效需要重新建立关联。不确定就别乱覆盖用ls ~/.ssh先看看情况。4.2 把公钥交给代码托管平台接下来把公钥内容复制到剪贴板。不同系统的命令有差异Windows Git Bash里执行clip ~/.ssh/id_ed25519.pubmacOS执行pbcopy ~/.ssh/id_ed25519.pubLinux环境直接打开文件复制cat ~/.ssh/id_ed25519.pub然后登录你的代码托管平台在个人设置的SSH公钥管理页面把复制的内容粘贴进去添加上就好。具体菜单位置因平台不同而有差异一般都在“设置”或“安全”相关的入口里。添加公钥后测试一下链路是否打通ssh -T gitgithub.com这是一个示例你实际使用哪个平台就换成对应的域名。出现Hi加用户名开头的提示说明密钥已正常工作如果提示无法识别主机或权限不足多半是公钥没贴完整或私钥文件权限设置过宽。Linux和macOS下还有一个权限问题值得注意。SSH对密钥文件的权限要求严格如果私钥文件权限太开放SSH会直接忽略它并报错。这种情况下执行chmod 600 ~/.ssh/id_ed25519 chmod 700 ~/.sshWindows下这个权限问题很少见不用额外处理。5. 常见问题与排查技巧实录5.1 下载慢、安装卡住、版本验证失败下载慢或中断。官网的下载服务器在某些网络环境下确实不快这不是你的问题。解决方案有两个一是国内镜像站很多高校和互联网企业都提供Git安装包的镜像速度和稳定性都好很多二是在下载中断后断点续传浏览器一般不具备这个能力建议下载工具直接接管。安装进度条卡住不动。多数情况是Windows安装程序在等待某些后台服务响应建议先关闭杀毒软件和安全防护的实时监控它们偶尔会误拦截Git安装程序创建文件的操作。如果装到一半卡死不要硬关先重启安装程序让它继续仍然卡着再去安全模式下重装。装完了git --version报错。可能是执行该命令前没有重新打开终端窗口PATH环境变量更新后已开着的终端不会自动刷新关掉重开就行。如果你确认是在新终端里执行还提示找不到git检查一下PATH里有没有包含C:\Program Files\Git\cmd这一项。5.2 提交中文乱码问题这个我在Git Bash里碰见过几次症状很典型文件名是中文git status显示成一串数字和转义序列提交信息里的中文变成了乱码字符。文件名显示问题通常是因为Git默认对非ASCII文件名做了转义可以执行git config --global core.quotepath false让Git直接显示中文而不是转义编码。提交信息乱码则往往和终端编码有关Git Bash里执行git config --global i18n.commitEncoding utf-8 git config --global i18n.logOutputEncoding utf-8设置之后再提交中文基本就正常了。如果你用Windows自带的CMD或PowerShell还需要把终端代码页切到UTF-8chcp 65001这个命令能临时切过去彻底解决是在区域设置里勾选Beta版使用UTF-8。5.3 全局配置设错了怎么改改用户名邮箱是重跑一遍配置命令这个说过。改编辑器同理重新执行git config --global core.editor覆盖一遍。但有些配置项你记不清楚当时的设置或者想整体查看git config --global --list列出全部全局配置后想要删除某项就执行git config --global --unset 配置项名称比如想把之前设置的默认分支名重置掉git config --global --unset init.defaultBranch如果配置改乱了想整体回到初始状态直接删除用户主目录下的.gitconfig文件Git就会像刚安装一样回到未配置的状态。但要让Git实际生效新配置和PATH配置更新一样通常需要重开终端重新加载。实践里还有个小技巧如果不确定某个配置会不会影响项目先在临时目录建个仓库试一下。比如mkdir ~/test-git-repo cd ~/test-git-repo git init git config --list --local这样试验不影响你自己的项目仓库心里有底再动手改。5.4 快速排查动作汇总把自己常用的排查思路整理成一份速查表放在这里卡住的时候直接查现象排查方向常用处理git不是内部或外部命令PATH未生效重开终端或检查PATH变量提示无法打开.gitconfig文件配置文件损坏删除或备份.gitconfig再重新配置SSH连接被拒绝公钥未正确添加或私钥权限错误检查公钥粘贴完整性chmod 600私钥文件Push时提示身份验证失败用户名邮箱未设置或平台未关联检查global配置确认平台邮箱提交时进入Vim退不出来编辑器配置未生效输入:wq退出或改core.editor中文文件名显示\345\276...quotepath默认开启执行core.quotepath false最后再分享一个我自己的经验安装Git这个事难度真不在执行命令而在于有没有意识到“装完”不等于“配好”。我见过太多人安装结束后就急着clone别人的代码仓库等到第一次commit报错、第一次push卡住才回头补配置整个过程被迫在排错中断断续续。所以我强烈建议在你正式拉取第一个仓库之前把这四件事做完用户名邮箱、全局忽略、默认分支名、SSH密钥。哪怕你现在手头没有任何项目也先把这些配好等真正要用的时候一条clone命令就能直接干活那种顺畅感会让人对工具的好感提升一个档次。另外别害怕在终端里敲命令。Git这个工具最大的门槛不是语法是你习惯了图形界面操作后对命令行的天然陌生感。你花一两天适应了Git Bash的操作节奏后面学分支、学合并、学回退都会轻松很多。 我见过太多人卡在Git这一步。不是技术有多难而是下载安装这块儿就被各种版本、各种报错劝退了。很多人写了好几年代码问起来还在用文件名_v2、文件名_final这种原始方式管理文件说实话我看着都替他们着急。Git这东西本质上就是个版本管理工具。你可以把它理解为给操作系统装上的时间机器——你写的文档、代码、哪怕是一篇几百行的配置脚本只要纳入Git管理每次改动都会被记得清清楚楚。改坏了能回退想对比不同版本能直接看差异团队协作也再不用发愁谁覆盖了谁的文件。不管你是搞开发、做数据分析、写技术文档还是纯粹想管理自己电脑上的重要文件Git都是绕不开的一个词。这篇教程不聊那些枯燥的源码编译思路只聚焦一件事怎么把Git干净利落地装到你电脑上并且完成那几项必须做的初始化配置。从选版本、走完安装向导到设置用户名邮箱和SSH密钥我把每一步的注意点都写在操作位置covers所有系统的常见坑。新手照着做就能跑通老人也能查漏补缺。1. 动手下载前先把这几件事想明白1.1 你究竟需要哪个版本的Git很多人上来就搜“Git最新版本下载”然后看到官网那一堆名词就懵了。实际上下载页面给出的版本对你来说没那么关键真正要考虑的是你的操作系统和CPU架构。先说个比较常见的认知误区Git不是版本越新越好。对于绝大多数使用者官方发布的稳定版非RC、非预览版就足够了。新版本往往带来新功能但偶尔也会引入一些兼容性问题。我自己比较习惯的做法是下载页面里标记为“Latest”的那个稳定版本如果它发布的日期在近三四个月内直接拿它如果太久没更新就往前翻一个版本避开一些潜在问题。另一个容易忽略的是系统架构。这两年新电脑基本都是ARM64架构的芯片但很多下载站点默认给的是x64的安装包装完倒是能跑但偶尔会遇到莫名的性能问题或者兼容性报错。在下载之前先确认一下你的系统版本Windows设置 → 系统 → 关于查看“系统类型”一栏标注的是x64还是ARM64macOS左上角苹果标志 → 关于本机 → 芯片类型Apple Silicon还是IntelLinux终端里执行uname -mx86_64或者aarch64拿着这个信息去官网选对应的安装包才能少走弯路。1.2 不同系统下载通道怎么选Git的获取渠道其实不止一个我按系统分类给你拆一下每种方式都说说它的优缺点。Windows系统官方渠道是git-scm.comGit的官方网站该站提供exe格式的安装程序属于最省事的方案。如果你想省去单独安装的步骤也可以在命令行包管理器里装在PowerShell中执行winget install --id Git.Git -e就能完成自动下载安装适合对命令行操作比较熟悉的用户。官网安装包的好处是选项可定制方便你手动勾选需要的组件winget的优点是快捷、能自动配置环境变量适合想省时间的场景。我自己的建议是第一次装还用官网安装包因为可以顺便看清每个安装选项的含义这套流程走一遍对Git的认识能上一个台阶。Linux系统不用去官网下载。主流发行版官方源里都有Git直接调包管理器即可。Debian和Ubuntu系执行sudo apt install gitRedHat系CentOS、Fedora执行sudo dnf install gitArch系执行sudo pacman -S git。这些命令装出来的版本可能不是最新的但胜在稳定而且与系统库的兼容性经过了充分测试适合作为主力开发环境。macOS系统macOS自带git在新版系统中输入git命令会提示安装Command Line Developer Tools。但如果你计划认真使用Git我不太建议只依赖系统自带的版本——它更新不够及时而且可配置性偏弱。推荐使用Homebrew安装执行brew install git就能得到最新版管理起来也方便。下载通道说到底没有绝对优劣关键是找一个稳定、可重复执行的渠道。你在教程里看到各种方法本质上都是让你能把Git可靠地装进系统里。2. 三个操作系统下的完整安装过程2.1 Windows端安装每个界面选项的含义Windows安装包是向导式的双击运行后一步步Next但中间有几个界面别闭着眼睛跳选错了后面会带来一些不必要的麻烦。第一个要留意的界面是“选择组件”。默认情况下Git Bash Here和Git GUI Here两个选项是勾选上的建议保持勾选。前者提供了Git自带的命令行环境里面很多指令和Linux一致后文讲的不少操作都可以在这个终端里执行强烈推荐保留。建议额外勾选Add a Git Bash Profile to Windows Terminal这个选项让Git Bash集成到Windows Terminal的标签页列表里多标签操作会舒服不少。如果看到Scalar、OpenSSL这类学术名词保留默认即可。第二个关键界面是“默认编辑器选择”。这个很重要它决定你之后每次提交代码时写提交信息的工具。默认给的是Vim但Vim的操作逻辑对不熟悉的老伙计们太不友好了——进去之后甚至不知道怎么保存退出指令是:wq写在这里怕你们急用。如果你电脑里装有VS Code这里直接选Use Visual Studio Code没装的话选Notepad或者直接选Vim都行后续也可以改配置。第三个关键界面是“调整PATH环境变量”。这里必须选第二项Git from the command line and also from 3rd-party software。选第一项意味着只能在Git Bash里用git命令在普通的PowerShell或CMD窗口打git会提示找不到命令选第二项则会自动把Git的bin目录加进系统PATH任何时候都能直接调git兼容性最好。第四个界面是“配置换行符转换”。下面三个选项分别是检出时转换、提交时转换回Windows风格↔Unix风格检出时不转换、提交时转换只把文件改为Unix风格再入库不转换文件保持原样我的选择永远是Checkout as-is, commit as-is也就是第三项。虽然这个方案在跨平台协作时偶尔会碰到换行符不一致的尴尬但对单人开发或纯Windows环境来说最省心而且这个选项切换成本低下次改也不麻烦。最后是“配置终端模拟器”和“额外功能开启”。终端模拟器选择MinTTY还是Windows自带的控制台窗口直观感受差别不大建议保留默认的MinTTY它的复制粘贴选中逻辑更适合命令行操作。额外功能里的文件系统缓存和符号链接支持前者保留后者不建议勾选——Windows上符号链接权限模型比较麻烦勾了反而容易报错。安装进度条跑完后桌面上不会自动生成什么图标别慌这是正常的。找到开始菜单里新出现的Git Bash或Git GUI也能打开终端输入git --version验证一下输出了版本号就说明装好了。2.2 Linux端安装一条命令搞定Linux下安装真就是一条命令的事但有两个容易出错的地方值得提前说。一是不要用源码编译安装。网上不少教程让你去官网下tar包自己编译操作繁琐且编译时间很长如果缺少依赖库还会直接编译失败。发行版仓库里的Git版本通常够用真的遇到必须用新版特性的需求再去考虑第三方维护的更新版本库。二是注意安装后补一个操作。装完后随便找个目录打开终端输入git --version如果系统提示找不到命令大概率是PATH环境变量里没有包含Git的安装路径。用which git查看实际安装位置再手动把路径加入PATH。Debian系安装过程中如果提示无法定位软件包先执行一遍sudo apt update刷新软件源缓存再重新执行安装命令就好。2.3 macOS端安装两种方案对比macOS装Git有个便利之处系统自带一个旧版本新用户可能分不清自己到底装没装。终端输入git --version如果弹出一个数字版本号系统自带的是能用的如果提示需要安装开发者工具并且弹窗引导你安装那说明你的系统里还没有Git。用Homebrew安装的话一整条链路比较顺brew install git装完同样验证版本。官方dmg安装包git-scm.com提供的macOS安装包也能用但它会覆盖系统自带环境影响面比Homebrew大一些如果你平时不搞太多自定义我还是推荐先用Homebrew方案卸载和升级都方便。3. 装完先别急着用这几项初始化必须做3.1 配置用户名和邮箱搞清楚两种配置级别Git本身不需要账号就能用它只认你在这台机器上留下的身份信息。你第一次提交代码时如果没设置用户名和邮箱Git会启动默认提示有的环境还会直接拦下你的提交操作。所以在正式开工之前必须先告诉Git你是谁。打开终端Windows用户打开Git Bash依次执行git config --global user.name 你的名字 git config --global user.email 你的邮箱注意邮箱不要求必须和你的代码托管平台注册邮箱一致但建议保持一致这样提交记录才能被正确关联到平台账号后文讲SSH配置时会再谈到。这里必须理解一个概念Git配置分三种级别优先级从高到低是仓库级local只在当前仓库生效存储在.git/config文件里全局级global对当前用户的所有仓库生效存储在用户主目录下的.gitconfig文件中系统级system对系统所有用户生效存储位置因系统而异日常使用用--global设置自己的身份就够了。我见过有人在单个项目仓库里用git config --local user.name覆盖全局设置这种做法适用于你同时维护多个账号身份比如工作账号和个人账号时的精细管理但新手不折腾。配置完之后可以查看一下自己的配置是否生效git config --global --list这个命令会列出所有全局配置项确认user.name和user.email都正确显示即可。改错配置也不麻烦用同样的命令重新执行一遍覆盖就行。3.2 设置全局忽略规则避免把垃圾文件提交入库Git有一个.gitignore文件的概念用来声明哪些文件和目录不被纳入版本管理。我当时刚接触Git时完全没意识到这东西有多重要直到某次把编译生成的缓存文件误提交进仓库拉代码的同事一堆莫名其妙的多余文件那一刻才真正理解了忽略规则的意义。全局的忽略规则通常放在用户主目录下一个叫.gitignore_global的文件里它和仓库内的.gitignore的区别在于全局规则作用于这台机器上的所有Git仓库适合放那些通用性的杂项操作系统的临时文件、编辑器的复用配置文件、各类IDE的目录等而仓库内的.gitignore则跟随这个仓库走更适合放项目特定产物。设置方法很简单先创建一个全局忽略文件然后告诉Git它的位置touch ~/.gitignore_global git config --global core.excludesfile ~/.gitignore_global打开这个文件把你想忽略的模式按行写进去。以下是一套Windows环境下比较通用的内容你可以直接抄# 系统文件 Thumbs.db Desktop.ini .DS_Store # 日志和临时文件 *.log *.tmp *.cache # 编译产物Java / C / Python target/ build/ dist/ __pycache__/ *.class *.o # 编辑器配置 .idea/ .vscode/ *.swp *~我建议每个人都建立自己的全局忽略文件哪怕你现在只有一个项目养成这个习惯能省掉未来很多精神损耗。3.3 换个顺手的分支名和编辑器Git默认的主分支名是master这个命名习惯来自多年前的版本管理世界到今天不少社区和开发团队已经切换到main。新装的Git默认还是master少数近期装在Windows上的会是init命令直接建main但传统环境里仍以master为主。如果你希望每次新建仓库时主分支叫main可以设置git config --global init.defaultBranch main这样执行git init新建仓库时默认分支就是main而不是master。这个改动不会影响已有的仓库已经建好的仓库分支名保持不变。编辑器配置也顺手设置一下。之前安装时如果选了VS Code这一项通常已经自动配好要是当时没注意在终端里补一条git config --global core.editor code --wait把code换成你熟悉的编辑器命令vim、nano、notepad等都行。配置这个的意义在于你以后做git commit不带-m参数时Git会打开这个编辑器让你填写提交信息选一个趁手的能减少很多抓狂时刻。4. 提交代码前的最后一公里SSH密钥配置4.1 生成SSH密钥的正确姿势很多教程把SSH配置放在最后讲我反而觉得这是安装之后最该优先完成的事。无论你用的是哪个代码托管平台SSH都比每次输入用户名密码方便得多一旦配好git clone、git push这些操作就不再需要反复验证身份。SSH密钥就是一对公钥和私钥。私钥留在本机公钥放到托管的仓库平台。每次Git与远程端通信时服务端会用公钥验证你这台机器是否可信整个过程密钥自动完成不需要你手动输密码。生成密钥的命令是ssh-keygen -t ed25519 -C 你的邮箱使用-t ed25519是因为Ed25519算法比传统的RSA密钥更短、生成更快、安全性也更好是目前公认的推荐选择。如果遇到特别老的系统或平台不支持Ed25519再改用ssh-keygen -t rsa -b 4096 -C 你的邮箱传统方式不过这种情况现在很少见了。运行命令后会出现三步交互提示密钥保存位置一般默认在你用户主目录下的.ssh/id_ed25519直接回车确认提示输入密码短语passphrase这是给私钥加的额外锁可选再次确认密码短语关于密码短语很多人纠结要不要设。我的建议是如果你不担心私钥文件被他人拿到并且每次推拉代码都不想再输一次密码那就留空直接回车。如果你对安全性要求很高担心自己的电脑被他人使用那就设一个。只是要记住设置密码短语后每次git操作都要输入一次不能跨终端共享所以大多人最终都会选择不设或使用代理工具管理。完成后输入ls ~/.ssh能看到两个文件id_ed25519私钥和id_ed25519.pub公钥。私钥千万不能泄露给任何人公钥可以随意给出去。这有点像银行卡号公钥和密码私钥的关系卡号可以给别人密码绝不行。还有一点值得提醒如果你的系统之前已经生成过密钥再次运行ssh-keygen会提示文件已存在询问是否覆盖。如果那是你已经配置过的密钥覆盖会导致和托管平台的绑定失效需要重新建立关联。不确定就别乱覆盖用ls ~/.ssh先看看情况。4.2 把公钥交给代码托管平台接下来把公钥内容复制到剪贴板。不同系统的命令有差异Windows Git Bash里执行clip ~/.ssh/id_ed25519.pubmacOS执行pbcopy ~/.ssh/id_ed25519.pubLinux环境直接打开文件复制cat ~/.ssh/id_ed25519.pub然后登录你的代码托管平台在个人设置的SSH公钥管理页面把复制的内容粘贴进去添加上就好。具体菜单位置因平台不同而有差异一般都在“设置”或“安全”相关的入口里。添加公钥后测试一下链路是否打通ssh -T gitgithub.com这是一个示例你实际使用哪个平台就换成对应的域名。出现Hi加用户名开头的提示说明密钥已正常工作如果提示无法识别主机或权限不足多半是公钥没贴完整或私钥文件权限设置过宽。Linux和macOS下还有一个权限问题值得注意。SSH对密钥文件的权限要求严格如果私钥文件权限太开放SSH会直接忽略它并报错。这种情况下执行chmod 600 ~/.ssh/id_ed25519 chmod 700 ~/.sshWindows下这个权限问题很少见不用额外处理。5. 常见问题与排查技巧实录5.1 下载慢、安装卡住、版本验证失败下载慢或中断。官网的下载服务器在某些网络环境下确实不快这不是你的问题。解决方案有两个一是国内镜像站很多高校和互联网企业都提供Git安装包的镜像速度和稳定性都好很多二是在下载中断后断点续传浏览器一般不具备这个能力建议下载工具直接接管。安装进度条卡住不动。多数情况是Windows安装程序在等待某些后台服务响应建议先关闭杀毒软件和安全防护的实时监控它们偶尔会误拦截Git安装程序创建文件的操作。如果装到一半卡死不要硬关先重启安装程序让它继续仍然卡着再去安全模式下重装。装完了git --version报错。可能是执行该命令前没有重新打开终端窗口PATH环境变量更新后已开着的终端不会自动刷新关掉重开就行。如果你确认是在新终端里执行还提示找不到git检查一下PATH里有没有包含C:\Program Files\Git\cmd这一项。5.2 提交中文乱码问题这个我在Git Bash里碰见过几次症状很典型文件名是中文git status显示成一串数字和转义序列提交信息里的中文变成了乱码字符。文件名显示问题通常是因为Git默认对非ASCII文件名做了转义可以执行git config --global core.quotepath false让Git直接显示中文而不是转义编码。提交信息乱码则往往和终端编码有关Git Bash里执行git config --global i18n.commitEncoding utf-8 git config --global i18n.logOutputEncoding utf-8设置之后再提交中文基本就正常了。如果你用Windows自带的CMD或PowerShell还需要把终端代码页切到UTF-8chcp 65001这个命令能临时切过去彻底解决是在区域设置里勾选Beta版使用UTF-8。5.3 全局配置设错了怎么改改用户名邮箱是重跑一遍配置命令这个说过。改编辑器同理重新执行git config --global core.editor覆盖一遍。但有些配置项你记不清楚当时的设置或者想整体查看git config --global --list列出全部全局配置后想要删除某项就执行git config --global --unset 配置项名称比如想把之前设置的默认分支名重置掉git config --global --unset init.defaultBranch如果配置改乱了想整体回到初始状态直接删除用户主目录下的.gitconfig文件Git就会像刚安装一样回到未配置的状态。但要让Git实际生效新配置和PATH配置更新一样通常需要重开终端重新加载。实践里还有个小技巧如果不确定某个配置会不会影响项目先在临时目录建个仓库试一下。比如mkdir ~/test-git-repo cd ~/test-git-repo git init git config --list --local这样试验不影响你自己的项目仓库心里有底再动手改。5.4 快速排查动作汇总把自己常用的排查思路整理成一份速查表放在这里卡住的时候直接查现象排查方向常用处理git不是内部或外部命令PATH未生效重开终端或检查PATH变量提示无法打开.gitconfig文件配置文件损坏删除或备份.gitconfig再重新配置SSH连接被拒绝公钥未正确添加或私钥权限错误检查公钥粘贴完整性chmod 600私钥文件Push时提示身份验证失败用户名邮箱未设置或平台未关联检查global配置确认平台邮箱提交时进入Vim退不出来编辑器配置未生效输入:wq退出或改core.editor中文文件名显示\345\276...quotepath默认开启执行core.quotepath false最后再分享一个我自己的经验安装Git这个事难度真不在执行命令而在于有没有意识到“装完”不等于“配好”。我见过太多人安装结束后就急着clone别人的代码仓库等到第一次commit报错、第一次push卡住才回头补配置整个过程被迫在排错中断断续续。所以我强烈建议在你正式拉取第一个仓库之前把这四件事做完用户名邮箱、全局忽略、默认分支名、SSH密钥。哪怕你现在手头没有任何项目也先把这些配好等真正要用的时候一条clone命令就能直接干活那种顺畅感会让人对工具的好感提升一个档次。另外别害怕在终端里敲命令。Git这个工具最大的门槛不是语法是你习惯了图形界面操作后对命令行的天然陌生感。你花一两天适应了Git Bash的操作节奏后面学分支、学合并、学回退都会轻松很多。