Sublime Text默认不识别.asm/.s/.S为汇编，高亮失效主因是语法未绑定：右下角显示Plain Text即证实，需手动选Assembly (NASM)或x86 (GAS)，并确保.s与.S分别绑定、构建系统selector与语法scope严格一致。
Sublime Text 默认不识别 .asm、.s 或 .S 文件为汇编代码，高亮和构建都必须手动配——装了插件但仍是黑白，八成是语法没绑定或构建系统 selector 写错了。
右下角显示 Plain Text 就说明高亮根本没启动
这是最常卡住人的一步。打开一个 hello.asm，右下角写着 Plain Text，哪怕你装了五个汇编插件，高亮也完全不会触发。这不是插件问题，是 Sublime 根本没把这文件当汇编处理。
- 点击右下角文字（比如
Plain Text）→ 在弹出菜单里搜索Assembly (NASM)、x86 (GAS)或EnhancedAssembly → x86 (NASM)，选中 - 如果菜单里压根没有这些选项：按
Ctrl+Shift+P→ 输入Package Control: Enable Package→ 搜索并启用对应插件（注意名称带括号的，比如Assembly (NASM)，别选Assembly Language Support这种泛用但覆盖弱的） -
.s和.S是两个独立后缀，Sublime 区分大小写，必须分别右键文件标签 →Open all with current extension as…→ 各自绑定一次 - 临时验证最快方式：
Ctrl+Shift+P→ 输入Set Syntax: x86 (NASM)回车，立刻看是否变色
选错插件会导致 mov eax, 1 或 movl $1, %eax 全标红
NASM（Intel 语法）和 GAS（AT&T 语法）指令格式、注释符、伪指令前缀完全不同，用同一套高亮规则必然崩。常见现象包括：.globl 标黄、%rbp 不着色、section .data 被当错误。
- 写
.asm文件，用mov eax, 1、section .text、%define→ 装NASM Assembly或EnhancedAssembly最稳 - 写
.s或.S文件，用movl $1, %eax、.globl _start、# comment→ 换GNU Assembly (GAS) Syntax Highlighting，别用ASM Language（它默认按 NASM 设计） -
.s文件总被当成 Shell 或 C：因为开头常有#注释（如#include "asm/errno.h"），Sublime 优先匹配ShellScript；临时删掉第一行再试切换 - 一个文件里混用 Intel + AT&T 语法时，高亮必然崩——这不是配置问题，是语法设计冲突
构建系统 selector 必须与语法 scope 完全一致
高亮配对了，但 Ctrl+B 报 “no build system”，大概率是构建系统的 selector 字段没对上当前语法的实际 scope 名。
- 打开一个已正确高亮的汇编文件 → 光标停在任意指令（如
mov）上 →Ctrl+Shift+P→ 输入Developer: Show Scope Name→ 看输出里第一个 scope（例如source.nasm或source.x86asm） - 新建构建系统：
Tools → Build System → New Build System - 填入内容时，
selector字段必须严格等于上面查到的 scope，例如："selector": "source.nasm"，不能写成source.asm或漏掉source.前缀 - Windows 下用
ml.exe或DOSBox，Linux/macOS 用nasm+ld，路径要写绝对路径或确保环境变量生效；中文路径（如桌面）可能导致插件加载失败，建议用英文路径
自定义指令或寄存器不着色不是配置错，是语法包没定义
光标停在 vmovdqa 或 csrrw 上，Developer: Show Scope Name 输出里不含 support.instruction 类 scope，说明当前语法包根本不认识这个词——它不是 bug，是原始定义就没收录。
- 别直接改
Packages/NASM Assembly/下的.sublime-syntax文件：升级会覆盖，且 YAML 结构复杂易崩 - 安全做法：用
PackageResourceViewer提取原语法 → 复制到Packages/User/下重命名（如MyNASM.sublime-syntax）→ 只在instructions:规则里加正则匹配项，例如：- match: \b(?i)(vmovdqa|csrrw)\b scope: support.instruction - 新增寄存器（如
r12b）同理：加到register:规则下，scope 设为variable.register - 8086 汇编（
mov ax, 1、int 21h）几乎无公开插件支持，得自己写.sublime-syntax，明确列出指令、段和寄存器，并确保主题渲染该 scope
真正麻烦的不是装插件，而是每个环节都依赖前序步骤的精确性：语法名大小写、路径拼写、scope 名称、后缀绑定——错一个字符，高亮就断链，构建就静默失败。
