蔡振原1. "命令找不到"的根源：PATH机制和它为什么在三平台集体翻车
先讲一个我遇到过好几次的场景：同事从网盘拷了个Git安装包，一路"下一步"装完，兴冲冲打开终端敲git -v，结果Windows上弹出一句"git 不是内部或外部命令，也不是可运行的程序或批处理文件"，macOS上蹦出"command not found"，Linux上则是一句冷冷的"bash: git: command not found"。明明安装成功了，桌面还有Git Bash图标，怎么终端就不认账？
这个问题的名字叫PATH，全称是environment variable PATH，也就是环境变量里的Path。它干的事特别简单：操作系统在终端里收到一条命令时，比如你敲了git，不会真的全盘去搜哪个程序叫git，而是按PATH里记录的目录顺序，一个一个进去找。找不到就报"命令找不到"，找到了才调用。整个过程有点像前台接待员手里的通讯录：来访者报一个名字，接待员按通讯录上的办公室顺序挨个打电话，打通的第一个就是最终结果。
为什么装了Git还是找不到命令？因为"安装"只代表程序文件落到了硬盘上，比如Windows的C:\Program Files\Git，或者macOS的/usr/local/bin，但通讯录里没登记这个地址，接待员自然找不到人。也就是说，问题不在Git本身，在于PATH这个环境变量没有包含Git可执行文件所在的目录。
三平台的PATH机制有相似的设计，但细节差异很大。Windows用分号;分隔目录，macOS和Linux用冒号:分隔；Windows有系统环境变量和用户环境变量两层，macOS和Linux则把PATH写在各种profile文件里，由shell启动时加载。我用一张表来对照：
| 平台 | 分隔符 | 主要存放位置 | 修改后生效方式 |
|---|---|---|---|
| Windows | ; |
系统环境变量 / 用户环境变量 | 重启终端或重启资源管理器 |
| macOS | : |
/etc/paths、~/.zshrc |
新开终端或source ~/.zshrc |
| Linux | : |
~/.bashrc、/etc/profile |
新开终端或source ~/.bashrc |
这里有个很容易被忽略的点：不同平台的"新开终端"含义不太一样。Windows的终端程序启动时会读取一次环境变量，之后你改了系统设置，已经开着的终端不会自动收到通知，必须新开窗口。macOS和Linux的shell启动时读取profile文件，但不同shell的加载文件名不同，而且存在交互式登录shell和交互式非登录shell之分，后面我会细说。总之，命令找不到，十有八九不是Git坏了，而是PATH没配上、配错位置，或者配了但没生效。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 安装环节就决定生死：三平台安装Git时的关键取舍
很多人觉得安装Git是个傻瓜操作，但实际上下载完安装包之后，那几步选择直接决定了你之后会不会碰到"命令找不到"。我在Windows上装Git很多次，也帮人排过很多次，发现90%的问题都出在安装时没看选项，默认了一路下一步，结果PATH没勾对。
2.1 Windows官方安装包里那几个勾选项
Windows的Git安装包是Inno Setup做的，走到"Select Components"和"Adjusting your PATH environment"这两步就要注意了。尤其"Adjusting your PATH"里三个单选选项：
- "Use Git from Git Bash only"：只在Git Bash里能用git，打开cmd或PowerShell输入git一定找不到。这适合完全不想动系统环境变量的人。
- "Git from the command line and also from 3rd-party software"：推荐选这个。它会把
C:\Program Files\Git\cmd加入系统PATH，让cmd、PowerShell、以及之后安装的第三方工具都能识别git。 - "Use Git and optional Unix tools from the Command Prompt"：不推荐。它会把Git里的Unix工具一并混入系统PATH，很可能覆盖系统自带的find、sort等命令，引入一堆奇奇怪怪的兼容问题。
我见过不少同事选第一项，转头又去PowerShell里敲git，当然找不到。另外注意一点，Windows安装包里有个选项叫"Which credentials helper should be used?"，默认用Git Credential Manager，这个跟PATH无关，但建议保持默认，后面推代码免密登录会省很多事。
2.2 macOS：别忽略Command Line Tools
macOS的情况比较特殊。在较新的系统上，你直接在终端敲git，系统可能弹出一个提示框，说需要安装Command Line Tools（CLT）。这个CLT是苹果提供的开发工具集，里面带着git、make、clang等一堆命令行工具。你可以选择用xcode-select --install安装CLT，这样git会出现在/usr/bin/git，系统默认PATH里已经包含了/usr/bin，所以装完直接能用，不需要任何额外配置。
另一种方式是装Homebrew后用brew install git，装出来的git在Apple Silicon机器上位于/opt/homebrew/bin，在Intel机器上位于/usr/local/bin。这里有个坑：/opt/homebrew/bin在个别系统版本的默认PATH里并不存在，Homebrew安装时会提示你"Run these two commands in your termina