sublime text 4 必须安装适配 python 3 和新 api 的 autofilename_st4 分支（手动放入 packages/autofilename/ 并重命名为 auto_file_name.py），否则原版静默失效；补全需满足：光标在未闭合英文引号内、文件语法正确识别、用户设置中启用 "enabled": true 和 "auto_popup": true。
Sublime Text 4 上的路径自动补全，必须用适配 Python 3 和新 API 的社区分支，原版 AutoFileName 直接加载失败，连错误都不报——它被 Sublime 静默忽略，状态栏也不会显示 AutoFileName: enabled。
怎么装 AutoFileName_ST4（手动方式最可靠）
Package Control 里搜不到 AutoFileName_ST4，也不能靠“拖文件夹”蒙混过关。它依赖正确路径、正确文件名、正确 Python 模块加载顺序。
- 打开
Preferences → Browse Packages…，记下弹出目录路径（通常是~/Library/Application Support/Sublime Text/Packages或%APPDATA%\Sublime Text\Packages） - 在该目录下新建文件夹，**严格命名为
AutoFileName**（不是AutoFileName_ST4，也不是autofilename） - 去 GitHub Releases 页面 下载最新版
auto_file_name.py - 把
auto_file_name.py放进Packages/AutoFileName/，确保最终路径是Packages/AutoFileName/auto_file_name.py - 重启 Sublime Text，或在 Console（
View → Show Console）中执行：sublime_plugin.reload_plugin("AutoFileName.auto_file_name")
为什么写了 src=" 却没补全？检查这三处
插件装对了，不代表能立刻用。90% 的“不生效”卡在这三个地方：
- 光标必须在**未闭合的英文引号内**：
src="|✅，src=|❌，src="img/logo.png"（已写完）也不触发 - 当前文件语法必须识别为支持路径的类型：右下角显示
CSS，不是Plain Text；Vue 文件里<style></style>块需有source.cssscope（可用Tools → Developer → Show Scope Name验证） - 确认配置没关掉核心开关：
"enabled": true和"auto_popup": true必须在Preferences → Package Settings → AutoFileName → Settings – User中显式存在
补全慢、卡顿、子目录不显示？调 excluded_folders 和 recursive
默认行为是递归扫描当前文件所在目录全部子目录，遇到 node_modules 或 .git 就容易卡住甚至漏结果。
- 在用户设置中加这一段，能立刻缓解：
"excluded_folders": ["node_modules", ".git", "dist", "build"] - 大项目建议关掉深度扫描：
"recursive": false（只扫当前层和一级子目录），小项目可开，但别在根目录下开，否则首次输入等太久 - 如果用了 Webpack/Vite 别名（如
@/components/），必须配"auto_filename_alias_map": { "@": "src" }，否则插件当普通字符串处理，不会映射路径
url( 后不弹？不是 bug，是设计逻辑
AutoFileName 只监听带明确路径语义的上下文，比如 require('./、import from "../、src="、href="、url("，但它**不解析 CSS 函数体内的括号结构**。
- 在 CSS 里写
background: url(，光标得在双引号内才触发：url("|)✅，url(|)❌ - 不能指望它在
background-image: linear-gradient(...)里补路径，那不是它的职责范围 - 别用中文引号、反引号（
`）或模板字符串（`url(${x})`），它只认"和'包裹的字面量
最容易被忽略的是：它永远以当前编辑文件的目录为基准路径，不是项目根目录。想从根开始补，要么手动输 ../ 回溯，要么启用 "auto_complete_project_path": true（仅部分 fork 支持，且需项目已通过 Project → Add Folder to Project 加载）。别把它当成 IDE 的智能导入，它只是个专注路径的轻量扫描器。
