Python命令找不到是因安装路径未加入PATH环境变量，需手动将Python主目录及Scripts目录添加至PATH，并重启终端验证。
Python 环境变量没配对，python 命令就找不到解释器，pip 也装不了包——这不是 Python 本身的问题，而是系统压根不知道你把 Python 装哪儿了。
为什么 python 或 pip 在终端里报“命令未找到”
Windows、macOS、Linux 都靠 PATH 环境变量决定哪些目录下的可执行文件能被直接调用。如果你装了 Python，但安装路径（比如 C:\Users\Name\AppData\Local\Programs\Python\Python312\ 或 /usr/local/bin）没加进 PATH，终端就搜不到 python.exe 或 python3。
- 常见错误现象：
'python' is not recognized as an internal or external command（Windows），或command not found: python3（macOS/Linux） - 不是重装 Python 就能解决——很多安装器默认不勾选“Add Python to PATH”，尤其 Windows 上容易漏掉
- macOS 使用 Homebrew 安装的 Python3，二进制通常在
/opt/homebrew/bin/python3（Apple Silicon）或/usr/local/bin/python3（Intel），这个路径必须出现在PATH开头或靠前位置，否则可能被系统自带的 Python2.7 覆盖
Windows 上怎么正确添加 Python 到 PATH
别依赖安装时的勾选项——它有时失效，或者你后来换了 Python 版本。手动加最稳。
- 先确认 Python 安装路径：打开文件资源管理器，进入 Python 安装目录（例如
C:\Users\Name\AppData\Local\Programs\Python\Python312\），里面必须有python.exe和Scripts\pip.exe - 右键“此电脑” → “属性” → “高级系统设置” → “环境变量” → 在“系统变量”里双击
Path→ “新建” → 粘贴完整 Python 安装路径（如C:\Users\Name\AppData\Local\Programs\Python\Python312\）→ 再新建一行，粘贴 Scripts 路径（如C:\Users\Name\AppData\Local\Programs\Python\Python312\Scripts\） - 改完后必须关掉所有已打开的命令行窗口，重新开一个 cmd 或 PowerShell 再测试：
python --version和pip --version - 如果仍不行，检查是否误加了尾部反斜杠（
\）——Windows 对路径末尾斜杠敏感，C:\Python312\是错的，应为C:\Python312
macOS/Linux 怎么让 python3 变成 python
系统默认 python 指向 Python2（尤其 macOS），而你装的是 Python3。硬改系统链接风险大，推荐用 shell 别名或 PATH 优先级控制。
立即学习“Python免费学习笔记（深入）”；
- 先查清楚你真正想用的 Python3 路径：
which python3（常见输出：/opt/homebrew/bin/python3或/usr/local/bin/python3） - 编辑 shell 配置文件：
~/.zshrc（macOS Catalina 及以后默认）或~/.bash_profile（旧版或 Linux），追加一行：export PATH="/opt/homebrew/bin:$PATH"（Homebrew 用户）或export PATH="/usr/local/bin:$PATH" - 别写
alias python=python3——很多工具（如pip、venv）会读取#!/usr/bin/env python这类 shebang，别名不生效；只有修改PATH才能让所有子进程都识别 - 改完运行
source ~/.zshrc，再验证：which python应该输出你期望的路径，且python --version显示 3.x
验证和排错的关键命令
别只信“看起来能跑”，要逐层确认路径解析是否真按你预期走。
-
echo $PATH（macOS/Linux）或echo %PATH%（Windows CMD）：看目标路径是否真的在里面，顺序是否合理 -
where python（Windows CMD）或which python（macOS/Linux）：查当前实际调用的是哪个可执行文件 -
python -c "import sys; print(sys.executable)"：确认 Python 解释器自身加载的是哪个路径——这比which更权威，因为可能被 virtualenv 或 pyenv 干扰 - 如果用了
pyenv或conda，它们会接管PATH，此时不要手动改系统PATH，而是用pyenv global 3.12.0或conda activate base来切换
环境变量是隐式依赖，改一次能管很久，但一旦出问题，排查链路长、干扰因素多——最稳妥的做法是每次换新机器或重装系统后，第一件事就是用 which python 和 python -c "import sys; print(sys.executable)" 对齐两个路径，再继续装包或写代码。
