右下角显示 Plain Text 说明高亮未启动，需点击切换为 Assembly (NASM)/x86 (GAS)/ARM Assembly；若菜单无选项则启用 EnhancedAssembly 等插件；.s 与 .S 需分别绑定，且 .s 易被误判为 Shell；寄存器或指令不着色因语法包未定义该词或主题不支持；构建系统 selector 必须与语法 scope 严格一致。
右下角显示 Plain Text 就说明高亮根本没启动
这不是插件没装，是 Sublime 压根没把当前文件当汇编处理。点右下角文字（比如 Plain Text），在弹出菜单里搜 Assembly (NASM)、x86 (GAS) 或 ARM Assembly——选中即生效。
如果菜单里压根没有这些项，说明对应语法包被禁用了：Ctrl+Shift+P → 输入 Package Control: Enable Package → 搜索并启用 EnhancedAssembly 或 Assembly Language Support。
- .s 和 .S 后缀必须分别绑定，Sublime 不会自动继承小写规则
- .s 文件常以
#include或#define开头，会被误判为 ShellScript；临时解法：Ctrl+Shift+P→Set Syntax: x86 (GAS) - 永久解法：右键文件标签页 →
Open all with current extension as…→ 选EnhancedAssembly → x86 (GAS)（注意大小写和空格必须完全一致）
寄存器/新指令不着色？不是配置错，是语法包没定义这个词
光标停在 vmovdqa 或 csrrw 上，Ctrl+Shift+P → Developer: Show Scope Name，如果输出里不含 support.instruction 或 variable.register 类 scope，说明当前语法文件根本没收录该 token。
NASM 插件默认不认 RISC-V 的 csrrw，GAS 插件默认不认 AVX-512 的 vaddpd；宏（如 %define BUF_SIZE 4096）也不着色，因为语法里没定义 meta.preprocessor.nasm scope。
- 主题也可能导致“写了却看不见”：换用
Monokai或Adaptive主题再试一次Show Scope Name - 想加自定义词？得手动改
.sublime-syntax文件，不是改用户设置就能生效
构建系统 selector 必须和语法 scope 严格一致
自定义 nasm.sublime-build 时，selector 字段必须匹配你手动设置的语法 scope。比如你用的是 Assembly (NASM)，那 selector 得写成 source.asm.nasm；若用的是 EnhancedAssembly → x86 (GAS)，则 selector 应为 source.gas。
不一致会导致 Build 菜单里找不到对应项，或者 Build 时根本不会触发。另外，.s 文件若被识别为 ShellScript，构建系统也永远不会运行——高亮和构建是两套依赖，但都卡在同一个起点：右下角显示的语法名是否正确。
- 检查当前语法 scope 的最简方式：
Ctrl+Shift+P→Developer: Show Scope Name -
selector值不能靠猜，必须和Show Scope Name输出的第一行完全一致（含大小写、点号、下划线） - Windows 下路径带空格或中文会导致
shell_cmd失败，建议全用英文路径 + 英文文件名
Mac/Linux 用户别直接 clone 到 Packages 目录就完事
Mac 上路径是 /Users/xxx/Library/Application Support/Sublime Text 3/Packages，Linux 是 ~/.config/sublime-text-3/Packages，但直接 git clone 进去后，Sublime 不一定立刻加载——得重启编辑器，或 Ctrl+Shift+P → Package Control: Satisfy Dependencies。
更稳妥的做法是：先确认插件是否真被启用。Preferences → Package Settings 里有没有对应条目？没有就说明 Sublime 没识别到它，常见原因是插件目录名含非法字符（比如带空格或点号）、或子目录结构不对（缺 .sublime-syntax 或 tmLanguage 文件）。
- 推荐优先用 Package Control 安装，比手动放文件可靠得多
- 如果非要手动安装，插件目录名必须和
Package Control: List Packages显示的名字完全一致 - 插件作者没提交
sublime-package包？那就得自己打包：用 zip 打包整个插件目录，改后缀为.sublime-package，扔进Installed Packages目录
实际用起来最卡人的地方，从来不是“怎么装”，而是“装完没反应时，你第一反应是重装插件，还是去看右下角那个 Plain Text”。很多问题，点一下就解决了。
