Sublime侧边栏未显示主因是项目上下文未加载或被隐藏;需先按Ctrl+K松开再按Ctrl+B切换显隐,若为空则必须通过Project: Add Folder to Project加载文件夹,避免误用Open Folder重置项目,并检查"project": null等配置错误。

侧边栏没显示?先确认项目上下文是否生效
Sublime 的侧边栏不是文件浏览器,它只响应「已加入项目的目录」。拖一个文件进来、或用 Ctrl+O 打开单个文件,侧边栏默认为空——这不是 bug,是设计逻辑。必须通过 File → Open Folder…(Windows/Linux)或 File → Open… 并选中整个文件夹(macOS)加载根目录。快捷键 Ctrl+K, Ctrl+B 只能切换显隐,不能凭空唤出侧边栏。
常见卡点:
- 用户设置里误写了
"project": null,会清空全部项目上下文 - 便携版执行
subl .失效时,Add Folder to Project也可能不响应,本质是路径注册失败 - 右键菜单没反应?说明该目录没被
Add Folder to Project加入当前项目(直接拖进窗口的独立文件夹不触发增强)
右键新建文件为何点不动?SideBarEnhancements 是刚需
原生 Sublime 侧边栏右键只有 Reveal in Side Bar、Open Containing Folder 等基础项,真没有 New File 或 New Folder 功能。这不是隐藏选项,是压根没实现。
必须装插件:Package Control → Install Package → SideBarEnhancements(注意拼写,不是 SidebarEnhancement 或带下划线)。安装后重启 Sublime,右键任意项目内目录即可看到 New File 和 New Folder。
避坑提示:
- 别手动改
Preferences → Package Settings → SideBarEnhancements → Settings,90% 的自定义配置会导致New File按钮消失 -
SideBarEnhancements和AFileIcon可共存:一个管功能,一个管图标,互不干扰 - 菜单项未加载?检查是否在无项目状态下误开了单个文件(此时插件行为异常)
AdvancedNewFile 快捷键不生效?三处必须排查
Ctrl+Alt+N(Windows/Linux)或 Cmd+Alt+N(macOS)不生效,90% 是卡在这几个环节:
- 插件根本没启用:打开
Preferences → Package Control → List Packages,确认列表里有AdvancedNewFile;没有就删掉Packages/AdvancedNewFile文件夹,再重装 - 快捷键被劫持:进
Preferences → Key Bindings搜advanced_new_file,看是否被注释、是否重复绑定、是否被SideBarEnhancements等插件覆盖 - 菜单项未加载:右键侧边栏任意位置,应出现
AdvancedNewFile: Create File;没有就重启 Sublime,再不行就检查是否在无项目状态下误开了单个文件
输入路径时静默失败?记住三条铁律:
- 一律用正斜杠
/,Windows 用户别手抖打成\—— 输src\utils.js不会建目录,反而生成一个名字含反斜杠的怪文件 - 扩展名必须显式写出:
config→ 创建空文件config(无后缀);config.json→ 正确创建config.json - 路径是相对的:当前打开的是
/project/src/index.js,输api/user.js→ 实际创建在/project/src/api/user.js;想跨到项目根下,得输../config.js或/config.js(后者是系统绝对路径,需权限)
Tab 补全和自动打开怎么配?不是默认行为
AdvancedNewFile 默认不开启路径补全,直接输 src/ 后按 Tab 没反应,是因为还没进 shell 模式:
- 先按一次
Tab,状态栏显示Shell mode: on才算激活 - 这时再输
src/+Tab,它才列出src/下已有的子目录;继续输u+Tab可补全utils/ - 补全只基于当前
project folder中真实存在的路径,不会预测或跳过不存在的中间目录(比如deep/nested/file.js中deep不存在,Tab就不会补)
文件建好了但没自动打开?这不是 bug,是配置控制的:
- 打开
Preferences → Package Settings → AdvancedNewFile → Settings – User - 加一行:
"create_file_on_save": true(默认是false)
真正容易被忽略的是:路径解析对大小写、空格、隐藏文件(如 .env)极其敏感,哪怕多一个空格或错一个字母,就静默失败——它不会报错,也不会弹提示,只会什么也不做。

















