一、先说清楚：你到底需要“系统 Python”还是“项目 Python”？
很多安装问题不是装错了，而是同一台电脑上有多个 Python（系统自带/商店版/你自己装的），再加上多个终端（CMD/PowerShell/Terminal）导致调用路径不同。
本文目标很明确：让你在 Windows/macOS 上做到三件事：
- 安装一个可控、可升级的 Python（不和系统自带打架）。
- 每个项目用 venv 单独隔离依赖，互不污染。
- pip 安装速度正常、遇到报错有排查思路。
二、安装前检查（2 分钟确认现状）
打开终端执行以下命令（Windows 用 PowerShell / macOS 用 Terminal）：
python --version
python3 --version
pip --version
where python # Windows
which -a python3 # macOS
你要关注两点：
- 版本是否符合你项目要求（建议 3.10+，新项目优先 3.11/3.12）。
- 路径是否指向你希望的安装位置（避免指到 Microsoft Store 或系统目录）。
三、Windows 11/10 正确安装 Python（推荐方案）
推荐：从 Python 官方安装包安装，并把“Add python.exe to PATH”勾上。
- 下载安装包后运行安装器，第一屏务必勾选 Add python.exe to PATH。
- 点击 Customize installation（可选），建议勾选：pip、tcl/tk（用到 GUI 才需要）、py launcher。
- 安装完成后重新打开 PowerShell，执行：
python --version
pip --version
py -V
如果你发现 python 仍然指向 Microsoft Store，按下面方式处理：
- 进入“设置 → 应用 → 应用执行别名”，把 python.exe / python3.exe 的别名开关关掉。
- 关闭所有终端窗口，重新打开再测一次。
四、macOS 安装 Python（两条路：官方安装包 / Homebrew）
macOS 通常自带一个系统 Python（或没有 python 命令），不建议拿它做开发环境。
方案 A：官方安装包（适合新手，简单稳定）
- 安装后通常可用 python3，并自带 pip3。
方案 B：Homebrew 安装（适合经常开发、需要多工具链的人）
- 安装好 brew 后执行 brew install python，再用 python3 --version 验证。
- 若出现“command not found”，一般是 shell 没加载 brew 的 PATH；重开 Terminal 或检查 .zshrc。
五、为每个项目创建虚拟环境（venv 标准做法）
建议每个项目目录都放一个 .venv，并把它加入 .gitignore。
- 进入你的项目目录：
cd your-project
- 创建虚拟环境（Windows/macOS 通用）：
python -m venv .venv
- 激活虚拟环境：
# Windows PowerShell
..venv sActivate.ps1
# Windows CMD
..venv sactivate.bat
# macOS / Linux
source .venv/bin/activate
激活后你会看到命令行前面多了 (.venv) 之类的标记。接着执行：
python -V
pip -V
确认此时的 python/pip 指向虚拟环境目录，说明隔离成功。
六、pip 的“必做三件套”：升级、设置镜像（可选）、锁定依赖
1）先升级 pip、setuptools、wheel
python -m pip install -U pip setuptools wheel
2）下载慢时再考虑镜像（公司网络/地区网络波动时很常见）
pip install requests -i https://pypi.tuna.tsinghua.edu.cn/simple
- 长期配置：用 pip config 写入配置（不同系统路径不同，但命令一致）：
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
3）把依赖写进 requirements.txt（或使用更高级工具）
pip freeze > requirements.txt
团队协作时，建议从 requirements.txt 安装：
pip install -r requirements.txt
七、常见报错速查（照着对号入座）
报错 1：'python' 不是内部或外部命令 / command not found
- Windows：检查是否勾选 PATH；检查“应用执行别名”；重开终端。
- macOS：确认用的是 python3；检查 shell 配置是否加载了 brew。
报错 2：Permission denied / 没有权限写入
- 不要在系统目录里全局装包；优先用 venv。
- 确认已激活虚拟环境后再安装依赖。
报错 3：SSL: CERTIFICATE_VERIFY_FAILED
- 多见于公司代理/抓包环境或证书链异常。
- 优先检查网络与代理设置；必要时换网络验证是否为环境问题。
报错 4：No matching distribution found / Requires Python >= x.y
- 说明当前 Python 版本太低或平台不匹配；升级 Python 或换兼容版本的包。
- 如果是 Apple Silicon（M 系列）装到 x86 轮子，注意终端架构是否一致。
报错 5：pip 安装很慢/卡住
- 先升级 pip；再尝试镜像；最后检查是否被防火墙/代理拦截。
八、推荐工作流（最省心）
- 系统层只安装 Python（尽量不全局装包）。
- 每个项目：python -m venv .venv → 激活 → pip install -r requirements.txt。
- 需要切换项目：退出当前 venv（deactivate），再进入另一个项目激活它的 venv。
这样做的好处是：版本可控、依赖隔离、迁移到新电脑也更快。
