VSCode本身不运行汇编代码，真正执行依赖本地工具链；必须先确保nasm/as/ld等在VSCode终端可执行，再配置扩展、tasks.json和launch.json，否则构建与调试全失效。
VSCode 本身不运行汇编代码，所有执行和调试都依赖你本地装好的工具链是否真正可用——nasm、ld、lldb-mi 或 gdb 在 VSCode 内置终端里跑不通，后续配置全白搭。
确认 nasm / as / ld 在 VSCode 终端能执行
这是最常被跳过、却导致 90% 配置失败的环节。不是“装了就行”，而是 VSCode 必须能继承完整 PATH。
- 打开 VSCode →
Ctrl+`新建终端 → 输入nasm -v（x86-64）、as --version（GAS）或tasm（8086），必须有输出 - 若报
command not found：Windows 用户检查tasm.exe或ml64.exe是否在系统 PATH；macOS/Linux 用户用brew install nasm binutils，再运行命令面板里的Shell Command: Install 'code' command in PATH - macOS 上注意：
ld默认是 Apple ld64，NASM 输出macho64时它能用；但若要 GNUld，得确保/opt/homebrew/bin/ld（Apple Silicon）或/usr/local/bin/ld（Intel）在 PATH 前置位置
tasks.json 必须匹配目标平台与输出格式
这个文件决定你按 Ctrl+Shift+B 时到底执行什么。写错一个参数，生成的就是无法加载的 object 文件，而不是可执行文件。
- x86-64 macOS（Mach-O）：
"nasm -f macho64 ${file} && ld -macos_version_min 11.0 -lSystem -o ${fileBasenameNoExtension} ${fileBasenameNoExtension}.o" - x86-64 Linux（ELF）：
"nasm -f elf64 -g ${file} && ld -o ${fileBasenameNoExtension} ${fileBasenameNoExtension}.o" - 8086 DOS（TASM）：不靠
tasks.json，而靠插件设置（如masmtasm.dosbox.more），第一项填路径，第二项带/zi参数（"tasm /zi ${filename}.ASM"）才能调试 - 关键细节：
${fileBasenameNoExtension}是自动提取的文件名（不含后缀），别手写成hello—— 否则换文件就得改配置
launch.json 架构声明和调试器路径必须精确对应
LLDB/GDB 不会猜你写的是 x86-64 还是 AArch64，也不会自动找 lldb-mi。错一条，F5 就卡在 “No registers to display”。
- macOS + x86-64：用
CodeLLDB扩展，"miDebuggerPath"必须指向真实存在的lldb-mi（Apple Silicon 是/opt/homebrew/bin/lldb-mi，Intel 是/usr/local/bin/lldb-mi） - Linux + ARMv8：用
cortex-debug，"servertype"设为"openocd"，且"executable"字段必须是已生成的 ELF 可执行文件路径（如./main），不是.o或.asm - program 字段值必须是相对路径或绝对路径的可执行文件，不能漏掉
./前缀（例如"./hello"而非"hello"）
别让 .s 或 .asm 被当成 Shell 脚本
右下角状态栏显示 “Shell Script”，说明语法高亮已崩——寄存器名灰、段声明不识别，这不是 bug，是语言模式没绑定。
- 写 NASM（
.asm）：装Nasm Language Support，打开文件后点右下角 “Shell Script” → 选 “Assembly (NASM)” - 写 GAS（
.s）：装GNU Assembly (GAS) Syntax Highlighting，再进设置搜files.associations，加一行："*.s": "gas" - ARM 汇编（
.S，大写 S）：GCC 预处理后缀，需手动设为"*.S": "armasm"，泛用型ASM Highlight插件基本无效
最容易被忽略的其实是调试符号：nasm 必须加 -g，ld 不能 strip，否则断点能打上但无法停住，寄存器视图空白——这问题往往要回溯到 tasks.json 的参数里查。
