VSCode本身不运行汇编代码，真正执行依赖本地工具链（如nasm、as、ld、DOSBox等）；若终端无法调用这些工具，所有配置均失效。
VSCode 本身不运行汇编代码，真正执行靠的是你本地装的 nasm、tasm、as、ld、tlink 或 DOSBox 这些工具；没配对它们，点“Run ASM Code”或按 F5 就会静默失败，连错误提示都不给。
为什么 .s 或 .asm 文件显示为 Shell Script
这不是 bug，是 VSCode 根本没把文件当汇编处理——寄存器名灰、.data 段不识别、mov rax, 1 全白，全因语言模式没绑对。
- 装错扩展：别用 “ASM Highlight” 这类泛用插件，它不认识
%rax，也不解析段声明 - 写 NASM（.asm）：装
Assembly (NASM)扩展，打开文件后点右下角状态栏 → “Configure File Association for '.asm'” → 选Assembly (NASM) - 写 GAS（.s）：装
GNU Assembly (GAS) Syntax Highlighting，再在settings.json里加："files.associations": {"*.s": "gas"} - 写 ARM（.S 大写）：装
ARM Assembly，并手动加"*.S": "armasm"——GCC 预处理后缀是大写.S，小写.s不认
tasks.json 构建失败，Problems 面板不跳转错误行
只在终端敲 nasm -f elf64 hello.asm，报错不会进 Problems 面板；nasm 写错一个 flag，卡住也没提示哪行错——因为 VSCode 不知道怎么解析它的错误格式。
-
command必须显式调用工具，不能写$gcc或模糊路径；Linux/macOS 示例："nasm -f elf64 -g ${file} && ld -o ${fileBasenameNoExtension} ${fileBasenameNoExtension}.o" -
problemMatcher不能用$gcc：NASM 错误格式是hello.asm:3: error: invalid operand type，得自定义正则："^([^:]+):([0-9]+): error:" - macOS 链接要加
-macos_version_min 11.0 -lSystem，否则ld报错；Apple Silicon 上 GNUld路径通常是/opt/homebrew/bin/ld - Windows 下用 TASM，不推荐写 tasks.json，改插件设置更稳：
masmtasm.dosbox.more里设"tasm"数组，第一项是路径（如"c:\tasm\bin"），第二项带/zi参数："tasm /zi ${filename}.ASM"
launch.json 调试时显示 “No registers to display”
这不是 launch.json 写错了，是调试器压根没加载到符号或根本不知道你在跑什么架构——LLDB/GDB 不会猜，错一条就断链。
-
program字段必须指向真实可执行文件（如./hello），不是${file}（.asm 源文件）；否则报Cannot launch program; no executable specified - 必须声明
targetArchitecture："x86_64"、"arm64"或"arm"；Apple Silicon 不写arm64，寄存器面板就是空的 -
miDebuggerPath要填对：macOS 填/opt/homebrew/bin/lldb-mi（Apple Silicon）或/usr/local/bin/lldb-mi（Intel）；Linux 填gdb；Windows 填ml64.exe对应的 WinDbg 或 CodeLLDB 路径 - 调试符号必须生成：NASM 加
-g，链接加-g或--gdwarf-4；TASM 必须用/zi，TLink 必须用/v/3，否则debug.exe加载时报no debug info
最容易被忽略的是：所有配置都依赖终端能调出 nasm、as、tasm 或 dosbox。打开 VSCode 内置终端，输入这些命令没输出，后续一切配置都是空转——连 which nasm 都返回空，就别急着改 launch.json 了。
