Sublime Text 汇编高亮失效主因是语法未绑定或包未启用：需手动右下角选 Assembly (NASM)/x86 (GAS) 等；.s 文件被误判为 Shell 须永久绑定；指令/寄存器不着色说明语法包未定义，应升级或自定义语法；宏默认不着色，需正则匹配添加；不同架构/汇编器语法包互不兼容，宜精不宜多。
Sublime Text 默认不识别 .asm 或 .s 文件为汇编语言，打开后显示纯黑白或误判成 Shell/C —— 这不是插件没装好，而是文件类型根本没绑定过去。
右下角点错语法名，高亮永远不生效
这是最常卡住人的一步：打开一个 .asm 文件，右下角显示的是 Plain Text，你必须手动点击它 → 在弹出菜单中搜索并选中 Assembly (NASM)、x86 (GAS) 或 ARM Assembly（取决于你写的指令风格）。若菜单里压根没有这些选项，说明对应语法包没启用，不是“没装”，而是被禁用了。
- 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入Package Control: Enable Package回车 - 搜索
Assembly或NASM，勾选启用（注意名称带括号的，比如Assembly (NASM)，别选错成Assembly Language Support之类泛用但覆盖弱的） - 启用后立刻重试右下角切换，此时应能出现对应项
.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规则里加正则匹配，例如- match: \b(vmovdqa|vpmovzxbd)\b
自定义宏（如 %define BUF_SIZE 4096）永远不着色
所有公开语法包都只处理标准伪指令（.data、.globl），对 %define、%macro 或项目私有宏名（如 .mysection）默认忽略。这不是遗漏，是设计如此：语法高亮器不做语义解析，只做字符串模式匹配。
- 确认 scope：光标放
%define上，运行Developer: Show Scope Name，看是否含keyword.other.directive.nasm—— 没有就说明该包连基础 NASM 指令集都没完整覆盖 - 别指望“自动识别”：NASM 和 GAS 的宏机制完全不同，Sublime 不可能动态判断你这行是宏定义还是普通标签
- 真要高亮：只能走自定义语法路径，在
meta.preprocessor.nasm或类似 scope 下追加 match 规则，且必须用完整正则（如%define\s+\w+），不能只填单词
最易被忽略的一点：不同架构（x86/ARM/RISC-V）和汇编器（NASM/GAS/MASM）的语法包互不兼容，装多个反而可能让 Sublime fallback 到 Plain Text；选一个、绑对后缀、验证 scope，比堆插件管用得多。
