autofilename在st4需手动安装适配分支并正确配置上下文才生效，否则路径补全不触发；它仅在引号内且有路径语义前缀时工作，基准路径为当前文件目录，且易受插件冲突或未保存文件影响。
AutoFileName 路径补全在 Sublime Text 4 上默认不工作，必须手动安装适配分支 + 正确配置上下文，否则 Ctrl+Space 或引号内敲 Tab 都不会弹出路径建议。
为什么装了 AutoFileName 却没反应？
Package Control 里搜到的 AutoFileName 是 ST3 旧版，与 ST4 不兼容——它加载失败但不报错，状态栏也不会显示 AutoFileName: enabled。你看到插件出现在 Preferences → Package Settings 里，不代表它真在运行。
必须用 GitHub 上维护活跃的 fork：
- 推荐 zhenkyle/AutoFileName（最新 release 支持 ST4，且修复了深度扫描卡顿问题）
- 或 BoundInCode/AutoFileName_ST4（轻量，但需手动重载插件）
别从 Package Control 直接安装；下载 zip 后解压，把文件夹重命名为 AutoFileName，再拖进 Packages/ 目录（路径必须是 Packages/AutoFileName/auto_file_name.py）。
路径补全只在特定字符串上下文中触发
AutoFileName 不是全局补全工具，它只监听“明显要写路径”的位置。常见有效触发点包括：
-
src="、href="、url(、require('、import from "等前缀后紧接引号 - 光标必须严格处于一对引号内部（
"或'），且引号未闭合 - 不能在注释、JS 字符串模板（
`）、正则字面量或纯文本中触发
例如：<img src="%7C>%EF%BC%88%7C%20%E6%98%AF%E5%85%89%E6%A0%87%EF%BC%89%E8%83%BD%E8%A7%A6%E5%8F%91%EF%BC%8C%E4%BD%86%20console.log("> 不会——即使内容看起来像路径，AutoFileName 也不处理。
相对路径起点不是项目根目录，而是当前文件所在目录
如果你在 src/pages/Home.js 里写 import Header from '../components/Header.jsx'，AutoFileName 补全时的基准路径是 src/pages/，不是项目根。所以它不会列出 src/assets/ 下的文件，除非你手动输入 ../assets/。
想从项目根开始补全？两个办法：
- 在项目根目录下放一个空的
.project文件（部分 fork 支持识别） - 在
Preferences → Package Settings → AutoFileName → Settings中添加："auto_complete_project_path": true
（注意：仅 zhenkyle 分支等少数版本支持该配置项）
别指望它自动识别 src/ 或 public/ 为“根”——它没有项目结构语义理解能力，纯靠文件系统路径计算。
和其他插件冲突导致快捷键失效
Ctrl+Space 是 Sublime 原生补全快捷键，但很多插件会覆盖它：
- Emmet 默认劫持
Ctrl+Space做 HTML 展开 - All Autocomplete 也注册了同名命令，优先级可能更高
- 甚至 LSP 插件在某些语言模式下会接管补全入口
排查方法：打开控制台（View → Show Console），输入 sublime.log_commands(True)，然后按 Ctrl+Space，看日志里执行的是哪个命令。如果是 auto_complete，说明没被拦截；如果是 emmet_expand_abbreviation，就得去 Key Bindings 里禁用 Emmet 的该绑定。
临时验证是否是插件冲突：禁用所有非必要插件，只留 AutoFileName，再测试。确认后再逐个启用，定位冲突源。
最常被忽略的一点：AutoFileName 不依赖“项目已打开”，但它依赖“当前文件真实存在且路径可读”。如果文件是新建未保存的（untitled:1），或者路径含中文/空格/特殊符号未正确转义，补全也会静默失败——它不会提示错误，只是不出现建议。
