如何在Mac上配置Python开发环境?(详细步骤)

Mac配置Python开发环境应使用pyenv管理多版本Python、venv创建隔离虚拟环境、VS Code作为编辑器。先装Homebrew,再用其安装pyenv,配置zshrc后安装并设为全局的Python 3.11.9,接着用venv建环境并激活,最后在VS Code中选对应解释器并装Python扩展。

在Mac上配置Python开发环境,关键是选对Python版本管理方式、装好包管理工具、再配一个顺手的编辑器或IDE。系统自带的Python不要动,直接用pyenvHomebrew装新版更安全稳定。

安装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"' >> ~/.zshrc
  • echo 'command -v pyenv >/dev/null || export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.zshrc
  • echo '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./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到数据科学的大部分需求。环境干净,升级方便,出问题也容易重置。