vscode本身不支持汇编语言，所有高亮、构建、调试能力均依赖外部工具链（如nasm/tasm+ld/tlink+debug/lldb）及正确配置；未配对工具链或配置错误将导致“run asm code”静默失败或报command not found。
VSCode 本身不支持汇编语言，所有高亮、构建、调试能力都依赖外部工具链和正确配置；没配对 nasm/tasm + ld/tlink + debug/lldb，点右键“Run ASM Code”或按 F5 就会静默失败或报 command not found。
装错扩展，.s 文件永远是 Shell 脚本
VSCode 默认把 .s 当作 Shell 脚本——寄存器名灰掉、指令无高亮、伪指令不识别，不是 bug，是你没指定语言模式。装个“ASM Highlight”这类泛用插件基本没用，它不处理段声明（.data、.text）也不认 %rax 或 mov r0, #1。
- 写 NASM（
.asm）：装NASM IDE，然后打开任意.asm文件，右下角点“Shell Script” → 选 “Assembly (NASM)” - 写 GAS（
.s）：装GNU Assembly (GAS) Syntax Highlighting，再进设置搜files.associations，加一行："*.s": "gas" - 写 ARM（
.s或.S）：装ARM Assembly，并手动加关联："*.S": "armasm"（注意大写S，GCC 预处理后缀）
tasks.json 不配，nasm 和 ld 就是摆设
语法高亮只是第一步，真正让代码跑起来得靠 tasks.json 把汇编、链接串成一键任务。只在终端里敲命令，没法和 Problems 面板联动，错误行号不跳转，nasm -f elf64 -g hello.asm 写错一个 flag 就卡住。
-
command字段必须显式调用工具：Linux/macOS 用nasm -f elf64 -g ${file} && ld -o ${fileBasenameNoExtension} ${fileBasenameNoExtension}.o；macOS 注意加-macos_version_min 11.0 -lSystem，否则链接失败 - 别用
$gcc做problemMatcher：NASM 错误格式是hello.asm:3: error: invalid operand type，得自定义正则：^([^:]+):([0-9]+): error: - Windows 下若用 MASM/TASM，
tasks.json很容易绕远；推荐改插件设置：masmtasm.dosbox.more里填"tasm"数组，第一项是路径（如"c:\tasm\bin"），第二项带/zi参数（"tasm /zi ${filename}.ASM"）才能调试
launch.json 里少一条，F5 就看不到寄存器
按 F5 没反应、提示 No registers to display、反汇编视图空白——大概率是 launch.json 没声明目标架构或调试器路径不对。LLDB/GDB 不会猜你写的是 x86-64 还是 AArch64，错一条就断链。
- x86-64 macOS：用
CodeLLDB扩展，miDebuggerPath必须指向真实lldb-mi（Apple Silicon 是/opt/homebrew/bin/lldb-mi，Intel 是/usr/local/bin/lldb-mi），且program字段必须是可执行文件（./hello），不是.o或.asm - ARM 裸机/树莓派：用
cortex-debug，servertype设为openocd，configFiles必须指向能工作的openocd.cfg，否则连不上 J-Link - 8086 DOS 环境：别指望
launch.json调试，得用插件内置debug.exe；但前提是tasm /zi和tlink /v/3都用了，否则Debug ASM Code会报no debug info
DOSBox 配错，中文注释和字符串全变方块
写 db '你好','$' 却显示乱码，不是 VSCode 编码问题（UTF-8 没错），是 DOSBox 渲染层不支持 GB2312。原版 DOSBox 0.74 根本没中文字体表，dosbox-x 是唯一靠谱解法，但光装还不行，关键要开 dosv=on。
- 卸载原版 DOSBox，去
dosbox-x官网下 0.84.3+，安装时勾选 “Add to PATH” - VSCode 设置里搜
masm-tasm.dosbox.emulator，值从dosbox改成dosbox-x - 再加一项：
masm-tasm.dosbox.extraArgs，填-c "config -set dosv=on"；漏掉这句，dosbox-x也照样乱码 - 中文注释（
; 退出程序）也会导致debug.exe加载失败——哪怕只有一行，也要全删掉或改英文
最容易被忽略的其实是 PATH 继承：VSCode 内置终端必须能直接跑通 nasm -v、ld --version、dosbox-x --version，否则所有上层配置都是空中楼阁。Mac 上尤其要注意 brew install binutils 后，/opt/homebrew/bin 是否在 $PATH 最前面；Windows 上 vcvarsall.bat 没预设，ml64.exe 就永远找不到。
