Package Control安装失败必须用2026年官网标“Sublime Text 4”的含SHA256校验脚本，执行后见“Successfully installed”并重启，再验证Ctrl+Shift+P能否调出Install Package命令。
Sublime Text 4 在 2026 年已稳定运行多年，但插件生态仍存在明显断层：Package Control 不装，其他插件全失效；ST4 的 Python 脚本校验机制让旧版安装方式直接报错；Emmet 在 JS/JSX 中默认不生效；AutoFileName 对 Webpack 别名路径完全无感知——这些不是“可选配置问题”，而是开箱即用前必须绕过的硬门槛。
Package Control 安装失败的典型错误和修复步骤
2026 年所有 ST4 安装都强制校验 SHA256，粘贴 ST3 时代的 urllib.request 代码会触发 AttributeError: module 'urllib' has no attribute 'request' 或 urllib.error.URLError。官网只提供标有 “Sublime Text 4” 的完整脚本，含 hashlib.sha256 校验段，缺一不可。
- 打开控制台：
Ctrl + `（反引号） - 从
packagecontrol.io复制最新 ST4 安装脚本（注意页面是否标注 “For Sublime Text 4”） - 回车执行后，必须看到
Successfully installed提示 - 重启 Sublime Text，再按
Ctrl + Shift + P输入Package Control: Install Package，能弹出空白列表才算真正就位 - 若仍无响应，先执行
Package Control: Synchronize Sources；公司网络开了代理的，需临时关闭再试
Emmet 在 HTML/CSS/JSX 中触发条件差异
Emmet 默认只在 text.html.basic 和 source.css 语法下生效。在 .jsx 或 .js 文件中写 div.container 按 Tab 没反应，不是插件坏了，是作用域没配。
- 确保右下角状态栏显示为
HTML或CSS，否则 Emmet 不启动 - JS/JSX 文件需手动启用：进入
Preferences → Package Settings → Emmet → Settings，添加"syntax_scopes": {"javascript": "source.js"} - 若项目用
create-react-app或 Vite，默认 JSX 语法识别为source.js.jsx，此时要改为"javascriptreact": "source.js.jsx" -
section>div.container>ul>li*3这类嵌套缩写只在 HTML 上下文有效，JSX 中建议用rfc（React Function Component）等 snippet 替代
AutoFileName 找不到文件的三个常见原因
AutoFileName 补全 <img src=""> 引号内路径时失灵，90% 情况下不是插件问题，而是工程结构或配置未对齐。
- 项目根目录没通过
Project → Add Folder to Project加入，它只扫描已加入项目的子目录，不会遍历整个磁盘 - 默认跳过
node_modules、dist、build等目录，这是硬编码行为，无法通过设置开启 - Webpack 别名如
@/components/Button.vue，AutoFileName 完全无法解析，它只做文件系统路径补全，不读webpack.config.js或vite.config.ts - 补全快捷键是
Ctrl + Space（Windows/Linux）或Cmd + Space（macOS），不是Tab
SublimeLinter-eslint 报错但不标红的排查重点
SublimeLinter 本身不检查任何东西，它只是个调度器。装了框架但没装具体 linter，界面静默得像没装一样。
- 必须单独安装
SublimeLinter-eslint和SublimeLinter-stylelint，仅装SublimeLinter框架毫无意义 - 项目根目录必须存在
.eslintrc.js（或.eslintrc.json），且 ESLint 已通过npm install eslint --save-dev安装到本地node_modules - 全局安装的 ESLint（
npm install -g eslint）在 ST4 中大概率不被识别，必须用本地安装版本 - 检查控制台（
Ctrl + `）是否有SublimeLinter: eslint cannot locate 'eslint'类报错，有则说明路径没找对
ST4 插件链比表面看起来更脆弱：Package Control 是唯一入口，Emmet 依赖语法作用域显式声明，AutoFileName 对工程结构零容忍，SublimeLinter 需要本地 node_modules 支持——这些不是“高级技巧”，而是每天真实阻塞开发的节点。跳过任一环节，后续所有插件都会变成摆设。
