AutoFileName 插件能安装,但必须通过 Package Control;手动放置无效,因其依赖 os.path 和 Sublime API,未走标准加载流程会静默失败。

AutoFileName 插件在 Sublime Text 里到底装不装得上?
装得上,但必须用 Package Control 安装,手动放文件夹基本无效——因为 AutoFileName 依赖 Python 模块 os.path 和 Sublime 的 API 调用,没走标准插件加载流程会直接静默失败。
常见错误现象:Ctrl+Space 没反应、输入 " 或 ' 后无路径提示、状态栏不显示 “AutoFileName: enabled”。
- 确认已安装
Package Control(没装就先按Ctrl+Shift+P→ 输入Install Package Control回车) - 再按
Ctrl+Shift+P→ 输入Package Control: Install Package→ 等列表加载完,搜AutoFileName并回车 - 装完不用重启,但需打开一个真实存在的项目文件夹(
Project → Add Folder to Project),否则路径补全无根目录可查
为什么写了 src/ 却不提示子目录?
AutoFileName 默认只对特定语法高亮的文件生效:比如 HTML、CSS、JavaScript、Vue、React JSX,而纯文本或未识别的 .js 文件可能被当成 Plain Text,直接跳过补全逻辑。
- 检查右下角语法标识,如果不是目标语言,手动点它 → 选对应语法(如
HTML) - 确保路径写在字符串内,且引号是英文单/双引号;中文引号、反引号、模板字符串(
`)目前不支持 - 路径开头不能是变量或表达式,例如
require(${path})或url(${img})不触发,只认字面量字符串如require("./utils/")
settings 里哪些配置真有用?
默认配置够用,但两个键值影响最直接:一个是是否启用,另一个是是否递归扫描——很多人开了插件却没效果,其实是被 "enabled": false 锁死了。
- 打开
Preferences → Package Settings → AutoFileName → Settings – User - 至少保留这两项:
{"enabled": true, "auto_popup": true} - 如果项目超大(>10k 文件),建议关掉
"recursive": true,否则首次输入时卡顿明显;小项目可开,能补全深层嵌套路径 - 别乱加
"extensions",除非你明确知道要扩展哪些后缀,否则反而可能屏蔽默认支持的.html或.css
路径提示出来了,但点回车却插入了错误斜杠?
Windows 下经常出现 src\img\logo.png 被补全成带反斜杠的路径,但前端代码里必须用正斜杠。这不是 bug,是 AutoFileName 尊重系统路径分隔符的结果。
- 解决方法:在
Settings – User里加"use_forward_slash": true
- 这个选项只影响补全行为,不影响已存在路径的显示或编辑
- 注意:某些构建工具(如 Webpack 的
resolve.alias)对路径分隔符敏感,统一用正斜杠更安全
folder_exclude_patterns 把关键目录给过滤掉了。










