1通过 喵大师 自动完成安装（推荐）
优先完成喵大师安装后，可以直接把下面的指令交给 喵大师，让它自动完成 Python 安装和 pip 源配置，无需手动操作。
给 喵大师 的完整指令
“请在 Mac 上完成以下操作：
1. 以静默/自动方式安装 Python 3.14.4，安装完成后确保 python3 和 pip3 命令可用。
2. 安装完成后，将 pip 源配置为阿里云国内镜像：
- index-url: https://mirrors.aliyun.com/pypi/simple/
- trusted-host: mirrors.aliyun.com
3. 验证安装结果，输出 `python3 --version` 和 `pip3 --version` 的结果，并确认 pip 源已生效。”
1. 以静默/自动方式安装 Python 3.14.4，安装完成后确保 python3 和 pip3 命令可用。
2. 安装完成后，将 pip 源配置为阿里云国内镜像：
- index-url: https://mirrors.aliyun.com/pypi/simple/
- trusted-host: mirrors.aliyun.com
3. 验证安装结果，输出 `python3 --version` 和 `pip3 --version` 的结果，并确认 pip 源已生效。”
注意：Mac 安装包默认安装到 /Applications/Python 3.14/ 目录，安装过程中会提示输入管理员密码，喵大师执行时需确保有 sudo 权限。
2手动安装
本章节分为两个部分：2.1 安装 Python 和 2.2 配置 pip 源，安装和配置均完成后，再进入第三章统一验证。
2.1 安装 Python
方式一：通过 Homebrew 安装（推荐）
Homebrew 是 macOS 上最流行的包管理器，推荐使用此方式安装。
- 检查是否已安装 Homebrew
brew --version
若未安装，按照官网提示安装：👉 https://brew.sh/
- 安装 Python 3.14
brew install python@3.14
💡 若提示版本不存在，可尝试使用 pyenv 或官方安装包。
- 将 Python 添加到 PATH
# Apple Silicon Mac echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc source ~/.zshrc
2.2 配置 pip 国内镜像源
国内直连 PyPI 官方源速度较慢，推荐使用国内镜像。
| 镜像名称 | 地址 |
|---|---|
| 阿里云（推荐） | https://mirrors.aliyun.com/pypi/simple/ |
| 清华大学 | https://pypi.tuna.tsinghua.edu.cn/simple/ |
| 腾讯云 | https://mirrors.cloud.tencent.com/pypi/simple/ |
命令行一键配置
pip3 config set global.index-url https://mirrors.aliyun.com/pypi/simple/ pip3 config set global.trusted-host mirrors.aliyun.com
3验证安装
Python 版本验证
python3 --version
输出：Python 3.14.4
pip 镜像验证
pip3 config list
应包含阿里云镜像地址
常见问题
Q: 运行 python3 提示「command not found」?
通常是 PATH 环境变量未配置。请尝试重启终端，或手动执行：export PATH="/Applications/Python 3.14:$PATH"
Q: pip3 和 pip 有什么区别？
Mac 上始终使用 pip3 以确保操作的是 Python 3 环境，避免污染系统预装的 Python 2。