Git 安装教程这个题目看起来像是给新手准备的基础内容但我在实际帮人排查环境时发现很多写了两年代码的人装 Git 这一步也未必真弄明白了。装完能敲出git --version跟装到顺手、装到不耽误后续开发其实是两码事。我见过不少同学一路点“下一步”装完推到代码托管平台时才发现提交身份不对、换行符一片红、SSH 连不上最后又把账单怪到“Git 太难装”。这篇教程我就想按 Windows、macOS、Linux 三条主线把 Git 安装这件事完整聊一遍再补上装完之后的配置思路和高频翻车现场。适合第一次搭环境的初学者也适合准备重装系统、想一次性把环境整干净的老手。1. 安装 Git 之前先把三个关键概念理顺1.1 Git 到底是什么为什么装它这么重要Git 是分布式版本控制系统。说人话就是它能在你的本地目录里记录每一次文件变更允许你随时回退、开分支、合并再把内容同步到远程。安装 Git等于给电脑装上了这套能力。写代码的人要用它管理代码做文档的人如果经常处理带版本号的方案稿、配置目录同样可以用它做文件快照。它的重要性不在于命令多不多而在于它是几乎所有开发工作流的地基。你接着要用的包管理器、编辑器、代码托管平台、CI 工具底层都要调用git命令。新电脑拿到手第一件事往往不是装编辑器而是装 Git。哪一步没弄对后面处处不顺。1.2 官方安装包、系统源、包管理器到底选哪种同样一个 Git拿到手的方式有好几种。我把常见渠道放在一起对比一下你一眼就能看清楚差异安装方式适用系统优点缺点官方安装包Windows、macOS版本新、可控、可定制组件需要自己处理安装选项系统自带软件源Linux与系统兼容最好升级方便版本可能比官方慢一些第三方包管理器Windows、macOS命令一行搞定便于脚本化需要先维护好包管理器本身我的建议很直接Windows 用户用官方安装包macOS 用户优先用系统自带的开发者工具Linux 用户用发行版软件源。新手不要一上来就折腾源码编译那是给自己加戏。1.3 版本号是不是越新越好不是。Git 的版本更新很快但大部分更新属于细节增强对普通开发者的日常工作影响有限。正式项目环境通常会认稳定版而不是每一版都追。系统软件源里的 Git 往往比官方发布晚几个小版本这不代表装错了。只有当你在某篇文档里明确看到“某个 bug 已在指定版本修复”并且确认自己踩到了那个 bug才值得考虑升级。否则官方最新版和系统源里的稳定版差别并不明显。2. Windows 系统安装全程关键选项逐个拆2.1 安装前先确认系统类型Windows 上安装 Git 之前先确认两点系统位数和管理员权限。打开开始菜单输入“终端”或“命令提示符”执行下面这条命令echo %PROCESSOR_ARCHITECTURE%输出AMD64说明系统是 64 位下载 64 位安装包输出x86就下载 32 位版本。现在绝大多数环境都是 64 位这一步通常不会出问题。另外安装程序会往系统目录写文件当前账户要有管理员权限。如果你用的是公司统一发放的电脑账户权限受限可以先联系本机管理员别硬装。2.2 下载与启动安装去 Git 官方站点页面会自动识别当前系统点击下载 64 位 Windows 安装包。文件是一个.exe下载完成后双击运行系统会弹出 UAC 用户账户控制提示点“是”进入安装向导。不要从第三方下载站找“绿色版”或“精简版”Git。那些版本要么捆绑软件要么被杀软误报官方安装包才是最省心的来源。安装路径我建议保持默认不要为了图省事放到带中文或空格的路径里否则会给后续终端调用带来不必要的兼容问题。2.3 安装向导里的选项怎么选才是对的Windows 安装向导有好多屏很多人直接一路“下一步”就过去了。这里把关键项逐个说清楚。Select Components 组件选择默认勾选 Git Bash、Git GUI、Git LFS、关联配置文件。这些建议全部保留。Git Bash 是 Windows 下非常好用的命令行环境以后日常操作都用得上Git LFS 用于管理大文件现在不装以后传二进制资源时会后悔。去掉这些组件对安装包体积影响很小收益却损失明显。Default editor 默认编辑器默认是 Vim。如果你平时有常用的代码编辑器在列表里选它不用专门为了 Git 去学 Vim。没有的话保留 Vim 也问题不大因为执行git commit时完全可以用git commit -m 提交信息直接传信息很少需要真正进入编辑器界面。Adjusting your PATH 调整 PATH这一屏是整个安装过程里最重要的一屏。建议选第二项也就是“Git from the command line and also from 3rd-party software”。它会把git命令加进系统 PATH让系统终端、第三方工具都能直接调用。选第一项的话只有 Git Bash 里能用git一换到系统终端就提示找不到命令选第三项会额外覆盖部分系统工具行为容易引发一些奇怪问题。绝大多数人应该选第二项。Line ending conversions 行尾转换默认是 “Checkout Windows-style, commit Unix-style line endings”。意思是检出时保留 Windows 的 CRLF 换行提交时转成 Unix 的 LF 换行。这是跨平台协作最常用的策略保持默认就好。如果你确定项目只在 Windows 上使用再考虑改成“保持原样”否则不要碰。Use a TrueType font / Enable file system monitor这些属于辅助选项。TrueType 字体对中文显示更友好文件系统监视器可以让部分 Git 操作更快按默认勾选即可。走完提示后安装结束。如果最后一步出现“启动 Git Bash”的选项建议直接启动顺便进入下一步验证。2.4 怎么确认 Windows 上真的装好了在 Git Bash 或系统终端里执行git --version如果输出类似git version 2.x.x.windows.x的版本号说明安装成功。再用下面这条命令确认命令实际所在路径where.exe git如果git --version正常但where.exe git提示找不到说明当前终端没有刷新环境变量关掉窗口重新打开一次基本就能解决。大多数“装完还是找不到命令”的问题本质上都是这一步没做。3. macOS 系统安装轻量和完整两条路径3.1 最省事的路径让系统自动拉起工具链macOS 上安装 Git 最简单的方式不是去官网下载而是直接在终端里输入git --version如果系统里没有 GitmacOS 会弹出一个窗口提示安装“命令行开发者工具”。点击安装等它下载完成再执行一次git --versionGit 就出现了。这个方式装好的 Git 不光是 Git 本身还会附带一套编译器和基础开发工具。对于日常写代码、跑脚本、编译小项目的人来说完全够用。它的升级也跟随系统更新不需要手动操心依赖问题。缺点是过程有点“黑盒”开始时会下载比较大的内容需要耐心等一会儿。3.2 想自己控制版本官方独立安装包如果你希望明确知道自己装的是哪个版本不依赖系统工具链可以从 Git 官方站点下载 macOS 安装包。下载下来是一个.dmg磁盘映像文件双击挂载再运行里面的.pkg安装器。如果系统提示“来自身份不明的开发者”不要慌右键点击安装包选择“打开”再确认一次就能继续安装。安装完成后照例用git --version验证。这两条路径的选择逻辑很简单日常普通使用系统工具链足够希望自己控制 Git 的版本和更新节奏就选独立安装包。我不建议新手同时保留两条链路容易造成/usr/bin/git和/usr/local/bin/git混用最后自己都搞不清到底用的是哪个。3.3 使用包管理器的进阶思路如果你已经在使用第三方包管理器比如brew那装 Git 就是一条命令的事brew install git这种方式的好处是升级方便以后执行一条升级命令就能拿到新版本。缺点是它依赖包管理器本身的健康程度有时会连带升级一堆系统库影响其他工具。第一次搭环境的人我不建议为了装 Git 先去折腾包管理器那是给后面埋“历史包袱”。等你对这台机器的软件管理有了清晰认识再切换到包管理器也不迟。4. Linux 系统安装用对软件源少碰源码编译4.1 两行命令完成安装Linux 发行版大多自带 Git 软件包。在基于apt的发行版上执行sudo apt update sudo apt install -y git在基于dnf或yum的发行版上执行sudo dnf install -y gitupdate的作用是刷新软件源索引避免装到过期版本。-y参数表示安装过程中自动确认适合直接复制执行。如果你的系统提示找不到git包先把软件源重新配置一遍再执行安装命令。4.2 为什么我不建议源码编译网上有些教程会让你去 Git 官方站点下载源码然后自己编译安装。源码编译确实能拿到最新版本但你需要自己处理一堆系统依赖包括编译工具链、文档工具、各种开发库。任何一个依赖没装好编译都会报错排查成本远高于系统包管理器。我见过不少人为了“最新版”去编译 Git最后卡在make: command not found或者某个正则库缺失上折腾两三个小时回过头来发现系统源里的版本原本就够用。普通开发者老老实实用发行版维护的包是最稳妥的选择。4.3 安装后随手验证安装完成后执行git --version which git输出路径在/usr/bin/git或者/usr/local/bin/git都正常关键是版本号能正常显示。如果提示找不到命令回到上一步检查软件源是否更新成功、安装过程是否有报错。Linux 下最常见的问题是用户忘了输sudo导致安装权限不足命令结束后什么都没发生。5. 安装完成后先别急着用三处配置早晚要补5.1 提交身份用户和邮箱Git 每一条提交记录都会记录作者信息。这个信息不是系统登录账号而是你自己设置的user.name和user.email。不设置的话第一次提交时 Git 会提示或者在你的提交记录里留下完全没意义的默认值。执行以下命令git config --global user.name 你的名字 git config --global user.email 你的邮箱这里要提醒一下user.email建议使用和代码托管平台一致的邮箱。这个邮箱不会拿来做身份验证但它会影响提交记录里的头像和贡献关联。用不一致的邮箱以后统计贡献图时会对不上号处理起来非常麻烦。5.2 默认分支名和换行符策略过去 Git 新建仓库的默认分支名是master现在很多代码托管平台默认分支是main。为了本地和远端保持一致安装完成后最好执行一次git config --global init.defaultBranch main换行符也是必配项。Windows 的文件换行是 CRLFmacOS 和 Linux 是 LF。如果仓库里混了两种换行符git diff会把一整行都标记成变化代码侧看过去红红一片。Windows 上推荐开启自动转换git config --global core.autocrlf truemacOS 和 Linux 上则执行git config --global core.autocrlf input这样提交进仓库的文本统一是 LFWindows 工作区检出时保留 CRLF既能正常打开文件又不会污染 diff。5.3 SSH 密钥远程协作前的确认动作虽然 HTTPS 也能连接远程仓库但 SSH 方式更常见而且不用每次输密码。生成密钥的命令是ssh-keygen -t ed25519 -C 你的邮箱一路回车到结束然后查看公钥内容cat ~/.ssh/id_ed25519.pub把输出的整段内容复制到代码托管平台的 SSH 公钥设置里就算完成。这里选择ed25519算法是因为它比传统 RSA 更短更高效只要平台支持优先用它。老项目如果必须用 RSA也可以执行ssh-keygen -t rsa -b 4096 -C 你的邮箱道理相同。5.4 确认配置真的生效git config --global --list屏幕会列出刚才设置的user.name、user.email、init.defaultBranch、core.autocrlf等。想进一步查看每条配置来自哪个文件可以加--show-origingit config --global --list --show-origin这一步看着多余但真遇到“配置设置了却不生效”时它能帮你快速定位是全局配置覆盖了系统配置还是某个仓库内的本地配置覆盖了全局配置排查效率高很多。6. 安装过程里高频翻车的五个现场6.1 终端提示“git 不是内部或外部命令”这个问题八成出在 PATH 上。Windows 用户先关闭所有已经打开的终端窗口重新打开再试一次。如果还不行回到安装程序重新走一遍向导在 PATH 选择那一屏明确选择第二项。macOS 用户如果系统工具链没装完整终端会提示command not found可以重新调用开发者工具安装流程等下载完成后再次执行git --version。Linux 用户优先检查软件源是否更新成功以及安装命令有没有真正执行完。我见过有人把apt install git和apt install git-core混着敲旧发行版上两条命令装出来的东西还不一样容易懵。6.2 Windows 安装到一半提示“另一个程序正在使用”Windows 的安装服务有排他限制。如果后台还有系统更新或者其他安装程序在运行Git 安装器可能卡住或者弹出“另一个安装程序正在使用中”的提示。最有效的处理方式是重启电脑别在安装器开着的时候去强制关进程。重启之后重新执行安装包基本都能顺利通过。强行改注册表或者删临时文件的做法风险太大不建议尝试。6.3 发现装的版本不是最新版用系统软件源装的 Git 往往比官方最新发布慢一些这不是装错了。比如某些 Linux 发行版的软件源里Git 版本会落后几个小版本。除非你明确知道某个新版本修复了你撞上的问题否则没必要急着换。Windows 用户想升级就直接重新下载官方安装包覆盖安装即可配置和仓库信息都会保留。Linux 用户用系统包管理器升级下一步就行不用卸载再装。6.4 初次 diff 看到整文件都是红色这大概率是换行符问题。你在配置core.autocrlf之前提交过的文件不会因为改了配置就自动重写历史。仓库里已经混入的 CRLF 和 LF需要专门处理。新手不建议对现有仓库执行批量重写行尾的操作。更合适的做法是把配置修正过来然后从新的提交开始保持统一。已经混乱的历史可以暂时不管不影响后续协作如果实在要清理等项目不紧张的时候再单独处理。6.5 下载安装包速度不稳定官方站点不是每次都流畅尤其赶上大版本刚发布的前一两天。这时最合适的办法是换一个网络状况更好的时段再试而不是去第三方下载站找替代包。官方安装包下载完成后可以顺手核对一下 SHA-256 校验值避免文件下载损坏。Windows 下在终端里执行certutil -hashfile .\Git-*.exe SHA256把输出的哈希值和官方页面上的值对比一致再安装。macOS 下也可以右键安装包在系统自带的校验工具里查看摘要操作同样是几分钟的事。7. 从安装到第一次提交一条链路完整验收7.1 初始化一个本地仓库找一个空目录在终端里进入这个目录执行git init这时目录里会出现一个隐藏的.git文件夹它负责记录这个仓库的全部历史信息。执行git status查看当前状态会看到“还没有任何提交”和一个空的工作区。这一步能跑通说明 Git 的核心功能已经正常。7.2 添加一个文件并提交在目录里随便建一个文本文件然后执行git add . git commit -m first commit如果之前没配置user.name和user.email这条提交会被拒绝或者提示补全。看到提交成功之后再执行git log --oneline屏幕上会出现一条提交记录。到这里安装、配置、基本工作流就已经全部打通了。随后你可以继续试着改一下文件再执行git diff查看变更确认基础命令都能正常工作。7.3 检查命令环境是否干净最后顺手用git config --list --show-origin扫一遍配置来源用git --version再确认一次版本。等你哪天换电脑这套流程可以原封不动再来一遍。我个人实际踩过几次坑后最大的体会是安装 Git 本身只要十分钟真正花时间的是配置和排错。把user.name、user.email、默认分支、换行符和 SSH 公钥提前弄好后面远程协作会省掉很多不必要的烦恼。给新人做环境时我也一定会先花三分钟把这几项配置确认到位再进入正式项目开发。这一步做得越早后面的坑就越少。
Git 安装教程这个题目看起来像是给新手准备的基础内容但我在实际帮人排查环境时发现很多写了两年代码的人装 Git 这一步也未必真弄明白了。装完能敲出git --version跟装到顺手、装到不耽误后续开发其实是两码事。我见过不少同学一路点“下一步”装完推到代码托管平台时才发现提交身份不对、换行符一片红、SSH 连不上最后又把账单怪到“Git 太难装”。这篇教程我就想按 Windows、macOS、Linux 三条主线把 Git 安装这件事完整聊一遍再补上装完之后的配置思路和高频翻车现场。适合第一次搭环境的初学者也适合准备重装系统、想一次性把环境整干净的老手。1. 安装 Git 之前先把三个关键概念理顺1.1 Git 到底是什么为什么装它这么重要Git 是分布式版本控制系统。说人话就是它能在你的本地目录里记录每一次文件变更允许你随时回退、开分支、合并再把内容同步到远程。安装 Git等于给电脑装上了这套能力。写代码的人要用它管理代码做文档的人如果经常处理带版本号的方案稿、配置目录同样可以用它做文件快照。它的重要性不在于命令多不多而在于它是几乎所有开发工作流的地基。你接着要用的包管理器、编辑器、代码托管平台、CI 工具底层都要调用git命令。新电脑拿到手第一件事往往不是装编辑器而是装 Git。哪一步没弄对后面处处不顺。1.2 官方安装包、系统源、包管理器到底选哪种同样一个 Git拿到手的方式有好几种。我把常见渠道放在一起对比一下你一眼就能看清楚差异安装方式适用系统优点缺点官方安装包Windows、macOS版本新、可控、可定制组件需要自己处理安装选项系统自带软件源Linux与系统兼容最好升级方便版本可能比官方慢一些第三方包管理器Windows、macOS命令一行搞定便于脚本化需要先维护好包管理器本身我的建议很直接Windows 用户用官方安装包macOS 用户优先用系统自带的开发者工具Linux 用户用发行版软件源。新手不要一上来就折腾源码编译那是给自己加戏。1.3 版本号是不是越新越好不是。Git 的版本更新很快但大部分更新属于细节增强对普通开发者的日常工作影响有限。正式项目环境通常会认稳定版而不是每一版都追。系统软件源里的 Git 往往比官方发布晚几个小版本这不代表装错了。只有当你在某篇文档里明确看到“某个 bug 已在指定版本修复”并且确认自己踩到了那个 bug才值得考虑升级。否则官方最新版和系统源里的稳定版差别并不明显。2. Windows 系统安装全程关键选项逐个拆2.1 安装前先确认系统类型Windows 上安装 Git 之前先确认两点系统位数和管理员权限。打开开始菜单输入“终端”或“命令提示符”执行下面这条命令echo %PROCESSOR_ARCHITECTURE%输出AMD64说明系统是 64 位下载 64 位安装包输出x86就下载 32 位版本。现在绝大多数环境都是 64 位这一步通常不会出问题。另外安装程序会往系统目录写文件当前账户要有管理员权限。如果你用的是公司统一发放的电脑账户权限受限可以先联系本机管理员别硬装。2.2 下载与启动安装去 Git 官方站点页面会自动识别当前系统点击下载 64 位 Windows 安装包。文件是一个.exe下载完成后双击运行系统会弹出 UAC 用户账户控制提示点“是”进入安装向导。不要从第三方下载站找“绿色版”或“精简版”Git。那些版本要么捆绑软件要么被杀软误报官方安装包才是最省心的来源。安装路径我建议保持默认不要为了图省事放到带中文或空格的路径里否则会给后续终端调用带来不必要的兼容问题。2.3 安装向导里的选项怎么选才是对的Windows 安装向导有好多屏很多人直接一路“下一步”就过去了。这里把关键项逐个说清楚。Select Components 组件选择默认勾选 Git Bash、Git GUI、Git LFS、关联配置文件。这些建议全部保留。Git Bash 是 Windows 下非常好用的命令行环境以后日常操作都用得上Git LFS 用于管理大文件现在不装以后传二进制资源时会后悔。去掉这些组件对安装包体积影响很小收益却损失明显。Default editor 默认编辑器默认是 Vim。如果你平时有常用的代码编辑器在列表里选它不用专门为了 Git 去学 Vim。没有的话保留 Vim 也问题不大因为执行git commit时完全可以用git commit -m 提交信息直接传信息很少需要真正进入编辑器界面。Adjusting your PATH 调整 PATH这一屏是整个安装过程里最重要的一屏。建议选第二项也就是“Git from the command line and also from 3rd-party software”。它会把git命令加进系统 PATH让系统终端、第三方工具都能直接调用。选第一项的话只有 Git Bash 里能用git一换到系统终端就提示找不到命令选第三项会额外覆盖部分系统工具行为容易引发一些奇怪问题。绝大多数人应该选第二项。Line ending conversions 行尾转换默认是 “Checkout Windows-style, commit Unix-style line endings”。意思是检出时保留 Windows 的 CRLF 换行提交时转成 Unix 的 LF 换行。这是跨平台协作最常用的策略保持默认就好。如果你确定项目只在 Windows 上使用再考虑改成“保持原样”否则不要碰。Use a TrueType font / Enable file system monitor这些属于辅助选项。TrueType 字体对中文显示更友好文件系统监视器可以让部分 Git 操作更快按默认勾选即可。走完提示后安装结束。如果最后一步出现“启动 Git Bash”的选项建议直接启动顺便进入下一步验证。2.4 怎么确认 Windows 上真的装好了在 Git Bash 或系统终端里执行git --version如果输出类似git version 2.x.x.windows.x的版本号说明安装成功。再用下面这条命令确认命令实际所在路径where.exe git如果git --version正常但where.exe git提示找不到说明当前终端没有刷新环境变量关掉窗口重新打开一次基本就能解决。大多数“装完还是找不到命令”的问题本质上都是这一步没做。3. macOS 系统安装轻量和完整两条路径3.1 最省事的路径让系统自动拉起工具链macOS 上安装 Git 最简单的方式不是去官网下载而是直接在终端里输入git --version如果系统里没有 GitmacOS 会弹出一个窗口提示安装“命令行开发者工具”。点击安装等它下载完成再执行一次git --versionGit 就出现了。这个方式装好的 Git 不光是 Git 本身还会附带一套编译器和基础开发工具。对于日常写代码、跑脚本、编译小项目的人来说完全够用。它的升级也跟随系统更新不需要手动操心依赖问题。缺点是过程有点“黑盒”开始时会下载比较大的内容需要耐心等一会儿。3.2 想自己控制版本官方独立安装包如果你希望明确知道自己装的是哪个版本不依赖系统工具链可以从 Git 官方站点下载 macOS 安装包。下载下来是一个.dmg磁盘映像文件双击挂载再运行里面的.pkg安装器。如果系统提示“来自身份不明的开发者”不要慌右键点击安装包选择“打开”再确认一次就能继续安装。安装完成后照例用git --version验证。这两条路径的选择逻辑很简单日常普通使用系统工具链足够希望自己控制 Git 的版本和更新节奏就选独立安装包。我不建议新手同时保留两条链路容易造成/usr/bin/git和/usr/local/bin/git混用最后自己都搞不清到底用的是哪个。3.3 使用包管理器的进阶思路如果你已经在使用第三方包管理器比如brew那装 Git 就是一条命令的事brew install git这种方式的好处是升级方便以后执行一条升级命令就能拿到新版本。缺点是它依赖包管理器本身的健康程度有时会连带升级一堆系统库影响其他工具。第一次搭环境的人我不建议为了装 Git 先去折腾包管理器那是给后面埋“历史包袱”。等你对这台机器的软件管理有了清晰认识再切换到包管理器也不迟。4. Linux 系统安装用对软件源少碰源码编译4.1 两行命令完成安装Linux 发行版大多自带 Git 软件包。在基于apt的发行版上执行sudo apt update sudo apt install -y git在基于dnf或yum的发行版上执行sudo dnf install -y gitupdate的作用是刷新软件源索引避免装到过期版本。-y参数表示安装过程中自动确认适合直接复制执行。如果你的系统提示找不到git包先把软件源重新配置一遍再执行安装命令。4.2 为什么我不建议源码编译网上有些教程会让你去 Git 官方站点下载源码然后自己编译安装。源码编译确实能拿到最新版本但你需要自己处理一堆系统依赖包括编译工具链、文档工具、各种开发库。任何一个依赖没装好编译都会报错排查成本远高于系统包管理器。我见过不少人为了“最新版”去编译 Git最后卡在make: command not found或者某个正则库缺失上折腾两三个小时回过头来发现系统源里的版本原本就够用。普通开发者老老实实用发行版维护的包是最稳妥的选择。4.3 安装后随手验证安装完成后执行git --version which git输出路径在/usr/bin/git或者/usr/local/bin/git都正常关键是版本号能正常显示。如果提示找不到命令回到上一步检查软件源是否更新成功、安装过程是否有报错。Linux 下最常见的问题是用户忘了输sudo导致安装权限不足命令结束后什么都没发生。5. 安装完成后先别急着用三处配置早晚要补5.1 提交身份用户和邮箱Git 每一条提交记录都会记录作者信息。这个信息不是系统登录账号而是你自己设置的user.name和user.email。不设置的话第一次提交时 Git 会提示或者在你的提交记录里留下完全没意义的默认值。执行以下命令git config --global user.name 你的名字 git config --global user.email 你的邮箱这里要提醒一下user.email建议使用和代码托管平台一致的邮箱。这个邮箱不会拿来做身份验证但它会影响提交记录里的头像和贡献关联。用不一致的邮箱以后统计贡献图时会对不上号处理起来非常麻烦。5.2 默认分支名和换行符策略过去 Git 新建仓库的默认分支名是master现在很多代码托管平台默认分支是main。为了本地和远端保持一致安装完成后最好执行一次git config --global init.defaultBranch main换行符也是必配项。Windows 的文件换行是 CRLFmacOS 和 Linux 是 LF。如果仓库里混了两种换行符git diff会把一整行都标记成变化代码侧看过去红红一片。Windows 上推荐开启自动转换git config --global core.autocrlf truemacOS 和 Linux 上则执行git config --global core.autocrlf input这样提交进仓库的文本统一是 LFWindows 工作区检出时保留 CRLF既能正常打开文件又不会污染 diff。5.3 SSH 密钥远程协作前的确认动作虽然 HTTPS 也能连接远程仓库但 SSH 方式更常见而且不用每次输密码。生成密钥的命令是ssh-keygen -t ed25519 -C 你的邮箱一路回车到结束然后查看公钥内容cat ~/.ssh/id_ed25519.pub把输出的整段内容复制到代码托管平台的 SSH 公钥设置里就算完成。这里选择ed25519算法是因为它比传统 RSA 更短更高效只要平台支持优先用它。老项目如果必须用 RSA也可以执行ssh-keygen -t rsa -b 4096 -C 你的邮箱道理相同。5.4 确认配置真的生效git config --global --list屏幕会列出刚才设置的user.name、user.email、init.defaultBranch、core.autocrlf等。想进一步查看每条配置来自哪个文件可以加--show-origingit config --global --list --show-origin这一步看着多余但真遇到“配置设置了却不生效”时它能帮你快速定位是全局配置覆盖了系统配置还是某个仓库内的本地配置覆盖了全局配置排查效率高很多。6. 安装过程里高频翻车的五个现场6.1 终端提示“git 不是内部或外部命令”这个问题八成出在 PATH 上。Windows 用户先关闭所有已经打开的终端窗口重新打开再试一次。如果还不行回到安装程序重新走一遍向导在 PATH 选择那一屏明确选择第二项。macOS 用户如果系统工具链没装完整终端会提示command not found可以重新调用开发者工具安装流程等下载完成后再次执行git --version。Linux 用户优先检查软件源是否更新成功以及安装命令有没有真正执行完。我见过有人把apt install git和apt install git-core混着敲旧发行版上两条命令装出来的东西还不一样容易懵。6.2 Windows 安装到一半提示“另一个程序正在使用”Windows 的安装服务有排他限制。如果后台还有系统更新或者其他安装程序在运行Git 安装器可能卡住或者弹出“另一个安装程序正在使用中”的提示。最有效的处理方式是重启电脑别在安装器开着的时候去强制关进程。重启之后重新执行安装包基本都能顺利通过。强行改注册表或者删临时文件的做法风险太大不建议尝试。6.3 发现装的版本不是最新版用系统软件源装的 Git 往往比官方最新发布慢一些这不是装错了。比如某些 Linux 发行版的软件源里Git 版本会落后几个小版本。除非你明确知道某个新版本修复了你撞上的问题否则没必要急着换。Windows 用户想升级就直接重新下载官方安装包覆盖安装即可配置和仓库信息都会保留。Linux 用户用系统包管理器升级下一步就行不用卸载再装。6.4 初次 diff 看到整文件都是红色这大概率是换行符问题。你在配置core.autocrlf之前提交过的文件不会因为改了配置就自动重写历史。仓库里已经混入的 CRLF 和 LF需要专门处理。新手不建议对现有仓库执行批量重写行尾的操作。更合适的做法是把配置修正过来然后从新的提交开始保持统一。已经混乱的历史可以暂时不管不影响后续协作如果实在要清理等项目不紧张的时候再单独处理。6.5 下载安装包速度不稳定官方站点不是每次都流畅尤其赶上大版本刚发布的前一两天。这时最合适的办法是换一个网络状况更好的时段再试而不是去第三方下载站找替代包。官方安装包下载完成后可以顺手核对一下 SHA-256 校验值避免文件下载损坏。Windows 下在终端里执行certutil -hashfile .\Git-*.exe SHA256把输出的哈希值和官方页面上的值对比一致再安装。macOS 下也可以右键安装包在系统自带的校验工具里查看摘要操作同样是几分钟的事。7. 从安装到第一次提交一条链路完整验收7.1 初始化一个本地仓库找一个空目录在终端里进入这个目录执行git init这时目录里会出现一个隐藏的.git文件夹它负责记录这个仓库的全部历史信息。执行git status查看当前状态会看到“还没有任何提交”和一个空的工作区。这一步能跑通说明 Git 的核心功能已经正常。7.2 添加一个文件并提交在目录里随便建一个文本文件然后执行git add . git commit -m first commit如果之前没配置user.name和user.email这条提交会被拒绝或者提示补全。看到提交成功之后再执行git log --oneline屏幕上会出现一条提交记录。到这里安装、配置、基本工作流就已经全部打通了。随后你可以继续试着改一下文件再执行git diff查看变更确认基础命令都能正常工作。7.3 检查命令环境是否干净最后顺手用git config --list --show-origin扫一遍配置来源用git --version再确认一次版本。等你哪天换电脑这套流程可以原封不动再来一遍。我个人实际踩过几次坑后最大的体会是安装 Git 本身只要十分钟真正花时间的是配置和排错。把user.name、user.email、默认分支、换行符和 SSH 公钥提前弄好后面远程协作会省掉很多不必要的烦恼。给新人做环境时我也一定会先花三分钟把这几项配置确认到位再进入正式项目开发。这一步做得越早后面的坑就越少。
平方复杂度无法被常规优化消除｜TaoToken 统一 Key 通道实测)
