macOS环境隔离核心是变量作用域管理：一、按用户账户物理隔离最稳妥，新建专用账户并配置其~/.zshrc；二、按Shell会话用dev_env/prod_env函数动态切换；三、按项目目录用.env.*文件+dotenv工具自动加载；四、避免GUI应用继承失效、未export变量、launchd未显式定义及敏感信息硬编码等陷阱。
在 macOS 上用环境变量做开发与生产环境隔离，核心是让同一套代码在不同账户、终端会话或运行上下文中，自动加载对应配置，不靠手动改代码或文件。关键不在“设变量”，而在“谁设、何时设、谁可见”。
一、按用户账户物理隔离（最稳妥）
开发和生产环境绝不共用同一个系统账户。比如主账户叫 Alex，就新建一个 alexprod 作为生产部署专用账户：
- 在「系统设置 → 用户与群组」中新建标准账户，名称全小写、无空格（如
alexprod） - 所有生产相关的服务（如 Node.js 后端、Python API）、配置文件、密钥链都只存在于
/Users/alexprod下 - 在该账户的
~/.zshrc中导出生产环境变量：export NODE_ENV=productionexport DB_HOST=prod-db.example.comexport API_KEY="sk_live_..." - 重启终端或执行
source ~/.zshrc，再运行env | grep -E "(NODE_ENV|DB_HOST)"确认生效
二、按 Shell 会话动态切换（适合本地多环境调试）
不需要新建账户，但每次启动终端时可指定环境。推荐用简洁的 shell 函数封装：
- 在
~/.zshrc里添加：
dev_env() {
export NODE_ENV=development
export DB_HOST=localhost
export AUTH_SERVICE_URL=http://localhost:3001
echo "✅ 开发环境已激活"
}
prod_env() {
export NODE_ENV=production
export DB_HOST=prod-db.example.com
export AUTH_SERVICE_URL=https://auth.prod.example.com
echo "✅ 生产环境已激活"
}
- 新开终端后，直接输入
dev_env或prod_env切换，变量仅对当前终端有效 - 配合 VS Code：右键终端标签 →「New Terminal (In Active Workspace)」→ 运行
dev_env，确保编辑器内终端与代码运行环境一致
三、按项目目录自动加载（.env 文件 + dotenv 工具）
这是 Node.js、Python 等语言项目的主流做法，依赖工具自动读取，不污染全局 Shell：
- 在项目根目录放两个文件：
.env.development（含API_BASE_URL=https://api.dev.example.com）.env.production（含API_BASE_URL=https://api.example.com） - Node.js 项目中用
dotenv加载：require('dotenv').config({ path: `.env.${process.env.NODE_ENV}` }); - Python 项目用
python-decouple或python-dotenv，启动命令加参数：NODE_ENV=production node server.js或ENV=production python app.py - ⚠️ 注意：
.env.*文件绝不能提交到 Git，务必加入.gitignore
四、避免常见陷阱
环境变量隔离失效，往往不是不会设，而是没管住“继承边界”：
-
GUI 应用（如 VS Code、Postman）不自动继承终端的 env：需从终端启动，例如
code .或open -a "Postman"，否则它读的是登录会话的初始环境 -
子进程不自动继承未 export 的变量：写成
MY_VAR=value不够，必须export MY_VAR=value -
后台服务（如 launchd plist）需显式定义环境：在
ProgramArguments前加EnvironmentVariables字典，不能依赖用户 shell 配置 -
不要在 ~/.zshrc 里写敏感值：API 密钥、数据库密码等应存于密钥链（
security find-generic-password）或独立加密文件，运行时读取
