一、Windows 安装 Python（最常见）

✅ 推荐步骤（照着做）
下载
官网：https://www.python.org/downloads/
点 Download Python 3.x.x（一般选最新的 3.12 / 3.11）
运行安装程序
✅ 一定要勾选​
☑️ Add Python to PATH

点击 Install Now
验证是否成功

打开 CMD / PowerShell​ 输入：
python --version
pip --version
能看到版本号 ✅ 说明安装和环境变量都 OK

二、如果已经装了但没配 PATH（补救）

方法 1：重新修复（最简单）
重新运行安装包
选择：
Modify → Next → 勾选 Add Python to environment variables → Install
方法 2：手动加 PATH（不重装）
把这两个路径加到系统环境变量（示例）：
C:\Users\你的用户名\AppData\Local\Programs\Python\Python3xx
C:\Users\你的用户名\AppData\Local\Programs\Python\Python3xx\Scripts\

三、macOS 安装 Python

✅ 推荐方式（Homebrew）
brew install python
验证：
python3 --version
pip3 --version
不用 Homebrew
去 python.org 下载 .pkg安装即可
macOS 自带 Python 2（不要用，已废弃）

四、Linux（Ubuntu / Debian）

安装
sudo apt update
sudo apt install python3 python3-pip
验证
python3 --version
pip3 --version

五、安装后必做的 2 件事 ✅

升级 pip

python -m pip install --upgrade pip

测试运行

python

print(“hello”)

六、常见错误速查