Projects 是开发上下文定义（JSON配置），Workspace 是运行时状态快照；前者应提交Git，后者须加入.gitignore。

Projects 和 Workspaces 到底有什么区别？

Sublime Text 的 Project 是一个包含文件路径、构建系统、设置覆盖等的 JSON 配置，本质是「开发上下文定义」；而 Workspace 是运行时状态快照——比如哪些文件已打开、光标位置、折叠状态、面板尺寸等。你编辑的是 .sublime-project，但每次保存项目时 Sublime 会自动生成对应的 .sublime-workspace（通常不提交到版本控制）。

常见错误：把 .sublime-workspace 提交进 Git，导致团队成员打开项目时强行同步别人的窗口布局和未保存的临时状态。

• .sublime-project 应该加入 Git，它是环境可复现的关键
• .sublime-workspace 必须加进 .gitignore
• 修改项目设置优先改 .sublime-project，而不是通过 Preferences → Settings – Project 写死在 UI 里（后者实际也写入该项目文件，但容易误操作）

如何为不同环境（如 dev/staging/prod）配置独立的构建系统？

Sublime 不支持开箱即用的「环境变量切换」，但可以通过 build_systems + variants 组合实现一键切换。关键是把环境逻辑下沉到构建脚本本身（如 shell 脚本或 Makefile），再让 Sublime 调用不同参数。

示例：一个 Python 项目需分别运行 dev-server 和 prod-build

{
  "folders":
  [
    {
      "path": "."
    }
  ],
  "build_systems":
  [
    {
      "name": "Run Dev Server",
      "cmd": ["python", "-m", "http.server", "8000"],
      "working_dir": "$project_path",
      "shell": true
    },
    {
      "name": "Build for Production",
      "cmd": ["npm", "run", "build"],
      "working_dir": "$project_path",
      "shell": true,
      "variants":
      [
        {
          "name": "Watch",
          "cmd": ["npm", "run", "build:watch"]
        }
      ]
    }
  ]
}

• 不要在 cmd 中硬编码 export NODE_ENV=production —— shell 环境隔离不可靠，改用 env 字段显式声明
• 如果依赖本地二进制（如 phpstan），确保 path 设置正确，或改用绝对路径调用
• Windows 用户注意：shell 设为 true 时，cmd 数组会被拼成一条命令，空格和引号要手动处理

多个项目共享同一份代码但需要不同设置（如前端多租户）怎么管理？

典型场景：一个 monorepo 里有 client-a 和 client-b 两个子目录，它们共用大部分代码，但 lint 规则、ESLint 配置、甚至 JS 编译目标都不同。

解决方案不是建两个独立项目，而是用 folders + settings 覆盖：

{
  "folders":
  [
    {
      "path": "client-a",
      "folder_exclude_patterns": [".git", "node_modules"],
      "settings": {
        "eslint_options": {"env": {"browser": true, "es6": true}},
        "js_eslint_config_path": "./client-a/.eslintrc.js"
      }
    },
    {
      "path": "client-b",
      "folder_exclude_patterns": [".git", "node_modules"],
      "settings": {
        "eslint_options": {"env": {"node": true, "es6": true}},
        "js_eslint_config_path": "./client-b/.eslintrc.js"
      }
    }
  ]
}

• settings 支持按文件夹粒度覆盖，比全局设置更精准
• 避免在 folders 中混用相对路径和绝对路径，否则跨机器打开时可能失效
• 如果某个子项目需要禁用特定插件（如禁用 GitGutter 对 client-b 的监听），可在其 settings 中设 "git_gutter": false

Workspaces 无法自动恢复上次会话？检查这三点

很多人以为关掉窗口后重开就能还原所有标签页，结果只看到空白窗口。这不是 bug，而是 Sublime 的会话恢复机制默认关闭，且受多个开关影响。

• 确认 hot_exit 为 true（默认值），它控制退出时是否保留未保存的修改状态
• 确认 remember_open_files 为 true（默认值），否则不会记住已打开的文件列表
• 最关键：关闭 Sublime 前必须是「关闭窗口」而非「退出应用」——macOS 上 Cmd+Q 是退出，Cmd+W 是关窗；Windows 上 Alt+F4 是关窗，但任务栏右键退出是退出应用

如果你用的是 Sublime Merge 或其他工具联动，还要检查 restore_open_files 是否被插件覆盖。最稳妥的方式是定期手动执行 Project → Save Project As…，强制刷新 .sublime-workspace 文件。