VSCode需配置扩展、工具链和launch.json才能调试汇编：先装对应架构语法高亮扩展并手动关联文件类型，再确保nasm/as等工具在VSCode终端可执行，最后在launch.json中正确声明架构、调试器路径、setupCommands及调试符号选项。
VSCode 本身不带汇编调试能力，但配对正确扩展和调试器后，能稳定单步执行、查看寄存器、切换反汇编视图——关键在 launch.json 的架构声明、调试器路径和符号加载方式是否匹配你的目标平台。
确认汇编工具链已就位且可被 VSCode 调用
VSCode 终端里跑不通 nasm 或 as，后续所有配置都会失败。这不是“装了就行”，而是 PATH 必须生效：
- 在 VSCode 内置终端执行
nasm -v或arm-none-eabi-gcc --version，必须有输出；若报command not found，先检查系统是否真装了，再确认 VSCode 是否继承了完整 PATH（Cmd+Shift+P → “Shell Command: Install 'code' command in PATH”） - macOS 上注意 Apple
ld和 GNUld的区别：NASM +ld构建 x86_64 时，用ld -macos_version_min 11.0 -lSystem；若需 GNUld，得装binutils并确保其路径在$PATH前置位置 - Windows 用户若用 MASM，
ml64.exe必须在 PATH 中，且 VSCode 启动前需以管理员权限运行或已加载 Visual Studio 环境变量（推荐用vcvarsall.bat预设）
选对语法高亮扩展，别让 .s 文件被当 Shell 脚本
VSCode 默认把 .s 当成 Shell 脚本，寄存器名、指令全灰——这不是 bug，是语言模式没手动指定：
- 安装对应架构的扩展：
x86 and x64 Assembly（NASM/YASM/GAS）、ARM（dan-c-underwood）、RISC-V Support；不要只装泛用型ASM Highlight，它不识别段声明或伪指令 - 打开任意
.s或.asm文件后，看右下角状态栏：如果显示 “Shell Script”，点击它 → 选择 “Configure File Association for '.s'” → 设为 “Assembly (NASM)” 或 “ARM Assembly” - 若仍不生效，在设置中搜
files.associations，手动加条规则："*.s": "assembly-nasm"（具体语言 ID 可在命令面板中 “Change Language Mode” 查看）
launch.json 必须声明目标架构与调试器路径
LLDB/GDB 不会自动猜你写的是 x86-64 还是 AArch64，错一条配置就卡在 “No registers to display”：
- macOS + x86_64：用
CodeLLDB扩展，launch.json中必须含"miDebuggerPath": "/opt/homebrew/bin/lldb-mi"（Apple Silicon）或/usr/local/bin/lldb-mi（Intel），并确认该路径存在（which lldb-mi） - Linux + ARMv8：用
cortex-debug，launch.json中"servertype"设为"openocd"或"jlink"，且"configFiles"指向正确的openocd.cfg - 所有平台都要加
"setupCommands"：例如 GDB 下加{"description":"Enable pretty-printing","text":"set print pretty on"}和{"description":"Set intel syntax","text":"set disassembly-flavor intel"}，否则反汇编窗口全是 AT&T 风格
调试时寄存器/内存/反汇编三者必须同步可见
纯源码级断点对汇编意义不大，真正需要的是指令流 + 寄存器变化 + 内存映射联动：
- 启动调试后，按 Ctrl+Shift+P → 输入 “Debug: Toggle Disassembly View”，确保反汇编窗口打开；默认它只显示当前函数，要看到全部指令需右键 → “Show All Instructions”
- 寄存器面板默认折叠，点击左侧调试侧边栏的 “Registers” 标签页，展开
General Purpose Registers；x86-64 下若看不到%rax而是rax，说明setupCommands里缺了set architecture i386:x86-64 - 内存查看不能靠猜：在调试控制台输入
x/10xb $rsp（GDB）或memory read -f x1 -c 10 $rsp（LLDB）直接读栈顶 10 字节；想持久化查，装Hex Editor插件，右键.o或.bin文件 → “Open With Hex Editor”
最容易被忽略的一点：汇编调试严重依赖调试信息生成。NASM 必须加 -g -F dwarf，GAS 必须加 -g，链接时不能 strip 符号——否则断点打不进、源码无法映射、寄存器值全为 <optimized out>。
