Sublime怎么编辑AsciiDoc文件_Sublime如何配置AsciiDoc插件【妙招】-sublime-PHP中文网

sublime text 编辑 asciidoc 文件需三步：正确安装匹配版本的 asciidocplus 插件、手动设置语法为 asciidocplus、关闭 asciidoctor_js 回退并配置本地 asciidoctor 路径；否则文件显示为 plain text，预览功能缺失或异常。

sublime怎么编辑asciidoc文件_sublime如何配置asciidoc插件【妙招】

Sublime Text 编辑 AsciiDoc 文件，核心就三件事：装对插件、设对语法、配对预览（可选）。装错插件或版本不匹配，.adoc 文件永远是“Plain Text”——连加粗 **text** 都不标蓝。

Sublime Text 3 和 4 的 Package Control 安装脚本完全不同，用错直接导致 Ctrl+Shift+P 打不开命令面板，或 Install Package 列表为空。

按 Help → About Sublime Text 看顶部显示是 Sublime Text 3 还是 Sublime Text 4
Sublime Text 4 必须用新哈希值脚本（h = '6f4c264a24d933ce70df5dedcf1dcaee...' ），旧脚本会卡在 “Installing Package Control” 不动
Sublime Text 3 用旧哈希值（h = 'bf11abc32606e6b559e4c226611e854d...' ），否则控制台报 UnicodeDecodeError
执行完脚本后，务必重启 Sublime；再按 Ctrl+Shift+P 输入 Package Control，能出现选项才算成功

两个插件都叫 AsciiDoc，但维护者和能力差异明显：

一款AI工具，主要用于管理 OpenClaw 所使用的来自 OpenRouter 的免费 AI 模型。自动按质量对模型进行排序，配置回退机制以应对速率限制，并更新 opencla...，适合需要提升相关任务效率的用户。

下载

AsciiDoc（maze-for-ascii）：轻量，只做基础语法高亮，[source,java] 块里不识别 Java 关键字
AsciiDocPlus（推荐）：支持语言内联高亮、文档属性（如 :toc:）、表格对齐、甚至部分宏渲染提示；Ctrl+Shift+P 搜索时注意作者名
装完后打开一个 .adoc 文件，右下角点语法名称 → 选 AsciiDocPlus → AsciiDocPlus，不是 AsciiDoc → AsciiDoc
如果点开后仍是灰色文字，说明没生效：关掉文件，再用 View → Syntax → Open all with current extension as… → AsciiDocPlus → AsciiDocPlus

Sublime 本身不渲染 HTML，得靠插件调用解析器。默认启用的 asciidoctor_js 是浏览器版精简引擎，:icons: font、include::、自定义 docinfo 全部失效，且不报错——你只会发现预览里图标没出来、引用章节空着。

想真用 Asciidoctor 全功能，必须关掉 JS 回退：Preferences → Package Settings → AsciiDocPlus → Settings，把 "use_asciidoctor_js": true 改成 false
然后终端执行 gem install asciidoctor（macOS/Linux）或 choco install asciidoctorj（Windows）
确认路径正确：Preferences → Package Settings → AsciiDocPlus → Settings 中检查 "asciidoctor_path" 是否指向你的 asciidoctor 可执行文件（例如 /usr/local/bin/asciidoctor）
改完设置别忘了重启 Sublime，否则预览仍走 JS 路径

Sublime 有时会把 README.adoc 错判成 reStructuredText 或纯文本，尤其当你之前打开过同名但不同后缀的文件。

手动强制绑定才是最稳的：打开任意 .adoc 文件 → View → Syntax → Open all with current extension as… → AsciiDocPlus → AsciiDocPlus
这个操作会写入 Packages/User/Preferences.sublime-settings 的 "extensions" 字段，永久生效
如果某天突然又变回 Plain Text，大概率是有人改了全局设置，或装了冲突插件（比如 OmniMarkupPreviewer 默认抢 .adoc 关联）
验证是否生效：新建文件 → 保存为 test.adoc → 看右下角是否立刻显示 AsciiDocPlus