VSCode 默认将 .s/.asm 文件识别为 Shell 脚本，需手动绑定语言模式：安装对应扩展（如 Assembly (NASM) 或 gas），点击右下角状态栏→“Configure File Association”→选正确语言；若无效，在 settings.json 中添加 "files.associations": {"*.s": "assembly-nasm"}。
VSCode 本身不支持 Assembly，所有高亮、构建、调试能力都依赖外部工具链和精确配置；装错扩展、没配 tasks.json 或 launch.json，.s 文件就永远是 Shell 脚本，nasm 报错也不提示你哪行写错了。
怎么让 .s 或 .asm 文件正确识别为汇编语言
VSCode 默认把 .s 当作 Shell 脚本，寄存器名灰、指令无色、段声明（.data/.text）不识别——这不是 bug，是语言模式根本没设对。
- 先装对应语法风格的扩展：
x86 and x64 Assembly（NASM/YASM/GAS）、ARM Assembly（树莓派/裸机）、GNU Assembly (GAS) Syntax Highlighting（专治.s）；别装ASM Highlight这类泛用插件，它连%rax都不认识 - 打开任意
.s或.asm文件，看右下角状态栏：如果显示 “Shell Script” 或 “Plain Text”，点击它 → 选 “Configure File Association for '.s'” → 设为 “Assembly (NASM)” 或 “gas” - 若仍不生效，在
settings.json里手动加关联："files.associations": {"*.s": "gas", "*.S": "armasm"}（注意大写.S是 GCC 预处理后缀，ARM 扩展认这个）
为什么 nasm -f elf64 -g 编译成功了，但 F5 调试时提示 No registers to display
因为 launch.json 没告诉调试器你写的是什么架构、用的哪个调试器、符号从哪来——LLDB/GDB 不会猜，错一条就断链。
-
program字段必须指向真实可执行文件（如./hello），不是.asm源文件 -
miDebuggerPath要填对：macOS 填/usr/bin/lldb或code-llvm路径；Linux 填gdb，Windows 填ml64.exe对应的WinDbg或CodeLLDB - 必须声明目标架构：
"targetArchitecture": "x86_64"（x86-64）、"arm64"（Apple Silicon）、"arm"（32 位 ARM） - 调试符号要加载：NASM 必须加
-g，链接时加-g或--gdwarf-4；GAS 用-g+--gstabs，否则寄存器面板空白
tasks.json 怎么写才能让 Problems 面板跳转到错误行
只在终端敲 nasm 命令，报错信息不会进 VSCode 的 Problems 面板，nasm -f elf64 -g hello.asm 写错一个 flag 就卡住，还找不到哪行错。
-
command字段必须显式调用工具，不能用$gcc之类模糊引用；Linux/macOS 示例："nasm -f elf64 -g ${file} && ld -o ${fileBasenameNoExtension} ${fileBasenameNoExtension}.o" -
problemMatcher必须自定义：NASM 错误格式是hello.asm:3: error: invalid operand type，得用正则^([^:]+):([0-9]+): error: - macOS 注意 Apple
ld和 GNUld区别：用系统ld要加-macos_version_min 11.0 -lSystem；用 GNUld（来自binutils）得确保其路径在$PATH前置 - Windows 下若用 MASM，
tasks.json容易绕远；更稳做法是改插件设置：masmtasm.dosbox.more填数组，第一项是路径（如"c:\tasm\bin"），第二项带/zi参数（"tasm /zi ${filename}.ASM"）
为什么高亮正常，但构建失败且不报错
高亮只是文本着色，不校验语法、不调用工具链；中文路径、空格、权限问题都会让 nasm 或 ml64 静默失败，而 Problems 面板一片空白。
- 先确认 VSCode 终端能跑通命令：
nasm -v、as --version、ld --version必须有输出；若报command not found，检查是否真装了，再运行Shell Command: Install 'code' command in PATH - 工作区路径不能含中文、空格或特殊符号（如
C:My Projectssm）；重命名为C:sm再试 - macOS 上注意：Apple Silicon 默认用
arm64，但 NASM 默认生成x86_64目标；若混用，ld会报incompatible architecture，得加-arch x86_64或换用nasm -f macho64 - Windows 用户若用 Visual Studio 工具链，
ml64.exe必须在PATH中，且 VSCode 启动前需运行vcvarsall.bat加载环境变量，否则ml64找不到link.exe
最常被忽略的点是：语言模式、工具链、tasks.json、launch.json 四者必须严格匹配同一套语法风格和目标平台。NASM 写的代码配 GAS 扩展，或 x86-64 代码用 ARM 的 launch.json，表面高亮正常，实际调试时寄存器全空、反汇编视图黑屏——这些都不是 VSCode 的问题，是配置链上某一处没对齐。
