vscode本身不运行assembly代码，真正执行依赖本地工具链（如nasm、ld、dosbox等）；若终端无法调用这些工具，则所有配置均失效。需正确绑定文件类型、配置tasks.json和launch.json，并确保工具链路径、架构声明、调试符号等细节严格匹配。
nasm、ld、DOSBox、debug.exe 等）是否能被 VSCode 终端正确调用；如果终端里敲 nasm -v 都报 command not found，那点右键“Run ASM Code”或按 F5 就只会静默失败——连错误提示都不会弹。
为什么 .asm 文件右下角显示 “Shell Script”
这不是 VSCode bug，是你没把文件类型和汇编语法绑定对。VSCode 默认不认识 .asm 或 .s，直接当文本或 Shell 脚本处理。
- 写 NASM（
.asm）：装Assembly (NASM)扩展，打开任意.asm文件后，点右下角状态栏 → “Configure File Association for '.asm'” → 选Assembly (NASM) - 写 GAS（
.s）：装GNU Assembly (GAS) Syntax Highlighting，再在settings.json里加："files.associations": {"*.s": "gas"} - 别用
ASM Highlight这类泛用插件——它不识别%rax、不解析.data段，高亮等于没高亮
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
F5 调试时显示 “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，寄存器面板就是空的 - NASM 必须加
-g，链接时加-g或--gdwarf-4；GAS 用-g+--gstabs，否则符号不加载，寄存器和反汇编视图全空白
Windows 下用 TASM/DOSBox 黑屏或单步无响应
插件默认调用系统 PATH 中的 dosbox 命令，但你根本没装 DOSBox，它就静默失败；F5 黑屏、寄存器空白、F10 单步不响应，90% 是 masm_debug 路径错、DOSBox.exe 被替换失败、或 [autoexec] 里 mount 和 PATH 没对齐。
- 把
masm-tasm.dosbox.emulator设为builtin，并**完全重启 VSCode**（仅重载窗口不够） -
masm_debug字段默认是c:masmdebug.exe ${filename}.exe，但该路径几乎不存在；改成你本地实际路径，例如："d:\masm\debug.exe ${filename}.exe"，且生成的.exe名必须小写（hello.exe） - DOSBox 配置文件（
dosbox-0.74-3.conf）的[autoexec]段必须含这两行：mount d d:masm和set PATH=%PATH%;d:masm - 插件自带的
DOSBox.exe是阉割版，必须手动替换为完整版 0.74-3；覆盖路径：%USERPROFILE%.vscodeextensionsxsro.masm-tasm-0.8.4 oolsdosboxDOSBox.exe
targetArchitecture 是否和你写的指令集严格匹配、以及 .exe 或 .out 文件名大小写是否和调试配置里的一致——这些细节错一个，整个流程就断在黑屏或空白寄存器上。
