autofilename仅支持以.或..开头的相对路径补全,基准目录为当前文件所在目录;/开头的绝对路径、file://、c:\等均被跳过,非配置问题而是功能边界。

AutoFileName根本不支持绝对路径补全
它只做相对路径补全,且基准目录永远是当前文件所在目录,不是项目根、不是系统根、也不是file://或/Users/xxx/开头的绝对路径。你输src="/assets/或url(/css/,插件直接无视——它不识别斜杠开头的写法,也不读取系统文件树根目录。
常见错误现象:src="/images/logo.png"光标卡在引号里按Ctrl+Space没反应;状态栏不显示AutoFileName: enabled;控制台也无报错。
原因很直接:插件设计上就只响应「以.或..开头的相对路径」上下文,所有绝对路径语义(/开头、file://、C:\)都被跳过。这不是配置问题,是功能边界。
想补全src="/assets/这类路径?得换思路
Sublime 原生不提供绝对路径自动补全能力,LSP、Emmet、snippets 全都不行——它们不访问磁盘,只做文本匹配或语言分析。
可行方案只有两个:
- 用 Webpack/Vite 别名 +
auto_filename_alias_map模拟“逻辑上的绝对路径”:比如配"@": "src",然后写import "@/components/Button.vue",插件就能从src/开始补全 - 手动把项目根加进
auto_complete_project_path,再配合./前缀:在项目根目录放一个空的.project文件(部分 fork 支持),并在用户设置中启用"auto_complete_project_path": true,之后写src="./assets/就能从项目根扫起
注意:auto_complete_project_path不是让你输/Users/me/project,而是让插件把项目根当作.来用。它依然不认/开头的路径字符串。
为什么src="assets/能补全,但src="/assets/不能?
触发机制依赖语法前缀 + 引号内 + 相对路径语义三者同时成立:
-
src="assets/✅:有src="前缀、光标在双引号内、assets/是相对路径 -
src="/assets/❌:前缀和引号都对,但/assets/被解析为绝对路径,插件主动跳过 -
url(assets/✅:url(是白名单前缀,且没引号也触发(CSS 中常见) -
url(/assets/❌:同上,/开头直接不进扫描逻辑
这个判断发生在插件底层,不依赖用户设置,也无法通过改characters或selector绕过。它硬编码了路径合法性校验。
真正要补图像绝对路径,建议放弃自动补全
图像引用走绝对路径,通常意味着你已用构建工具(Webpack、Vite、Next.js)做了静态资源托管,这时路径实际由运行时解析,不是编译时决定的。硬让编辑器补全/images/反而容易误导——本地开发可能 404,CI 构建路径又不同。
更稳的做法是:
- 统一用别名(如
@/assets/)并配auto_filename_alias_map - 图像路径写成变量或常量,由 JS 模块管理,交给 LSP 做符号跳转而非路径补全
- 如果必须用
/assets/,就靠文件树侧边栏拖拽,或用Ctrl+P快速打开文件后复制路径
最后提醒:别在未保存的文件里试,别在Plain Text语法下试,也别指望console.log("/assets/")这种上下文能触发——它只认src=、href=、url(、import这些明确的资源加载场景。











