首先确认并配置zsh环境,通过编辑~/.zshrc设置别名与路径;接着用brew安装pyenv管理Python版本,安装3.11.5并设为全局默认;然后为项目创建独立虚拟环境以隔离依赖;最后验证python、which python和pip版本确保配置正确。

Mac 上配置 zsh 与 Python 的完整指南
macOS 默认使用 zsh 作为系统 shell,而 Python 是许多开发任务的核心工具。正确配置 zsh 与 Python 环境能提升开发效率并避免版本混乱。
1. 确认 zsh 环境
大多数 Mac 已默认使用 zsh。可通过以下命令确认:
-
echo $SHELL—— 应显示/bin/zsh -
zsh --version—— 查看当前 zsh 版本
若需切换 shell(如从 bash 切到 zsh):
立即学习“Python免费学习笔记(深入)”;
- 运行
chsh -s /bin/zsh - 重启终端生效
2. 配置 zsh 启动文件
zsh 启动时会读取 ~/.zshrc 文件。创建或编辑该文件:
-
nano ~/.zshrc或使用其他编辑器 - 常见配置包括设置别名、环境变量和提示符
示例内容:
export PATH="$HOME/bin:$PATH" alias python=python3 alias pip=pip3 source "$HOME/.venv/bin/activate" # 若有全局虚拟环境
3. 安装与管理 Python 版本
macOS 自带的 Python 通常较旧,建议使用 pyenv 管理多个版本:
- 安装 pyenv:
brew install pyenv - 在
~/.zshrc中添加:
export PYENV_ROOT="$HOME/.pyenv" export PATH="$PYENV_ROOT/bin:$PATH" eval "$(pyenv init -)"
- 重新加载配置:
source ~/.zshrc - 查看可用版本:
pyenv install --list | grep " 3\." - 安装指定版本:
pyenv install 3.11.5 - 设为全局默认:
pyenv global 3.11.5
4. 使用虚拟环境隔离项目依赖
推荐每个项目使用独立的虚拟环境:
- 创建环境:
python -m venv ~/myproject_env - 激活环境:
source ~/myproject_env/bin/activate - 退出环境:
deactivate
也可将激活命令写入项目脚本或通过 direnv 自动加载。
5. 验证配置结果
在终端执行以下命令检查是否配置成功:
-
python --version—— 应显示 pyenv 设置的版本 -
which python—— 路径应指向 pyenv 的 shims 目录 -
pip --version—— 确认与 Python 版本匹配
基本上就这些。一套清晰的 zsh + Python 配置,关键是路径正确、版本可控、环境分离。不复杂但容易忽略细节。










