能用,但需安装社区维护分支AutoFileName_ST4。原版已停更且不兼容ST4的API与签名要求,手动安装时须将auto_file_name.py放入Packages/AutoFileName/目录并重启;补全仅在引号内、有路径前缀时触发,且基于当前文件目录计算,需检查快捷键冲突及忽略目录配置。

AutoFileName 插件在 Sublime Text 4 上还能用吗?
不能直接用。原版 AutoFileName 已停止维护,Sublime Text 4 默认禁用不签名插件,且其 Python API(从 3.x 升级到 4.x)导致老版本插件加载失败,常见现象是安装后无反应、右键菜单没“AutoFileName”选项、Ctrl+Space 不触发路径补全。
真正能用的是社区维护的分支:AutoFileName_ST4,它适配了 Sublime Text 4 的 plugin_host 架构和新 API。
怎么装 AutoFileName_ST4(非 Package Control 方式)
Package Control 里搜不到这个分支,必须手动安装。核心是把代码放对位置、改对文件名、重启插件宿主。
- 打开 Sublime Text →
Preferences→Browse Packages…,进入用户包目录(通常是~/Library/Application Support/Sublime Text 3/Packages或%APPDATA%\Sublime Text 3\Packages;ST4 实际仍沿用该路径) - 在该目录下新建文件夹,命名为
AutoFileName(注意:不是AutoFileName_ST4,插件加载器只认这个名) - 去 GitHub 下载最新 release:访问
https://github.com/BoundInCode/AutoFileName_ST4/releases,下载auto_file_name.py文件 - 把
auto_file_name.py放进刚才建的AutoFileName文件夹里,确保路径是Packages/AutoFileName/auto_file_name.py - 重启 Sublime Text(或执行
View → Show Console后输入sublime_plugin.reload_plugin("AutoFileName.auto_file_name")手动重载)
路径补全不生效?检查这三件事
装完不代表立刻好用,常见卡点都在配置和上下文上:
- 只在字符串内触发:光标必须在一对引号中间(
"或'),且前面有明显路径特征,比如require('./、import from '../、src="img/;纯文本或注释里不会启动 - 相对路径起点依赖当前文件位置:补全是基于当前编辑文件的所在目录计算的,不是项目根目录。如果想从项目根开始补,需在项目里添加
.project或启用auto_complete_project_path设置(但该设置仅部分 fork 支持) - 被其他插件拦截:像
Emmet或All Autocomplete可能抢走Ctrl+Space快捷键。临时禁用它们测试,或在Preferences → Key Bindings中确认auto_complete命令绑定未被覆盖
为什么不用替代方案(如 SideBarEnhancements + 自定义 snippet)?
因为那些方案不解决「实时上下文感知补全」这个核心需求。SideBarEnhancements 只能右键复制路径,不能在写 import 时动态提示 utils/ 下有哪些 .ts 文件;snippet 是静态模板,无法根据当前目录结构自动更新候选列表。
真正省时间的地方在于:你在 components/ 里写 import Header from '../layout/,敲 l 就弹出 layout/ 下所有子目录和文件——这个行为只有 AutoFileName 类插件能稳定做到,而且响应快、不卡 UI。
别漏掉一点:它默认忽略 node_modules 和 .git,但如果你项目里有自定义忽略目录(比如 dist/),得手动加进 excluded_directories 设置里,否则补全列表会混进一堆构建产物。










