AutoFileName 插件在 Sublime Text 4 中不兼容,需改用官方维护的 auto_file_name 分支;ST4 用户应通过 Package Control 安装 auto_file_name 并保存文件后验证路径补全功能。

AutoFileName 插件在 Sublime Text 4 中已不兼容
Sublime Text 4 默认不再支持原版 AutoFileName(即 GitHub 上 hbakhtiyor/AutoFileName 的那个),安装后无法触发路径补全,控制台报错 AttributeError: 'NoneType' object has no attribute 'view' 或直接无响应。这不是你配置错了,是插件本身未适配 ST4 的 API 变更。
用 Package Control 安装前先确认 Sublime 版本
打开 Sublime Text,按 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS),输入 Help: About 查看版本号。若显示 Build 41xx,即为 ST4 —— 此时请跳过原 AutoFileName,改用替代方案。
- ST3(Build 3xxx):仍可正常安装原版
AutoFileName - ST4(Build 41xx+):必须使用
AutoFileName-ST4分支或更现代的替代品
ST4 用户推荐安装 auto_file_name(官方维护分支)
社区已将原项目迁移并适配 ST4,新仓库名为 auto_file_name,由原作者授权维护。它修复了路径监听、相对路径解析和多光标支持问题。
安装步骤:
- 确保已安装
Package Control(若未安装,访问 https://www.php.cn/link/befa130dcb31961fa251d61e1e6ba0e1 手动安装) - 按
Ctrl+Shift+P→ 输入Package Control: Install Package→ 回车 - 在弹出框中输入
auto_file_name(注意下划线,不是AutoFileName)→ 选择并回车 - 重启 Sublime(必要步骤,否则补全不生效)
验证是否生效:新建一个 HTML 文件,输入 后立即出现当前目录文件列表;输入
../ 会自动切换到上级目录。
常见失效原因与调试建议
即使装对了插件,也可能因以下原因不提示路径:
-
auto_file_name默认只在HTML、CSS、JS、PHP等语言语法下激活,若你在纯文本(Plain Text)或自定义语法中编辑,需手动启用:右键 →AutoFileName: Enable in current syntax - 路径补全默认不包含隐藏文件(以
.开头),如需显示,在Preferences → Package Settings → auto_file_name → Settings中添加:{ "show_hidden_files": true } - 如果输入
./没反应,检查是否在保存前的临时文件中操作 ——auto_file_name需要文件已保存并有实际磁盘路径才能读取目录结构
最常被忽略的一点:插件不会在未保存的 untitled 文件中工作,哪怕你只是新建了一个文件,也得先 Ctrl+S 保存到某个文件夹里,路径补全才会真正活起来。










