Sublime如何安装AutoFileName插件_Sublime自动补全路径教程

当你在Sublime Text中写代码、输路径时，是不是总希望编辑器能像IDE一样自动补全文件路径？AutoFileName插件就是为了这个需求而生。但这里有个常见的坑：直接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、Ja vaScript 等，不能是 Plain Text；Vue 的