AsciiDocPlus插件装错会导致.adoc文件显示为Plain Text、语法不高亮；必须确认Sublime版本并安装匹配插件（Text 4用asciidoctor-sublimetext版），手动切换右下角语法为AsciiDocPlus，关闭asciidoctor_js回退并配置本地asciidoctor路径。
AsciiDocPlus 插件装不对，.adoc 文件永远是 Plain Text
Sublime 里打开 .adoc 文件显示为灰色、加粗语法 **text** 不高亮、右下角语法名是 Plain Text——基本就是插件没装对。不是“没装”，而是装了错的或版本不匹配的。
关键点有三个：
- Sublime Text 4 必须用
AsciiDocPlus（作者名是asciidoctor-sublimetext），不能选同名但作者为msarhan的旧版AsciiDoc - 确认 Sublime 版本：Help → About Sublime Text，顶部明确写
Sublime Text 4才能用新插件；若显示Sublime Text 3，则必须用旧哈希值脚本安装 Package Control，否则Ctrl+Shift+P无效 - 装完插件后，必须手动切换语法：右下角点击当前语法名 → 选
AsciiDocPlus；如果点开列表里没有它，说明插件根本没加载成功，重启 Sublime 后再试
预览失效？大概率掉进了 asciidoctor_js 回退陷阱
点 Ctrl+Shift+P → AsciiDoc: Preview，浏览器弹出 HTML，但 :icons: font 不显示、include:: 内容为空、自定义 docinfo 完全没渲染——这不是插件 bug，是默认启用了阉割版的 asciidoctor_js 引擎。
真功能必须走本地 asciidoctor CLI：
- 先关回退：Preferences → Package Settings → AsciiDocPlus → Settings，把
"use_asciidoctor_js": true改成false - 再装 Ruby 版本：macOS/Linux 执行
gem install asciidoctor；Windows 用choco install asciidoctorj（注意非asciidoctor） - 最后配路径：Settings 里填
"asciidoctor_path"，例如 macOS 是/usr/local/bin/asciidoctor，Windows 是C: oolssciidoctorjinsciidoctorj.bat - 改完设置务必重启 Sublime，否则仍走 JS 路径
LaTeXTools 编译失败，别怪插件，先查 latexmk 在不在 PATH
Ctrl+B 没反应、控制台报 command not found: latexmk，问题不在 Sublime，而在系统命令链断了。LaTeXTools 只是调用器，它不会自带编译器。
验证三步缺一不可：
- 终端执行
which latexmk（macOS/Linux）或where latexmk（Windows），必须返回有效路径 - 执行
xelatex --version，确认引擎可用；若报错，说明 TeX 发行版没装全或没加进 PATH - 检查
echo $PATH（macOS/Linux）或echo %PATH%（Windows），确认上一步返回的路径确实在其中 - 任一失败，重装发行版：Mac 用户
brew install --cask mactex；Windows 用户重装 MiKTeX 并勾选「Add to PATH」；Linux 用户补装sudo apt install latexmk texlive-latex-recommended
装完必须重启 Sublime，否则它读不到新 PATH。
tex_path 写死比 use_simple_detection 更可靠
很多人在 LaTeXTools 设置里留着 "use_simple_detection": true，指望插件自动找 latexmk，结果在 MacTeX 路径含空格（如 /Library/TeX/texbin）、或多版本 TeX Live 共存时 100% 失效。
直接写死路径最稳：
- Preferences → Package Settings → LaTeXTools → Settings – User，删掉所有
use_simple_detection字段 - 填入明确路径：
"tex_path": "/Library/TeX/texbin"（macOS）、"tex_path": "C:\texlive\2023\bin\win32"（Windows，注意双反斜杠）、"tex_path": "/usr/local/texlive/2023/bin/x86_64-linux"（Linux） - 同时设
"builder": "latexmk"，并加"cmd"项强制用 XeLaTeX："-pdfxe"和"-synctex=1"
路径里的年份（如 2023）必须和你实际安装的 TeX Live 版本一致，错一位就找不到命令。
