右键“run asm code”没反应是因为插件默认调用系统path中的dosbox命令但未安装，需将masm-tasm.dosbox.emulator设为builtin并完全重启vscode，才能启用内置dosbox自动执行tasm→tlink→run全流程。
右键“Run ASM Code”没反应？先改 emulator 为 builtin
这不是插件坏了，是它默认尝试调用系统 PATH 里的 dosbox 命令，但你根本没装 DOSBox，它就静默失败，连报错都不给。必须手动切换到插件内置 DOSBox 实例。
- 打开 VSCode 设置（
Ctrl + ,），搜索masm-tasm.dosbox.emulator - 把值从默认的
dosbox改成builtin - 保存后**完全重启 VSCode**（仅重载窗口不够）
- 改完后右键
.asm文件，“Run ASM Code”会自动拉起内置 DOSBox，挂载当前目录为D:盘，执行tasm → tlink → run全流程
F5 调试黑屏或寄存器空白？检查 masm_debug 和 [autoexec] 配置
masm_debug 字段默认写死为 c:masmdebug.exe ${filename}.exe，但该路径几乎不存在；且 DOSBox 启动时若找不到 tasm.exe 或目标 .exe，就会卡黑屏或直接退出。
- 在设置中搜索
masmtasm.dosbox.more，点击“在 settings.json 中编辑” - 把
"masm_debug": "c:\masm\debug.exe ${filename}.exe"改成你本地实际路径，例如："masm_debug": "d:\masm\debug.exe ${filename}.exe" - 注意：
${filename}是小写名（如hello.asm），生成的可执行文件也必须是小写（hello.exe），否则debug找不到 - 确保 DOSBox 配置文件（如
%LOCALAPPDATA%DOSBoxdosbox-0.74-3.conf）的[autoexec]段包含这两行：mount d d:\masm和set PATH=%PATH%;d:\masm
DOSBox.exe 必须手动替换，否则 F10 单步完全不响应
插件自带的 DOSBox.exe 是阉割版，无法加载 debug.exe 或识别挂载盘符。不替换会导致：F5 后窗口一闪而过、寄存器窗口空白、单步（F10）无响应——这些都不是代码问题。
- 下载完整版 DOSBox 0.74-3 稳定版（Windows x86），不要用 0.8x 或
dosbox-x - 关闭 VSCode（否则文件被占用）
- 将下载的
DOSBox.exe重命名后，覆盖插件目录下的同名文件：%USERPROFILE%.vscodeextensionsxsro.masm-tasm-0.8.4 oolsdosboxDOSBox.exe - 替换后启动 DOSBox 命令行，敲
tasm应显示帮助信息，否则挂载或 PATH 仍有问题
调试提示 “no debug info” 或寄存器为空？编译/链接参数没加调试标志
VSCode 插件调用 debug.exe 加载 .exe 时发现没有调试段，就会报 no debug info；或者 F5 启动后寄存器面板空着，显示 No registers to display——根本原因不是 launch.json 写错了，是 tasm/tlink 没生成调试信息。
-
tasm命令必须带/zi：tasm /zi ${filename}.ASM（生成符号表） -
tlink命令必须带/v/3：tlink /v/3 ${filename}.obj（保留调试段，/3表示 DOS 3.x 兼容模式） - 源文件结尾必须含标准退出：至少含
mov ah,4ch+int 21h，否则debug运行后直接崩溃退出，无法停在断点
[autoexec] 必须严格对齐挂载路径与 PATH，且所有路径不能含中文或空格；debug.exe 只认 ASCII，中文注释或字符串必然乱码——这不是编码问题，是底层渲染限制。
