Sublime Text 通过拖拽文件夹到主窗口或使用 File → Open Folder… 可将整个目录作为项目加载，侧边栏显示完整目录树；需避免误用 Open… 或双击 .sublime-project 文件。
Sublime Text 怎么把整个文件夹当项目打开
直接拖拽文件夹到 Sublime Text 窗口里，或者用 File → Open Folder…，就能把整个目录作为项目加载——不是打开单个文件，而是让侧边栏显示完整目录树，支持快速跳转、全局搜索、保存工作区。
常见错误是双击打开某个 .sublime-project 文件，结果只加载了配置没加载路径；或者用 File → Open…（不是 Open Folder…）选中文件夹，Sublime 会把它当普通文件读，报错 Unable to open /path/to/folder。
- macOS 下拖拽必须拖到 Sublime 的主窗口区域，不能拖到 Dock 图标（那会重启应用）
- Windows/Linux 拖拽时如果 Sublime 已有未保存的无名标签页，可能卡住不动，先关掉再试
-
Open Folder…后，当前窗口标题栏会立刻显示文件夹名，这是判断是否成功的最快方式
怎么保存当前文件夹结构为可复用的项目
Sublime 不自动保存“打开了哪些文件夹”，每次重启默认清空侧边栏。要持久化，必须手动创建 .sublime-project 文件。
最简方式：点 Project → Save Project As…，存为 xxx.sublime-project（建议放在项目根目录下）。它本质是 JSON，内容至少包含 "folders": [{"path": "."}]。
- 如果项目含多个根目录（比如前端+后端两个文件夹），
folders数组里填多个{"path": "/full/or/relative/path"} - 相对路径（如
"."）只在项目文件和根目录同级时有效；跨机器共享时，优先用绝对路径或确保团队统一工作目录结构 - 别手写
.sublime-project却漏掉逗号或引号——JSON 格式错误会导致整个项目加载失败，且无明确报错提示
为什么改了 .sublime-project 但侧边栏没更新
Sublime 不监听项目文件变更，修改后必须重新加载：关闭当前项目（Project → Close Project），再用 Project → Open Project… 选回那个 .sublime-project 文件。
容易忽略的是：如果当前已有未关闭的文件标签页，即使关闭了项目，这些标签页仍挂着旧路径的引用，导致 Ctrl+P 模糊搜索还能搜到已移出项目外的文件。
- 真正干净的重载流程：先
Close Project，再确认所有标签页已关闭（或手动关掉），最后Open Project… - 如果只是想刷新文件列表（比如 Git 切分支后多了新目录），不用动项目文件，直接右键侧边栏 →
Refresh Folders - 某些插件（如
SideBarEnhancements）会缓存路径，刷新后仍异常，可尝试禁用插件再测试
项目里怎么设置语言模式、缩进、构建系统等专属配置
这些都写在 .sublime-project 的 "settings" 和 "build_systems" 字段里，作用域比用户/语法级配置更高，且只对本项目生效。
例如：前端项目需要 JS 文件默认用 JavaScript (Babel) 语法高亮，就在项目文件里加：
{
"folders": [{"path": "."}],
"settings": {
"tab_size": 2,
"translate_tabs_to_spaces": true
},
"syntax_override": {
"Packages/JavaScript/JavaScript.sublime-syntax": ["js", "jsx"]
}
}
-
syntax_override不是标准字段，需配合插件（如ApplySyntax）才生效；原生只支持"settings"和"build_systems" - 构建系统（
build_systems）路径必须写全，比如"file": "Packages/User/MyBuild.sublime-build"，相对路径不被识别 - 项目级设置不会覆盖全局快捷键，想绑定项目专用快捷键？得去
Preferences → Key Bindings – Project单独配
项目配置真正的复杂点不在写法，而在层级叠加：用户设置 ← 语法设置 ← 项目设置 ← 文件内注释设置。调一个缩进，可能要查四层来源。动手前，先按 Cmd+Shift+P（或 Ctrl+Shift+P）输 Settings: Show Project Settings，看当前生效的是哪一叠。
