如何在 macOS 中快速切换不同项目所需的开发环境

macOS 项目开发环境切换应基于“项目即上下文”机制：通过 nvm/jenv/RSwitch 绑定目录级语言版本，用符号链接与脚本动态挂载服务/存储路径，配合 goto-xxx 函数、OpenInTerminal 和 dnsmasq 实现一键启动完整上下文，并以 .env、docker-compose.yml 和虚拟机快照保障配置可复现。

在 macos 上快速切换不同项目所需的开发环境，关键不是堆砌工具，而是建立一套“项目即上下文”的自动化响应机制。每个项目自带它的语言版本、服务依赖、存储路径和网络入口，切换动作本质是激活对应配置，而不是手动改一堆设置。

用版本管理器绑定项目目录

把环境版本和项目文件夹直接挂钩，避免全局切换带来的干扰：

• Node.js 项目：在项目根目录执行 nvm use 18.19，再加一句 nvm alias project-a 18.19；后续进入该目录自动加载指定版本（需确保 .nvmrc 文件存在）
• Java 项目：安装 jenv 后，在项目目录运行 jenv local 17.0，它会生成 .java-version 文件，下次 cd 进来就自动切到 JDK 17
• R 语言项目：用 RSwitch 配合项目级脚本，比如在 project-r-analysis/ 下放一个 use-r42.sh，双击即可锁定 R 4.2 环境

服务与存储按项目动态挂载

不重启虚拟机或容器，也能让后端服务读写正确的数据目录：

• 在虚拟机或 Docker 容器内统一使用 /srv/current-project 作为数据根路径
• 在 macOS 主机上为每个项目写一个映射脚本，例如 link-to-shop-api.sh，内容为：
  rm -f ~/VMShared/current-project && ln -s ~/Projects/shop-api/storage ~/VMShared/current-project
• 配合 Nginx 的 include /etc/nginx/sites-enabled/$PROJECT_NAME.conf，服务启动时自动读取当前项目名并加载对应配置

一键进入完整开发上下文

从 Finder 点一下，就打开终端、启动服务、跳转浏览器，全程无需手动 cd 或复制粘贴：

• 装 OpenInTerminal，在 Finder 工具栏点击图标，直接在项目目录打开 iTerm 或 VS Code
• 在 ~/.zshrc 中定义函数：
  goto-shop-api() { cd ~/Projects/shop-api && docker-compose up -d && open http://localhost:3001; }
• 搭配 dnsmasq 把 shop-api.test 指向 127.0.0.1，浏览器输域名就能访问，不用记端口

配置文件与快照分层保存

环境状态要可回溯、可复现，不能靠“我记得上次怎么配的”：

• 每个项目目录下放 .env 和 docker-compose.yml，数据库名、密钥、端口全在里面，docker-compose up 自动读取
• 虚拟机用 VMware Fusion 或 Parallels Desktop，为每个项目保存命名清晰的快照，如 vue3-setup、payment-integrated
• Nginx 多环境通过符号链接切换：sudo ln -sf conf.d/shop-api.conf /usr/local/etc/nginx/active，再配合 nginx -s reload