sublimelinter装完没反应，90%因系统未安装或找不到eslint/pylint等cli工具；需在终端运行eslint --version等验证，且sublime不继承shell的path，macos/linux建议用终端启动，windows需确保%appdata% pm在系统path中。

SublimeLinter 装完没反应？先确认 CLI 工具是否真能跑

SublimeLinter 本身不检查代码，它只调用你系统里装好的 eslint、pylint、rubocop 这类命令行工具。装完插件却看不到报错，90% 是因为终端里敲不出对应命令。

• 打开终端，分别运行 eslint --version、pylint --version（按需），如果报 command not found，说明工具没装或不在 PATH 中
• macOS/Linux 用户注意：Sublime 可能不继承 shell 的 PATH，尤其是用 Dock 启动时；建议从终端执行 open -a "Sublime Text" 启动编辑器
• Windows 用户检查 %AppData% pm 是否已加入系统环境变量 PATH，否则全局安装的 eslint 插件找不到它

JsPrettier 格式化失效？关键在三处配置

JsPrettier 不读项目级 .prettierrc 是默认行为，不是 bug，是设计如此。想让它尊重团队配置，必须手动改设置。

Craft AI Assistant

Craft AI Assistant是一款AI文本写作工具，在线文档工具Craft推出的AI文档和创作助手。

下载

• 进入 Preferences → Package Settings → JsPrettier → Settings – User
• 填入以下最小必要项（缺一不可）：
  "prettier_cli_path": "/opt/homebrew/bin/prettier"（macOS 示例，用 which prettier 查绝对路径）
  "config_precedence": "file-override"（否则永远忽略 .prettierrc）
  "auto_format_on_save": true（默认是 false）
• Windows 用户注意：路径要带 .cmd 后缀，比如 C:\Users\xxx\AppData\Roaming\npm\prettier.cmd

JSON Tools 格式化失败？先看右下角语言标识

Ctrl+Alt+J 没反应，大概率不是插件问题，而是 Sublime 没把当前文件当 JSON 解析——它不会主动纠错，只对合法 JSON 做缩进重排。

• 右下角状态栏显示 Plain Text 或 JavaScript？点击它，手动选 JSON
• 保存文件为 .json 后缀，避免靠内容自动识别（Sublime 对 JSON 内容识别很弱）
• 若仍失败，用 SublimeLinter-json 先查错：Unexpected token '}' 或 Trailing comma 这类提示会直接标出非法位置

HTML-CSS-JS Prettify 报错“not well-formed”？XML/HTML 必须先合法

这个插件不做语法修复，只美化已合法的结构。遇到 xml.parsers.expat.ExpatError: not well-formed，说明标签没闭合、属性缺引号，或模板字符串里的 被当成了标签起始符。

• 检查 & 是否写成裸露字符（应为 &），<script></script> 里含 JSX 或模板字面量时，建议拆到单独 .js 文件再格式化
• 确保文件后缀是 .html 或 .xml，否则右下角显示 Plain Text 时插件命令根本不会触发
• 配置里 "newline_between_rules": false 可禁用 CSS 规则间多余空行，但不影响 HTML 结构校验逻辑

真正卡住人的从来不是“装哪个插件”，而是 Sublime 不告诉你它为什么不动——它只管调用外部工具，而外部工具又只认系统 PATH 和文件语法类型。每一步都得亲手验证，漏掉任何一个环节，就静默失败。