AutoFileName插件需通过Package Control正确安装并手动启用,仅在HTML/CSS/JS等特定语法的路径属性中生效,支持别名映射和深度限制配置。

AutoFileName 插件安装后不生效?检查 Package Control 和插件状态
AutoFileName 不是 Sublime 原生功能,必须通过 Package Control 正确安装并启用。常见现象是安装完重启 Sublime 后,img/src/ 这类路径输入仍无补全提示——大概率是插件没真正激活。
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS),输入Package Control: List Packages,确认列表中存在AutoFileName - 若不存在,先运行
Package Control: Install Package,再搜AutoFileName安装 - 安装后不要只靠重启:手动执行一次
Package Control: Enable Package→ 选AutoFileName,避免被意外禁用
路径补全只在特定语法下触发?确认当前文件类型和作用域
AutoFileName 默认只在 HTML、CSS、SCSS、Less、JavaScript(含 JSX)、Vue、Svelte 等支持路径属性的语法中工作。它不是全局字符串补全工具,而是基于「属性名 + 引号内路径」的上下文识别。
- 在
.js文件中写require('./')或import './'会触发;但写const p = './'不会 - HTML 中只有
src、href、data-src等预设属性才响应,class="foo"里的字符串不会补全 - 可通过
Ctrl+Shift+P→Developer: Show Scope Name查看当前光标处的作用域,确保是string.quoted.double.html或类似路径相关 scope
想补全 node_modules 或别名路径?需要手动配置 auto_filename_exclude_patterns 和 auto_filename_include_patterns
默认情况下,AutoFileName 会跳过 node_modules、.git、dist 等目录。但如果你用 Webpack/Vite 别名(如 @/components/),就得告诉插件哪些“虚拟路径”要映射到实际目录。
- 打开
Preferences → Package Settings → AutoFileName → Settings - 在用户设置中添加:
{ "auto_filename_exclude_patterns": ["\\.git", "dist", "build"], "auto_filename_include_patterns": ["src/**", "public/**", "node_modules/.vite/deps/**"], "auto_filename_alias_map": { "@": "src", "#": "src/utils" } } -
auto_filename_alias_map是关键:它让插件把@/Button.vue解析为相对于src/的真实路径,否则只会当普通字符串处理
补全卡顿或路径不全?关掉实时扫描或限制深度
项目大时(尤其含大量 node_modules 或嵌套很深的 assets),AutoFileName 默认递归扫描可能拖慢响应,甚至漏掉深层子目录。
- 在插件设置中加
"auto_filename_max_depth": 4,限制最多扫描 4 层子目录 - 关闭实时监听(减少资源占用):
"auto_filename_watch_files": false,改为仅在输入引号时按需扫描 - 如果用的是符号链接(symlink)路径,确保 Sublime 是以真实路径打开项目,否则插件无法解析链接目标










