Sublime原生Switch Project只缓存手动打开过的项目路径，不扫描磁盘；项目移动、重命名或存于临时目录会导致“Unable to open project”错误，且列表不刷新；推荐用ProjectManager插件主动扫描、模糊搜索并自动索引项目文件。
Sublime 原生 Project → Switch Project 为什么总找不到项目
它根本不扫描磁盘，只缓存你“曾经通过 Project → Open Project 打开过的 .sublime-project 文件路径”。一旦项目被移动、重命名或保存在桌面/tmp 下，菜单里依然显示旧条目，点进去就报错：Unable to open project: path does not exist。
常见误操作包括：
- 直接拖拽文件夹进窗口，再点
Save Project As…—— 此时"folders"是空数组，项目文件无效 - 保存项目时用了相对路径（如
"path": "src"），换机器或重装 Sublime 就失效 - 没先执行
File → Open Folder…，就急着Save Project As…，结果生成的文件不包含任何文件夹 - 保存后没重启 Sublime，也没手动触发
Project → Refresh Folders，导致新项目不进列表
用 ProjectManager 插件替代原生切换功能
这是目前唯一能稳定索引、搜索、自动刷新路径的方案。它不依赖菜单历史，而是主动扫描指定目录（默认 Packages/User/Projects/）下的所有 .sublime-project 文件。
安装和启用的关键动作必须做全：
- 用
Package Control: Install Package安装ProjectManager，别手动解压 .zip - 首次保存项目必须用命令面板执行
Project Manager: Save Project，不是原生的Save Project As… - 已有项目文件在源码目录下（如
myapp/myapp.sublime-project），需先运行Project Manager: Refresh Projects，再右键 →Import Project指向它
之后就能用 Ctrl+Shift+P → 输入 Project Manager: Quick Switch Project（默认快捷键 Ctrl+Alt+P）调出模糊搜索面板，支持中文关键词、路径匹配、最近使用排序。
一个 .sublime-project 文件里怎么加多个不相关目录
比如要同时编辑 frontend/ 和 backend/，不能只打开根目录——得把它们作为独立条目塞进 "folders" 数组。
操作流程很明确：
- 先用
Project → Add Folder to Project…或右键侧边栏空白处添加第一个目录 - 重复添加第二个、第三个……每个都会在
"folders"中生成一个对象 - 每个对象可单独配置，例如：
{"path": "frontend", "name": "前端", "folder_exclude_patterns": ["node_modules"]} - 添加完必须再执行一次
Project → Save Project（注意不是Save Project As…），否则改动不会写入磁盘
别在 "folders" 里写空 "path" 或错字段名（如 "dir"），Sublime 会直接跳过整条记录。
项目级设置（settings）为什么改了不生效
项目设置优先级确实高于用户设置，但生效条件极其严格：必须放在 "settings" 字段内，且键名必须和 Preferences → Settings 中完全一致。
典型错误写法：
- 把
"tab_size": 2写在顶层，或塞进"build_systems"里 - 拼错键名，比如写成
"tabSize"（正确是"tab_size"）、"fontsize"（正确是"font_size"） - 把配置写在
"folders"外层，但不在"settings"对象里
正确结构示例：
{
"folders": [
{"path": "."}
],
"settings": {
"tab_size": 2,
"translate_tabs_to_spaces": true,
"terminal": {
"working_dir": "$project_path"
}
}
}
"settings" 不继承用户设置里的注释或空行，保存后 Sublime 会自动格式化 JSON；终端插件默认工作目录是当前文件路径，不是项目根，想让它进根目录，就得靠上面这种 "working_dir": "$project_path" 配置（前提是插件支持变量）。
真正容易被忽略的是：.sublime-workspace 文件只记录个人状态（光标位置、标签页、分屏），不该提交到 Git；而 .sublime-project 是项目配置核心，必须随代码一起维护，但路径尽量用 "path": "."，避免硬编码绝对路径。
