在 macos 上配置多版本开发工具环境变量，核心是用 pyenv + homebrew + zsh 构建分层调度体系：先确认 shell 为 zsh，再按序配置 pyenv_root、path 和 eval "$(pyenv init -zsh)"，通过 pyenv global/local/shell 三级切换 python 版本，避免手动硬编码路径。
在 macos 上配置环境变量支持多版本开发工具，核心不是堆砌路径，而是建立分层、可切换、不冲突的调度体系。关键在于用好 pyenv、homebrew 和 zsh 配置机制，让不同语言、不同版本的工具互不干扰，按需生效。
确认并统一 shell 环境
macOS Catalina（10.15）起默认使用 zsh，必须确保终端运行的是 zsh，否则配置不会加载：
- 运行
echo $SHELL，输出应为/bin/zsh - 若显示
/bin/bash，执行chsh -s /bin/zsh切换，并重启终端 - 所有后续配置都写入
~/.zshrc，不要混用.bash_profile
基础 PATH 配置：优先级与隔离原则
PATH 不是越长越好，顺序决定命令优先级。系统级路径（如 /usr/bin）应靠后，用户管理的工具路径（如 Homebrew、pyenv）必须前置：
macOS Automator Services
下载
部署和使用军舰的 macOS Automator 自动化服务集合。包含 5 个实用工作流：PDF转JPG、PNG重命名并转JPG、图像拼接、解压RAR、顺序命名图像文件。一键安装所有服务到 ~/Library/Services/ 目录。使用场景：(1) "安装我的自动化服务"，(2) "部署所有 Automato...
- Homebrew 安装后，务必执行：
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc && source ~/.zshrc - pyenv 初始化三行必须严格按顺序写入
~/.zshrc：export PYENV_ROOT="$HOME/.pyenv"export PATH="$PYENV_ROOT/bin:$PATH"eval "$(pyenv init -zsh)" - 避免直接把
/opt/homebrew/bin或~/.pyenv/versions/3.12.5/bin手动加进 PATH —— 这会破坏 pyenv 的动态路由能力
多版本 Python：用 pyenv 管理而非 PATH 硬编码
pyenv 的本质是通过 shell shim 拦截 python、pip 命令，自动映射到对应版本的二进制。你只需控制“谁生效”，而不是“路径在哪”：
- 安装多个版本：
pyenv install 3.11.9 3.12.5 - 项目级绑定（推荐）：
cd myproject && pyenv local 3.12.5→ 自动生成.python-version文件 - 全局默认（慎用）：
pyenv global 3.11.9 - 临时会话：
pyenv shell 3.12.5（关闭终端即还原） - 每次切换后验证：
python --version和which python应指向~/.pyenv/versions/xxx/bin/python
其他语言多版本（如 PHP/Node）：复用 Homebrew + 路径软链
PHP、Node.js 等可借助 Homebrew 多版本 tap + brew link 切换，再配合 PATH 前置确保优先调用：
- PHP 示例：
brew tap shivammathur/php && brew install php@8.1 php@8.2 - 切换时先解绑再强链：
brew unlink php && brew link --force php@8.1 - 在
~/.zshrc中添加（注意路径顺序）：export PATH="/opt/homebrew/opt/php@8.1/bin:$PATH" - Node 可用
nvm替代，配置逻辑类似：初始化 nvm 后，用nvm use 20.15.0切换，无需手动改 PATH
