Windows 安装 Python 后 CMD 命令行无法识别

Windows 安装 Python 后 CMD 无法识别的排查指南

1. 检查 Python 是否已正确安装

• 打开文件资源管理器，进入 Python 的安装目录（默认路径通常是 C:\Users\<用户名>\AppData\Local\Programs\Python\PythonXX 或 C:\Program Files\PythonXX，XX 是版本号）。
• 确认目录下存在 python.exe 文件。

2. 检查 Python 是否被添加到系统环境变量

Python 安装时有一个选项 'Add Python to PATH'，如果未勾选，会导致 cmd 找不到命令。

手动添加 Python 到 PATH

1. 打开环境变量设置：
   • 按 Win + R，输入 sysdm.cpl，回车打开 系统属性。
   • 切换到 高级 选项卡，点击 环境变量。
2. 编辑 Path 变量：
   • 在 系统变量 区域，找到 Path 变量，点击 编辑。
   • 如果是全局安装，路径可能是 C:\Program Files\PythonXX\。
3. 保存并重启 cmd：
   • 关闭所有 cmd 窗口，重新打开并输入 python --version 测试。

点击 新建，添加以下两条路径（根据你的 Python 安装路径调整）：

C:\Users\<用户名>\AppData\Local\Programs\Python\PythonXX\
C:\Users\<用户名>\AppData\Local\Programs\Python\PythonXX\Scripts\

3. 检查是否安装了多个 Python 版本

如果系统中有多个 Python 版本（如 Anaconda 和官方 Python 并存），可能会导致冲突。

解决方法

• 如果存在冲突，可以卸载不需要的版本，或直接通过完整路径调用。

输入完整路径测试：

C:\Users\<用户名>\AppData\Local\Programs\Python\PythonXX\python --version

4. 检查 Python 可执行文件名称

某些 Python 安装版本（如通过 Microsoft Store 安装的 Python）可能命令为 python3 或 py。

python3 --version
py --version

5. 重新安装 Python 并勾选 PATH

如果问题仍未解决，建议重新安装 Python：

1. 卸载现有 Python（控制面板 → 卸载程序）。
2. 重新下载 Python 安装包（从 python.org）。