Sublime Text 中 .asm/.s/.S 文件需手动绑定汇编语法：右下角点“Plain Text”选 Assembly (NASM) 或 x86 (GAS)，若无选项则启用对应插件；.s 和 .S 需分别绑定；寄存器/指令不着色需升级语法包或自定义 .sublime-syntax；构建系统 selector 必须与语法 scope 完全一致。
Sublime Text 默认不把 .asm、.s 或 .S 文件当汇编代码处理，打开就是黑白或误判成 Shell/C —— 这不是插件没装，是文件根本没绑定到任何汇编语法上。
右下角显示 “Plain Text” 就说明高亮完全没启动
这是最常卡住人的一步：打开一个 hello.asm，右下角写着 “Plain Text”，你必须手动点它 → 在弹出菜单里搜 Assembly (NASM) 或 x86 (GAS) 并选中。如果菜单里压根没有这些选项，说明对应插件被禁用了，不是“没装好”。
- 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS）→ 输入Package Control: Enable Package→ 搜Assembly或NASM，勾选启用（注意名称带括号的，比如Assembly (NASM)，别选成泛用但覆盖弱的Assembly Language Support） - 启用后立刻重试右下角切换，此时应能出现对应项
-
.s和.S是两个不同后缀，Sublime 区分大小写，得分别右键标签页 →Open all with current extension as…→ 单独绑定一次
.s 文件总被当成 Shell 脚本
因为 .s 后缀在 Sublime 里默认优先匹配 ShellScript，尤其当文件开头有 # 注释（GAS 风格常见）时，系统直接 fallback 到 Shell 语法。寄存器（如 %rax）、指令（如 movq）全无颜色，注释也不标蓝。
- 临时解决：打开文件 →
Ctrl+Shift+P→ 输入Set Syntax: x86 (GAS)，立刻生效 - 永久绑定：
View → Syntax → Open all with current extension as…→ 选x86 (GAS)（注意大小写和空格，名称必须完全一致） - 若文件是大写
.S，需单独右键标签页 →Open all with current extension as…→ 手动选语法，Sublime 会记住.S而非.s
寄存器/新指令不着色，不是配置错，是语法包没定义
光标停在 vmovdqa 或 csrrw 上，按 Ctrl+Shift+P 输入 Developer: Show Scope Name，如果输出里不含 support.instruction 或 variable.register 类 scope，说明当前语法包根本不认识这个词 —— 它不是 bug，是原始定义就没收录。
- 查包更新：
Ctrl+Shift+P→Package Control: Upgrade Package→ 升级你正在用的NASM或GAS包 - 别直接改
Packages/下的.sublime-syntax文件：升级会覆盖；改错 YAML 格式会导致整个语法失效 - 安全做法：用
PackageResourceViewer提取原语法 → 复制到Packages/User/下重命名（如MyNASM.sublime-syntax）→ 只在instructions:规则里加正则匹配（例如- (?i)\b(vmovdqa|csrrw)\b）
构建系统里的 selector 必须和当前语法 ID 严格一致
很多人配好了高亮，Ctrl+B 却不触发构建，原因往往是 selector 写错了。比如你手动设成了 source.nasm，但构建系统里写的是 source.asm，照样不运行。
- 查当前语法 ID：
Ctrl+Shift+P→ 输入View Package File，搜assembly或nasm，看对应.sublime-syntax文件顶部的scope字段（如source.asm-nasm） - 新建构建系统时，
"selector": "source.asm-nasm"必须和这个值完全一致 - 如果用了自定义语法（比如
Packages/User/MyNASM.sublime-syntax），它的scope也会不同，selector得同步改
真正容易被忽略的是：寄存器名（如 rax）或自定义宏（如 %define BUF_SIZE 4096）不着色，往往不是插件漏了，而是你用的主题没映射对应 scope。先用 Developer: Show Scope Name 确认有没有 scope，再决定是换主题还是补 color scheme 规则。
