Mac配置Python开发环境应使用pyenv管理多版本Python、venv创建隔离虚拟环境、VS Code作为编辑器。先装Homebrew，再用其安装pyenv，配置zshrc后安装并设为全局的Python 3.11.9，接着用venv建环境并激活，最后在VS Code中选对应解释器并装Python扩展。
在Mac上配置Python开发环境，关键是选对Python版本管理方式、装好包管理工具、再配一个顺手的编辑器或IDE。系统自带的Python不要动，直接用pyenv或Homebrew装新版更安全稳定。
安装Homebrew（基础依赖管理）
Homebrew是Mac上最常用的命令行软件包管理器，后续安装Python、pyenv等都依赖它。
- 打开终端（Terminal），粘贴并运行官方安装命令：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"- 安装完成后，执行
brew doctor检查环境是否正常 - 建议把
brew的bin路径加入~/.zshrc（M1/M2芯片默认用zsh）： -
echo 'export PATH="/opt/homebrew/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc（Intel芯片路径为/usr/local/bin）
安装Python（推荐用pyenv管理多版本）
macOS系统自带Python 2.7（已弃用）或较旧的Python 3.x，不建议直接使用。用pyenv可以自由切换多个Python版本，避免项目冲突。
- 用Homebrew安装pyenv：
brew install pyenv - 让pyenv在每次启动终端时自动生效，在
~/.zshrc末尾添加： echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.zshrcecho 'command -v pyenv >/dev/null || export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.zshrcecho 'eval "$(pyenv init - zsh)"' >> ~/.zshrc- 重新加载配置：
source ~/.zshrc - 查看可用Python版本：
pyenv install --list | grep "^\s*3\.[8-12]" - 安装一个常用版本，比如3.11.9：
pyenv install 3.11.9（首次可能需安装Xcode命令行工具：xcode-select --install） - 设为全局默认：
pyenv global 3.11.9，验证：python --version
配置pip与虚拟环境（隔离项目依赖）
每个Python项目最好用独立虚拟环境，避免包版本打架。Python 3.3+已内置venv模块，无需额外安装。
立即学习“Python免费学习笔记（深入）”；
- 创建项目文件夹，例如：
mkdir ~/myproject && cd ~/myproject - 初始化虚拟环境：
python -m venv venv - 激活环境：
source venv/bin/activate（终端提示符前会显示(venv)） - 升级pip：
pip install --upgrade pip - 安装常用开发包：
pip install setuptools wheel black flake8 pytest - 退出环境：
deactivate
选择并配置代码编辑器（VS Code最推荐）
VS Code免费、轻量、插件丰富，对Python支持极佳，适合大多数开发者。
- 从官网下载安装VS Code：https://www.php.cn/link/919431c2f78cb0f50e79937f6dccb356
- 安装Python扩展（Microsoft官方出品，搜索“Python”即可）
- 打开你的项目文件夹，VS Code会自动识别
venv环境 - 按
Cmd+Shift+P，输入“Python: Select Interpreter”，选中项目下的venv/bin/python - 可选：安装Pylance（增强类型提示）、Jupyter（如果做数据分析）、GitLens（方便版本管理）
- 保存常用设置（如格式化用Black、保存时自动检查flake8）可在
.vscode/settings.json中配置
基本上就这些。不用折腾系统Python，不手动改PATH，靠pyenv + venv + VS Code这套组合，能覆盖从学习、脚本、Web到数据科学的大部分需求。环境干净，升级方便，出问题也容易重置。
