🔴 一、问题现象

你打开终端（Windows的cmd或PowerShell），输入：

bash

python --version

结果看到：

Windows下的报错：

text

'python' 不是内部或外部命令，也不是可运行的程序或批处理文件。

或者英文系统：

text

'python' is not recognized as an internal or external command,
operable program or batch file.

💡 有些电脑输入 python 没反应，但输入 py 可能能用。如果 py --version 能正常显示版本，说明Python其实装好了，只是 python 命令没被识别。可以先试试 py 应急，但最好还是把 python 修好。

---

❓ 二、这是什么原因？

问题的根源在于 环境变量 PATH 里没有包含 Python 的安装路径。

简单来说：

• 当你在终端输入一个命令（比如 python）时，系统会去 PATH 里列出的所有文件夹里找这个命令

• 如果 PATH 里没有 Python 的安装目录，系统就找不到 python 命令

• 你安装时忘记勾选了最底部那个 "Add Python to PATH" 复选框

![安装界面示意图]（注意底部那个一定要打勾）

这就是唯一的原因，不需要怀疑是不是装坏了。

---

✅ 三、解决方案（两种方法）

方法一：重新安装（推荐新手，最简单）

这个方法最简单、最保险，适合所有新手。

1. 找到你下载的 Python 安装包（文件名类似 python-3.12.x-amd64.exe），双击重新运行。

2. 安装程序启动后，不要点 "Install Now"，而是点击下方的 "Modify"（修改）或 "Uninstall"（卸载）。

   💡 更保险的做法：先点 "Uninstall" 彻底卸载，然后重新安装。

3. 如果选择重新安装，在安装界面的最底部，务必勾选 "Add Python to PATH"。

4. 点击 "Install Now"，等待安装完成。

5. 安装完成后，关掉所有已打开的终端窗口，重新打开一个（因为旧的终端环境变量还没刷新）。

6. 再次输入 python --version，验证是否成功。

操作示意：

text

安装界面底部：
☑ Install launcher for all users (recommended)
☑ Add Python to PATH        ← 这个一定要打勾！

⚠️ 注意：如果安装程序已经找不到了，可以去官网重新下载一个，用新安装包覆盖安装即可。覆盖安装不会影响你之前写的代码。

---

方法二：手动添加环境变量（不重新安装）

如果不想重新安装，可以手动把 Python 的路径加到 PATH 里。

第1步：找到 Python 的安装位置

Python 默认安装在：

• Windows（默认）：C:\Users\你的用户名\AppData\Local\Programs\Python\Python312\

• Windows（系统级安装）：C:\Program Files\Python312\

• 如果你自定义了安装位置，就去你选的那个文件夹

💡 如果找不到，在开始菜单搜索 "Python"，右键点击 → "打开文件位置"，再右键点击快捷方式 → "打开文件所在位置"，就能找到真正的安装目录。

第2步：复制安装目录的路径

比如你的 Python 装在：

text

C:\Users\张三\AppData\Local\Programs\Python\Python312\

同时，还需要找到 Scripts 文件夹的路径（pip 等工具在这里）：

text

C:\Users\张三\AppData\Local\Programs\Python\Python312\Scripts\

💡 你需要把这两个路径都加到 PATH 里，一个是 Python 本身，一个是 pip 等工具。

第3步：打开环境变量设置

Windows 11/10：

1. 在桌面或文件夹里，右键点击 "此电脑"（或"我的电脑"）

2. 选择 "属性"

3. 点击左侧的 "高级系统设置"

4. 在弹出的窗口中，点击 "环境变量" 按钮

或者快捷方式：

• 按 Win + R，输入 sysdm.cpl，回车 → 高级 → 环境变量

第4步：添加路径到 PATH

1. 在 "系统变量"（下半部分）里找到 Path，选中后点击 "编辑"

2. 点击 "新建"

3. 粘贴 Python 的安装目录路径（如 C:\Users\张三\AppData\Local\Programs\Python\Python312\）

4. 再次点击 "新建"

5. 粘贴 Scripts 目录路径（如 C:\Users\张三\AppData\Local\Programs\Python\Python312\Scripts\）

6. 一路点击 "确定" 关闭所有窗口

💡 如果不想影响其他用户，也可以在 "用户变量" 里添加，效果是一样的。

第5步：验证是否成功

1. 关掉所有已打开的终端窗口，重新打开一个新的 cmd 或 PowerShell（很重要！）

2. 输入：

bash

python --version

如果看到版本号，就成功了！

text

Python 3.12.2

---

🧪 四、验证成功的完整测试

修复完成后，建议运行以下测试，确保一切正常：

bash

# 1. 查看 Python 版本
python --version

# 2. 进入交互式环境
python

# 3. 在交互式环境里运行一行代码
>>> print("Hello, World!")
Hello, World!

# 4. 退出交互式环境（输入 exit() 或按 Ctrl+Z 回车）
>>> exit()

# 5. 检查 pip 是否可用
pip --version

如果以上全部正常，说明环境配置完美！

---

❓ 五、常见疑问解答

Q1：我明明勾选了 "Add Python to PATH"，为什么还是不行？

• 可能勾选后安装过程中出了小问题，重新安装一次就好了

• 也可能是终端窗口没关掉重开，环境变量需要新终端才能生效

• 极少数情况下，需要重启电脑

Q2：如果输入 python 不行，但输入 py 可以，怎么办？

• Windows 系统自带的 py 命令（Python Launcher）可以帮你找到 Python

• 你可以暂时用 py 代替 python

• 但建议还是把环境变量修好，因为很多教程都用 python 命令

Q3：我的 Python 装在 D 盘或自定义位置，怎么办？

• 找到你的自定义安装目录，把路径加到 PATH 即可

• 记得同时加两个路径：D:\你的Python目录\ 和 D:\你的Python目录\Scripts\

Q4：为什么改了环境变量后还是不行？

• 一定要关掉所有终端窗口重新打开，新终端才会读取新的 PATH

• 如果还不行，重启电脑（环境变量刷新最彻底的方式）

Q5：macOS/Linux 用户有没有这个问题？

• macOS/Linux 一般没有这个问题，因为 Python 通常通过包管理器安装，PATH 会自动配置

• 但如果用源码编译安装，也可能需要手动配置

• macOS 用户如果输入 python 出现的是 Python 2.7，请用 python3 代替

---

🛡️ 六、如何避免以后出现类似问题？

1. 每次安装时仔细看界面：不要无脑点 "Next"，每个选项都看一眼

2. 记住安装位置：安装时可以选择"自定义安装"，记下路径

3. 使用包管理器（进阶）：Windows 可以用 choco，macOS 用 brew，它们会自动配置环境变量

---

🎯 今日小结

问题	解决方法
'python' 不是内部或外部命令	1. 重新安装并勾选 PATH 2. 或手动添加环境变量
验证命令	python --version
核心提醒	改完环境变量要关掉终端重开