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是Mac上最常用的命令行软件包管理器,后续安装Python、pyenv等都依赖它。
/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)macOS系统自带Python 2.7(已弃用)或较旧的Python 3.x,不建议直接使用。用pyenv可以自由切换多个Python版本,避免项目冲突。
brew install 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)"' >> ~/.zshrcsource ~/.zshrc
pyenv install --list | grep "^\s*3\.[8-12]"
pyenv install 3.11.9(首次可能需安装Xcode命令行工具:xcode-select --install)pyenv global 3.11.9,验证:python --version
每个Python项目最好用独立虚拟环境,避免包版本打架。Python 3.3+已内置venv模块,无需额外安装。
立即学习“Python免费学习笔记(深入)”;
mkdir ~/myproject && cd ~/myproject
python -m venv venv
source venv/bin/activate(终端提示符前会显示(venv))pip install --upgrade pip
pip install setuptools wheel black flake8 pytest
deactivate
VS Code免费、轻量、插件丰富,对Python支持极佳,适合大多数开发者。
venv环境Cmd+Shift+P,输入“Python: Select Interpreter”,选中项目下的venv/bin/python

.vscode/settings.json中配置基本上就这些。不用折腾系统Python,不手动改PATH,靠pyenv + venv + VS Code这套组合,能覆盖从学习、脚本、Web到数据科学的大部分需求。环境干净,升级方便,出问题也容易重置。