Mac 如何配置 zsh 与 Python

首先确认并配置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）：

• 运行 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 配置，关键是路径正确、版本可控、环境分离。不复杂但容易忽略细节。