Package Control安装失败主因是脚本过期、网络拦截或路径错误,必须用2026年ST4专用含SHA256校验的Python脚本手动执行,成功标志为状态栏提示“Successfully installed”,否则需严格按sublime.installed_packages_path()路径手动放置Package Control.sublime-package并重启。

装错 Package Control,后面所有插件都白忙——这是 2026 年 Sublime Text 4 用户踩坑率最高的起点问题。
Package Control 安装失败的典型报错和绕过方法
Sublime Text 4 原生不带插件管理能力,Package Control 不是“可选增强”,而是硬性前置。旧版脚本(如含 urllib.request 但无 hashlib.sha256 校验段)在 ST4 上必报错:AttributeError: module 'urllib' has no attribute 'request' 或 URLError。
- 必须从 packagecontrol.io 复制标有 “Sublime Text 4” 字样的完整 Python 3 脚本(含
h = '2915d185' + '8bc59f46'类 SHA256 校验值) - 粘贴进
Ctrl + `控制台后回车,看到Successfully installed才算成功 - 重启 Sublime 后按
Ctrl + Shift + P输入Package Control: Install Package,弹出空白搜索框才算就位 - 若命令无响应,先执行
Package Control: Synchronize Sources;公司网络开代理时,需临时关闭 GUI 应用代理
Emmet 在 .vue 文件里不生效?检查语法模式和插件组合
Emmet 默认只在 HTML/CSS 语法下触发,.vue 文件若右下角状态栏显示的是 HTML 或 Plain Text,div.card>ul>li*3 按 Tab 就完全没反应。
- 必须安装
Vue Syntax Highlight插件,并重启 Sublime - 打开
.vue文件后,点击右下角语法标识,手动切换为Vue(不是Vue Component或其他变体) - 确认
<template></template>区域内光标处于普通文本位置(非<script></script>或<style></style>块内) - 如仍无效,检查
Preferences → Package Settings → Emmet → Settings中是否误删了"syntax_scopes": {"vue": "text.html.vue"}
AutoFileName 补全路径失败的三个隐藏前提
AutoFileName 看似简单,但 80% 的“不提示”问题都源于配置缺失:它不会自动扫描整个磁盘,只认你显式声明的项目根目录。
PigX UI Pro 前端开发指南 - Vue 3 + TypeScript + Element Plus。当用户提到 PigX UI、PigX 前端、lgb-mgui 项目、Vue 3 企业级后台开发、Element Plus 后台开发时使用此技能。
立即学习“前端免费学习笔记(深入)”;
- 必须通过
Project → Add Folder to Project将当前前端项目文件夹加入工作区,否则它只扫单个文件所在目录 - 默认跳过
node_modules和dist等常见构建目录,若需补全bootstrap/scss/这类路径,得手动编辑Packages/User/AutoFileName.sublime-settings,添加"scan_folders": ["node_modules"] - 在 HTML 中触发补全需光标位于引号内且末尾(如
src="./|"),按Ctrl + Space(不是Tab)才弹列表;CSS 中url(|)同理 - 若项目用了 Webpack 别名(如
@/components),AutoFileName无法识别,得靠ESLint的import/no-unresolved规则提前拦截
SublimeLinter-eslint 标红失效,先查这三处配置
SublimeLinter 本身只是调度器,真正干活的是 SublimeLinter-eslint。只装框架不装具体 linter,编辑器全程静默。
- 必须依次安装:
SublimeLinter→SublimeLinter-eslint→SublimeLinter-stylelint(顺序不能错) - 项目根目录必须存在
.eslintrc.js(或package.json中含eslintConfig字段),否则提示No config found,不标红也不报错 - 避免与
LSP-eslint共存:二者监听同一保存事件,轻则重复报错,重则卡死光标;若已装LSP,直接禁用SublimeLinter-eslint - 全局安装的
eslint版本常与项目本地node_modules/.bin/eslint冲突,建议在SublimeLinter-eslint设置中指定"executable": ["./node_modules/.bin/eslint"]
最易被忽略的是项目根目录绑定和语法模式切换——它们不报错、不弹窗,只让插件彻底失能。别等写完一屏代码才发现 Emmet 没动、路径手敲错了三次、ESLint 一红没标。

















