macOS 开发环境与生产环境同步的实现方法

本质是分层管理：代码靠Git，配置靠作用域隔离，运行态靠环境变量注入，工具链靠标准化复现；物理级（专用账户）、会话级（dev_env/prod_env函数）、项目级（.env.*+dotenv）三重隔离确保安全可复现。

在 macos 中实现开发环境与生产环境的同步，本质不是“让两边一模一样”，而是让配置、代码、依赖和运行时行为在各自上下文中准确、安全、可复现地生效。同步的关键是分层管理：代码靠 git，配置靠作用域隔离，运行态靠环境变量注入，工具链靠标准化复现。

用 Git 管理源码与构建产物

所有可版本化的部分必须统一源头，避免手工拷贝或覆盖：

• 开发分支（如 main 或 dev）用于日常提交，含 .env.development、调试脚本、mock 数据等
• 生产分支（如 prod 或打 tag 如 v1.2.0）只合入已测试通过的变更，附带 .env.production 和 vercel.json/nginx.conf 等部署配置
• 构建产物（如 dist/）不进 Git，但可通过 CI/CD 自动构建并上传至对象存储（如 S3、Cloudflare R2），供多台生产服务器拉取

示例：本地改完代码后，执行 git add . && git commit -m "fix: auth timeout" && git push origin main；CI 检测到 prod 分支更新，自动运行 pnpm build 并上传 dist/ 到 CDN。

用环境变量作用域控制运行时行为

变量不能全局乱设，否则开发时误连生产 DB 是高频事故：

• 物理级隔离：为生产新建标准用户（如 produser），其 ~/.zshrc 只写 export NODE_ENV=production DB_HOST=prod-db.internal；GUI 应用（VS Code、Postman）需以该用户登录后启动，才能继承变量
• 会话级切换：日常账户中定义 dev_env / prod_env 函数，新开终端后输入 prod_env 即刻加载生产变量，关窗即失效，适合临时验证
• 项目级绑定：Node.js 项目用 dotenv.config({ path:.env.${process.env.NODE_ENV}})，Python 用 decouple.Config(RepositoryEnv(f'.env.{config("ENV", default="development")}')，确保 npm start 时自动读对文件

用容器或符号链接同步运行依赖与工具链

避免“在我机器上能跑”问题：

• Docker 绑定挂载：开发时 docker run -v $(pwd):/app node:18 sh -c "cd /app && npm install && npm start"，代码改保存即容器内生效；生产部署则用 multi-stage 构建镜像，基础镜像、依赖、代码分层固化
• dotfiles + 软链统一终端环境：把 ~/.zshrc、~/.p10k.zsh 移入 Git 仓库，新设备 git clone && ln -s ~/.dotfiles/zshrc ~/.zshrc && source ~/.zshrc，保证 pnpm、node、git 别名等完全一致
• iTerm2 配置同步：导出 defaults export com.googlecode.iterm2 ~/dotfiles/iterm2.plist，推送到 Git；新设备执行 defaults import com.googlecode.iterm2 ~/dotfiles/iterm2.plist 即还原配色、快捷键、分屏布局

数据库与服务状态不强求“实时同步”，而要“可控迁移”

• 用 Navicat Premium 的「结构同步」对比本地与生产表结构差异，生成可审查的 SQL 脚本，人工确认后再执行
• 敏感数据（如用户表）绝不双向同步；用 pg_dump --schema-only 或 mysqldump -d 同步 DDL，用脱敏脚本生成测试数据集
• API 接口变更走 OpenAPI 3.0 规范，用 Swagger UI 本地预览，CI 中集成 spectral 校验，确保生产文档与代码一致

不复杂但容易忽略。