sublime如何配置AutoFileName插件_Sublime自动补全路径【实战】

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 是以真实路径打开项目，否则插件无法解析链接目标

AutoFileName 的行为高度依赖上下文识别和配置收敛，不是装上就“全自动”。最容易被忽略的是别名映射和作用域匹配——很多问题其实不是插件坏了，而是它根本没意识到你正在写一个“路径”。