开源软件名称：

VSCode下DOS汇编插件

开源软件地址：

https://gitee.com/dosasm/masm-tasm

开源软件介绍：

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

中文|English

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

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

DEMO 示例

jsdos 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后缀的汇编文件时，可以在编辑器右击，会出现以下三个选项：

打开 DOS 环境：打开 DOSBox，然后就可以手动在打开的 DOSBox 窗口输入指令进行操作
运行当前程序(汇编+链接+运行)：生成 exe 程序并运行
调试当前程序(汇编+链接+调试)：生成 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"