16 位/32 位 DOS 汇编语言支持

中文|English

实现对 DOSBox 等汇编工具的快速调用。主要针对 DOS 下的单文件汇编语言学习，可能适合学习《汇编语言》、《微机原理》等课程，主要功能特性如下：

• （语法支持）代码高亮，大纲信息，悬浮提示，代码格式化，错误信息标注功能
• （运行调试）提供编辑器右键菜单选项：在汇编语言的编辑器添加了“打开 dosbox，运行，调试”的三个选项
• 提供 diagnose错误信息标注功能：假如汇编未通过，会根据汇编器输出来标明错误信息与位置，可以在命令面板输入清除MASM/TASM的所有问题信息清除本插件输出的 diagnose 问题信息
• 支持包括 Web 在内的所有 VSCode 版本和平台，参见平台支持
• 注：该插件为学习 DOS 下的汇编语言开发，可能并不适合复杂的多文件汇编

DEMO 示例

Demo 1 代码格式化与错误输出

格式化代码	错误信息输出

提供一些“编程语言特性”（悬浮提示，代码格式化，跳到定义，查看引用）来方便代码编写与阅读，如果不喜欢可以在设置masmtasm.language.Hover，masmtasm.language.programmaticFeatures中关闭，重启之后会生效。同时也可以使用其他插件提供的语言功能如ASM Code Lens 提供的 language ID asm-collection

Demo 2 :running:: 运行调试代码

调用 DOSBox 运行 TASM	调用 msdos-player 运行 MASM

当打开一个ASM后缀的汇编文件时，可以在编辑器右击，会出现以下三个选项：

1. 打开 DOS 环境：打开 DOSBox，然后就可以手动在打开的 DOSBox 窗口输入指令进行操作
2. 运行当前程序(汇编+链接+运行)：生成 exe 程序并运行
3. 调试当前程序(汇编+链接+调试)：生成 exe 程序并调试，使用 MASM 则会调用 debug 调试，使用 TASM 会调用 td 调试

运行调试说明

• 如果所有汇编代码都存放在一个文件中，建议使用单文件模式将masmtasm.ASM.mode设置为single file，插件将会首先复制文件到插件的独立地址中，再进行操作。
• 如果代码非常复杂，建议设置masmtasm.ASM.mode为workspace，插件会直接挂载当前工作文件夹，可能会污染当天工作目录（对于 jsdos 会直接复制当前文件夹中的所有文件）。

平台支持

插件依赖vscode-dosbox 来与 DOS 模拟器交互。 vscode-dosbox打包了 win 平台上的二进制文件，参考它的文档 在其他平台安装相关 DOS 模拟器。

自定义 Actions

可以通过设置masmtasm.ASM.actions来修改运行和调试的 DOS 命令。比如，需要编译成 COM 文件，可以添加如下设置。同时将masmtasm.ASM.assembler设置为 Action 的键TASM-com

"masmtasm.ASM.actions": {
     "TASM-com": {
      "baseBundle": "<built-in>/TASM.jsdos",
      "before": [
        "set PATH=C:\\TASM"
      ],
      "run": [
        "TASM ${file}",
        "TLINK /t ${filename}",
        "${filename}"
      ],
      "debug": [
        "TASM /zi ${file}",
        "TLINK /t/v/3 ${filename}.obj",
        "TD ${filename}.exe"
      ]
    }
}
"masmtasm.ASM.assembler":"TASM-com"

插件调用 dosbox 时会挂载哪些目录

编译成 COM 文件

插件安装路径一般在哪里

VSCode 文档中关于插件安装路径的说明VSCode-doc，摘录如下

• Windows %USERPROFILE%\.vscode\extensions
• macOS ~/.vscode/extensions
• Linux ~/.vscode/extensions

文档 & 感谢 & 许可

• 感谢南邮的《微型计算机原理与接口技术》课程
• 该插件受Woodykaixa的 masm-code启发
• 插件通过DOSBox、caiiiycuk的JS DOS 和MSDOS player模拟 DOS 环境
• 插件使用了Roncho的Assembly (TASM)中的汇编语法信息
• 一些相关信息和鸣谢
• gitee 上的一些笔记和代码: 笔记,代码
• 一些相关资料：wiki
• 插件难免会有一些 bug，欢迎到 github 发issue或者邮件xsro@foxmail.com，一起交流和完善。

Enjoy!