autofilename在sublime text 4上默认不工作,必须手动安装zhenkyle或boundincode适配分支,严格满足路径、文件夹名(autofilename)、主文件位置(auto_file_name.py)三要素,并确保光标在未闭合引号内、有路径语义前缀、语法正确识别且文件已保存。

AutoFileName在Sublime Text 4上根本不会自动工作
装完没反应、Ctrl+Space不弹路径、状态栏不显示AutoFileName: enabled——不是你配错了,是原版插件压根没加载。Package Control里搜到的AutoFileName仍是ST3旧版,Python 2代码(含urllib2)在ST4(Python 3.8+)中静默失败,控制台甚至不报错。
必须手动安装适配分支,且三要素缺一不可
zhenkyle/AutoFileName和BoundInCode/AutoFileName_ST4是目前两个能用的分支,都不上架Package Control,搜不到是正常的。手动安装只认三件事:
- 打开
Preferences → Browse Packages…,记下路径(如~/Library/Application Support/Sublime Text/Packages) - 在该目录下新建文件夹,严格命名为
AutoFileName(不能是autofilename、AutoFileName_ST4或带版本号) - 去对应GitHub Releases下载最新
auto_file_name.py,放进Packages/AutoFileName/,确保最终路径是Packages/AutoFileName/auto_file_name.py
重启Sublime,或在控制台执行sublime_plugin.reload_plugin("AutoFileName.auto_file_name")。
补全不触发?检查这四个硬条件
AutoFileName不是字符串补全工具,它只响应「明确路径语义 + 正确语法上下文」,缺一不可:
- 光标必须在未闭合的英文单引号或双引号内:
src="|"✅,src=|❌,src="logo.png"|❌(引号已闭合),src=`|`❌(模板字符串不支持) - 前面必须有路径语义前缀:
src="、href="、url(、import "、require('✅;console.log("、class="❌ - 当前文件语法必须被识别为支持类型:右下角显示
CSS、HTML、JavaScript等,不能是Plain Text;Vue文件中<style></style>块需验证scope含source.css(用Tools → Developer → Show Scope Name) - 文件必须已保存(未保存的临时文件不触发)
CSS和图片路径补全要额外开开关
默认情况下,AutoFileName只对JS中的import/require生效,url()和@import在CSS/SCSS中是关闭的:
- 打开
Preferences → Package Settings → AutoFileName → Settings – User - 添加并保存以下配置:
{
"enabled": true,
"auto_popup": true,
"use_forward_slash": true,
"extensions": ["js", "jsx", "ts", "tsx", "html", "htm", "css", "scss", "sass", "less"]
}
保存后必须完全退出Sublime(不是关窗口),再重开,否则新配置不加载。如果项目用了Webpack别名(如@/assets/),还得在.sublime-project里加"auto_filename_path_aliases": { "@": "src" },否则@会被当普通字符处理。
最常被忽略的是:补全基准路径是当前文件所在目录,不是项目根目录。比如src/pages/Home.vue里写url(,它只扫src/pages/下的文件,不会列出src/assets/里的图片——得先输../assets/才能进去。想从项目根开始补全,得加"auto_complete_project_path": true,但这个选项只在zhenkyle分支里有效。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











