应使用 homebrew 安装独立 python 并配置 path 优先调用，再创建激活虚拟环境，最后安装开发工具并配置编辑器解释器。
如果您刚接触 macOS 系统并希望搭建一个稳定、可复用的 Python 开发环境，可能会遇到系统自带 Python 版本冲突、pip 权限错误、虚拟环境未激活等常见问题。以下是针对新手易踩坑点设计的配置步骤：
一、确认系统预装 Python 状态并禁用默认版本干扰
macOS 自带 Python 2.7（旧版本）或 Python 3.x（如 Ventura 及以后），但这些版本受系统保护，不可修改或升级，直接使用会导致权限报错或包安装失败。必须通过独立方式管理 Python 运行时。
1、打开终端，执行 which python3 查看当前 python3 路径；若返回 /usr/bin/python3，说明是系统版本。
2、执行 xcode-select --install 安装命令行工具，为后续编译依赖提供支持。
立即学习“Python免费学习笔记（深入）”；
3、执行 sudo rm -f /usr/bin/python3 不可行且危险，应改为在 shell 配置文件中屏蔽系统路径优先级。
二、使用 Homebrew 安装独立 Python 运行时
Homebrew 是 macOS 最主流的包管理器，它安装的 Python 完全独立于系统，支持多版本共存，并自动配置可执行路径。
1、若未安装 Homebrew，执行 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" 安装。
2、执行 brew update 更新包索引。
3、执行 brew install python 安装最新稳定版 Python（含 pip 和 venv）。
4、执行 brew link python 确保可执行文件链接到 /opt/homebrew/bin（Apple Silicon）或 /usr/local/bin（Intel）。
三、配置 Shell 环境变量以优先调用 Homebrew Python
Shell 启动时需确保 PATH 中 Homebrew 的 bin 目录排在系统路径之前，否则终端仍会调用 /usr/bin 下的旧版本。
1、执行 echo $SHELL 确认当前 shell 类型（zsh 为默认）。
2、编辑配置文件：nano ~/.zshrc（如为 bash，则编辑 ~/.bash_profile）。
3、在文件末尾添加两行：
export PATH="/opt/homebrew/bin:$PATH"（Apple Silicon）
export PATH="/usr/local/bin:$PATH"（Intel）。
4、执行 source ~/.zshrc 使配置立即生效。
四、创建并激活项目级虚拟环境
虚拟环境可隔离各项目的依赖包，避免不同项目间版本冲突，是 Python 开发的强制实践规范。
1、进入项目目录，执行 python3 -m venv venv 创建名为 venv 的虚拟环境目录。
2、执行 source venv/bin/activate 激活环境，终端提示符前将显示 (venv) 标识。
3、执行 which python 验证路径是否指向项目内 venv/bin/python。
4、执行 pip install --upgrade pip 升级虚拟环境内的 pip 到最新版。
五、安装基础开发工具与验证环境可用性
完成环境隔离后，需安装代码检查、格式化和调试支持工具，确保编辑器能正确识别解释器路径。
1、在已激活的虚拟环境中执行 pip install black isort pylint mypy 安装常用开发辅助工具。
2、执行 python -c "import sys; print(sys.executable)" 输出应为 venv/bin/python 路径。
3、执行 pip list 查看已安装包，确认无系统级包混入。
4、在 VS Code 中打开项目文件夹，按下 Cmd+Shift+P，输入 Python: Select Interpreter，选择项目根目录下 venv/bin/python。
