汇编语法高亮不生效，90%是语言模式没对上；VSCode默认将.s识别为Shell、.asm识别为Plain Text，必须手动切换为对应Assembly语言模式，并安装匹配NASM/GAS/ARM风格的扩展。
汇编语法高亮不生效，90% 是语言模式没对上，不是扩展装错了。 VSCode 默认把 .s 当成 Shell 脚本，.asm 当成纯文本——高亮根本不会启动，连寄存器名 rax、指令 mov 都不会变色。必须手动指定语言模式，再配匹配的扩展。
为什么 .s 文件右下角显示 “Shell Script”
VSCode 按文件后缀自动推断语言模式，.s 被硬编码为 shellscript，这是默认行为，不是 bug。它和你装不装汇编扩展完全无关。
- 打开任意
.s文件，看右下角状态栏；如果显示 “Shell Script”，说明语言模式已错位 - 点击它 → 选 “Configure File Association for '.s'” → 设为 “Assembly (NASM)” 或 “ARM Assembly”（取决于你写的风格）
- 若列表里没有目标选项，先装对应扩展：
x86 and x64 Assembly（NASM/YASM）、ARM Assembly（dan-c-underwood）、RISC-V Support - 仍不生效？在
settings.json里加显式映射："files.associations": {"*.s": "assembly-nasm"}（语言 ID 可通过命令面板 “Change Language Mode” 查看）
NASM / MASM / GAS 高亮效果差异大，不能混用
同一段 section .data 在 NASM 扩展里能高亮，在 MASM 扩展里可能当普通标签；.model flat 这类伪指令只在 MASM 扩展中识别。寄存器名灰着、宏指令 %define 不变色，基本就是扩展和语法风格不匹配。
- 写 NASM 风格（
section .text,global _start）→ 装x86 and x64 Assembly - 写 Windows MASM（
.data,.code,invoke）→ 装masm扩展 - 写 GNU AS（GAS）风格（
.section .text,.globl _start）→ 用GNU Assembly或确保Assembly Language Support启用了 GAS 模式 - 别指望一个扩展通吃：
mov eax, 1在 NASM 扩展里高亮，但mov %rax, $1（AT&T）会直接失效
高亮正常 ≠ 构建能过，中文路径/空格会让 nasm/ml64 静默失败
语法高亮只走 VSCode 前端解析，不调用任何工具链。所以即使 eax 红得耀眼，nasm -f elf64 main.asm 也可能报 file not found——原因常是工作区路径含中文、空格或 & 符号，比如 C:\My Projects\asm\。
- 排查方式：在 VSCode 内置终端执行
nasm -v或ml64.exe /?，确认命令本身可运行 - 再执行构建命令，观察是否因路径解析失败而中断；如果是，把项目移到纯英文无空格路径下（如
C:\asm\hello\） - Windows 用户注意：
ml64.exe必须在 PATH 中，且 VSCode 需继承 Visual Studio 环境变量（推荐启动前运行vcvarsall.bat） - macOS 用户注意：
ld默认是 Apple ld，NASM + ld 构建 x86_64 时需加-macos_version_min 11.0 -lSystem，否则链接失败
真正卡住人的从来不是“怎么装扩展”，而是语言模式、语法风格、工具链路径三者没对齐。哪怕只错一个环节，rax 就是灰的，nasm 就是找不到，gdb 就加载不了符号——它们之间没有容错，只有严格匹配。
