Sublime Assembly语法高亮不生效需先手动设置文件类型为Assembly（如NASM/GAS），再通过PackageResourceViewer定制语法；构建需单独配置NASM.sublime-build并确保PATH正确；ARM/RISC-V高亮异常则需核对scope名称与主题支持。
Assembly 语法高亮不生效？先确认 Sublime 是否识别了文件类型
Sublime 不会自动根据文件后缀（比如 .asm、.s）绑定 Assembly 语法，常表现为纯黑白文本或错误地套用 Plain Text 高亮。这不是插件问题，而是文件类型未正确关联。
- 手动触发：打开汇编文件 → 点击右下角当前语言名（如
Plain Text）→ 在弹出菜单中搜索Assembly→ 选择对应项（常见有Assembly (NASM)、Assembly (GAS)、ARM Assembly） - 永久绑定：右键文件标签 →
Open all with current extension as...→ 选中目标语法 → 勾选Apply to all .xxx files - 注意：不同汇编语法差异大，
NASM和GAS的指令格式、注释符、段声明都不同，选错会导致高亮错乱甚至关键字标红失败
需要支持自定义指令或宏？别硬改默认语法包
Sublime 默认的 Assembly (NASM) 或 Assembly (GAS) 语法定义是只读的，直接编辑 Packages/Assembly 下的文件会在升级后被覆盖，且容易破坏结构。
- 正确做法：用
PackageResourceViewer插件提取原始语法定义 → 复制到Packages/User/下重命名（如MyNASM.sublime-syntax）→ 修改其中的contexts段落添加新指令 - 关键点：新增指令要写在
instructions规则里，用正则匹配（例如- (?i)\b(my_custom_insn|another_op)\b），不能只加单词列表 - 避坑：不要动
file_extensions字段——那是全局绑定入口，应在「文件类型绑定」环节处理，否则可能让所有.asm文件强制走你的定制语法，干扰其他项目
Windows 下调试 NASM + Sublime？高亮和构建要分开配
高亮只是视觉层，和能否编译运行无关。很多人以为装了语法包就能一键 F7 编译，结果报 'nasm' is not recognized，其实是构建系统缺失。
- 先确保 NASM 已安装并加入 PATH：命令行运行
nasm -v能输出版本号才算到位 - 再配构建系统：菜单
Tools → Build System → New Build System→ 粘贴以下内容并保存为NASM.sublime-build：
{
"cmd": ["nasm", "-f", "win64", "-o", "${file_base_name}.obj", "${file}"],
"selector": "source.asm-nasm",
"working_dir": "${file_path}"
}
- 注意
selector必须和你当前文件绑定的语法 ID 一致（可通过View → Show Console输入view.settings().get('syntax')查看）；source.asm-nasm是默认 NASM 语法的 ID，若用了自定义语法，这里也要同步改
ARM 或 RISC-V 汇编高亮异常？检查语法包来源和 scope 名称
社区维护的 ARM Assembly 或 RISC-V Assembly 语法包往往由第三方提供（如 GitHub 上的 sublime-riscv），它们不进官方仓库，scope 名称也不统一，容易导致主题适配失败或快捷键冲突。
- 验证是否加载成功：打开一个
.S文件 → 控制台输入view.scope_name(0)→ 看返回值是否含source.arm或source.riscv - 主题不显示颜色？说明当前 Color Scheme 没定义这些 scope 的样式，需手动在主题文件（
.tmTheme）里补充<key>source.arm</key>对应的规则，或换用支持 ARM 的主题（如Monokai Extended） - 切记：不同架构的寄存器命名规则不同（ARM 用
r0–r15，RISC-V 用x0–x31），语法包若混用 scope 名称（比如把 RISC-V 寄存器标成variable.register.x86），高亮就会失效
Sublime 对汇编的支持本质是「语法识别 + 文本渲染」，没有智能语义分析。真正卡住人的，往往是语法包 scope 名称和构建系统 selector 的微小不匹配，或者 Windows 下 PATH 和构建路径的双重脱节——这些地方一错，整个流程就静默失败，连报错都不给。
