应安装 zhenkyle/autofilename 或 boundincode/autofilename_st4 分支：前者功能全，支持项目根路径补全与别名映射；后者轻量，仅修复 st4 兼容性问题。
不能直接用 Package Control 搜 AutoFileName 安装——它推的是已停更的 ST3 旧版，Python 2 代码在 Sublime Text 4（Python 3.8+）里根本跑不起来，控制台会静默失败或报 ImportError: No module named 'urllib2'、AttributeError: 'NoneType' object has no attribute 'groups'。必须换社区适配分支。
该装哪个分支？认准 zhenkyle/AutoFileName 或 BoundInCode/AutoFileName_ST4
两个主流兼容分支都可用，但定位略有不同：
-
zhenkyle/AutoFileName：功能更全，支持auto_complete_project_path（可从项目根补全）、别名映射（@/components）、用户自定义extensions；推荐多数前端项目使用 -
BoundInCode/AutoFileName_ST4：更轻量，只修复核心 API 兼容问题，不带额外配置项；适合只想快速启用基础路径补全的用户 - 二者都不上架 Package Control，搜不到是正常的——这不是你网络问题，是官方没收录
手动安装必须做对三件事：位置、文件夹名、重启方式
装错任意一项，插件就静默失效，连控制台都不报错：
- 先卸载旧版：按
Ctrl+Shift+P→ 输入Package Control: Remove Package→ 选中并删掉已存在的AutoFileName - 去对应 GitHub release 页面下载最新
.zip（如 zhenkyle/AutoFileName/releases），解压后得到一个叫AutoFileName的文件夹（不是zhenkyle-AutoFileName-xxx） - 打开
Preferences → Browse Packages…，把解压好的AutoFileName文件夹整个拖进弹出目录（路径形如~/Library/Application Support/Sublime Text/Packages/） - 重启 Sublime Text；或者更稳妥地，按
Ctrl+`打开控制台，输入sublime_plugin.reload_plugin("AutoFileName.auto_file_name")手动重载
补全不触发？先检查这四个上下文硬条件
AutoFileName 不是字符串补全工具，它只响应「明确路径语义 + 正确语法上下文」：
- 光标必须在英文单引号或双引号内：
src="|"✅，src=|❌，src=`|`❌（模板字符串不支持） - 前面要有路径特征前缀：
src="、href="、url(、require('、import "✅；console.log("、class="❌ - 当前文件语法高亮必须匹配：右下角显示
CSS、HTML、JavaScript等，不能是Plain Text；Vue 的<style></style>块需被识别为source.css（可用Ctrl+Shift+P → Developer: Show Scope Name验证） - 基准路径 = 当前文件所在目录，不是项目根目录；想从项目根开始补全，得在用户设置里加
"auto_complete_project_path": true（仅zhenkyle分支支持）
补全卡顿、子目录不显示？默认扫描太宽，必须主动排除
插件默认递归扫描当前文件目录所有子目录，遇到 node_modules、dist 这类大目录就会卡住甚至超时返回空结果：
- 打开
Preferences → Package Settings → AutoFileName → Settings – User - 至少加这两项：
"exclude_folders": ["node_modules", "dist", ".git", "build"]和"use_forward_slash": true（避免 Windows 反斜杠写入） - 如果项目结构深但文件不多，可关掉递归：
"recursive": false；反之小项目可保留true补全深层嵌套路径 - 别乱加
"extensions"，除非你明确知道要扩展 JS/TS 支持——默认已覆盖html、css、js等，加错反而屏蔽默认行为
最易忽略的一点：插件加载成功后，状态栏不会显示任何提示，也不会弹 toast；唯一可靠验证方式是打开一个真实项目（Project → Add Folder to Project），在 index.html 里输入 src=" 后按 Ctrl+Space ——有路径列表弹出才算真正跑起来了。
