别担心，这是在安装 Python 后一个非常常见的问题,通常有两个原因：
（图片来源网络，侵删）
- 环境变量（PATH）没有设置正确：这是最常见的原因，操作系统的“PATH”是一个路径列表，告诉系统去哪里寻找可执行的程序（如
python.exe），如果安装程序没有自动将 Python 的路径添加到系统 PATH 中，你就无法在命令行中直接输入python来运行它。 - 你安装了多个 Python 版本：系统中可能存在多个 Python 安装,导致命令行不知道该使用哪一个。
下面我将为你提供详细的排查和解决方法,请根据你的操作系统选择对应的步骤。
检查是否已安装（首要步骤）
在开始修复之前，我们先确认一下 Python 是否真的安装了。
对于 Windows 用户：
- 按
Win + R键，输入cmd，然后按回车,打开命令提示符。 - 输入以下命令并回车：
python --version
或者
py --version
- 如果显示了版本号（
Python 3.11.4），说明 Python 已经安装，但环境变量可能有问题，请直接跳到 “方法二：修复环境变量”。 - 如果提示
'python' 不是内部或外部命令，也不是可运行的程序或批处理文件，则说明系统找不到 Python,环境变量确实需要设置。
- 如果显示了版本号（
对于 macOS / Linux 用户：
- 打开终端（Terminal）。
- 输入以下命令并回车：
python3 --version
- 如果显示了版本号，说明 Python 3 已经安装，在 macOS/Linux 上，推荐使用
python3命令来明确调用 Python 3，你可以跳到 “方法三：创建一个别名（Alias）” 来方便使用python命令。 - 如果提示
command not found，说明 Python 可能没有安装，或者安装路径不在系统 PATH 中。
- 如果显示了版本号，说明 Python 3 已经安装，在 macOS/Linux 上，推荐使用
修复环境变量（主要针对 Windows）
这是最核心的解决方法，我们将手动把 Python 的路径添加到系统环境变量中。
（图片来源网络，侵删）
步骤 1：找到 Python 的安装路径
-
在 Windows 搜索栏中搜索“编辑系统环境变量”并打开它。
-
在弹出的“系统属性”窗口中，点击右下角的“环境变量...”按钮。
-
在下方的“系统变量”区域（注意，不是“用户变量”），找到名为
Path的变量，选中它，然后点击“编辑...”。 -
在“编辑环境变量”窗口中，点击“新建”。
（图片来源网络，侵删） -
现在我们需要添加 Python 的安装路径，通常它位于
C:\Users\你的用户名\AppData\Local\Programs\Python\PythonXX（XX是版本号，如 Python311）。 -
如何找到确切路径？
- 打开文件资源管理器，导航到
C:\。 - 在地址栏输入
%APPDATA%然后回车，这会直接跳转到C:\Users\你的用户名\AppData\Roaming。 - 向上返回一级，进入
Local文件夹，再进入Programs文件夹，你应该能看到Python文件夹。 - 进入
Python文件夹，找到你安装的版本文件夹（如Python311）,复制这个完整路径。 - 将这个路径粘贴到“编辑环境变量”窗口的“新建”输入框中。
- 重要：再新建一个，并粘贴
Scripts文件夹的路径，它通常是C:\Users\你的用户名\AppData\Local\Programs\Python\PythonXX\Scripts，这个路径包含了pip等工具。
- 打开文件资源管理器，导航到
步骤 2：验证修改
- 点击所有窗口的“确定”来保存设置。
- 关键一步：完全关闭所有已打开的命令提示符（CMD）或 PowerShell 窗口，然后重新打开一个新的。
- 在新的命令提示符中，再次输入
python --version。 - 如果这次显示了版本号，恭喜你,问题已经解决！
创建一个别名（主要针对 macOS / Linux）
在 macOS 和 Linux 上，Python 3 通常默认安装，但为了方便，我们通常希望直接输入 python 就能调用它。
- 打开终端。
- 输入以下命令来创建一个别名，这个命令会将
python命令指向python3。echo 'alias python=python3' >> ~/.bashrc
注意：如果你使用的是 Zsh shell（较新的 macOS 版本默认使用），则应使用
~/.zshrc文件：echo 'alias python=python3' >> ~/.zshrc
- 让配置立即生效：
source ~/.bashrc
或者对于 Zsh:
source ~/.zshrc
- 在终端中输入
python --version,它应该就能正常工作了。
使用 Python 启动器（py 命令）
这是一个非常实用的备选方案，尤其是在 Windows 上安装了多个 Python 版本时，Python 安装程序会自动安装一个名为 py.exe 的 Python 启动器。
- 在 Windows 的命令提示符中，直接输入
py并回车。 - 它会启动你安装的最新版本的 Python。
- 你也可以指定版本，
py -3.11(启动 Python 3.11)py -2(启动 Python 2,如果你也安装了的话)
- 在脚本中，你也可以使用
#!/usr/bin/env py来调用启动器,这比硬编码路径更灵活。
总结与快速自查
| 问题现象 | 可能原因 | 解决方案 |
|---|---|---|
输入 python --version 报错 |
Windows 环境变量未设置 | 修复环境变量 |
输入 python 报错，但 python3 正常 |
macOS/Linux 未设置别名 | 创建一个别名 |
| 想运行特定版本的 Python | Windows 安装了多个版本 | 使用 py 命令 |
| 完全没反应，也找不到安装目录 | Python 可能安装失败 | 重新下载并安装 Python，安装时务必勾选 "Add Python to PATH" 选项。 |
最重要的提示： 如果你正在重新安装 Python，请务必在安装程序的第一个界面，勾选那个标有 "Add Python to PATH" 或 "将 Python 添加到环境变量" 的选项,这能让你省去后续的所有麻烦。
希望这些步骤能帮你解决问题！如果还有疑问,请随时追问。
