如何安装 masm32 并使用 ml.exe 将 asm 文件转换为 exe?
这段代码是 16 位 DOS 程序。要保留 .MODEL small 和 int 21h,需要先用 ml.exe 生成 OMF 格式的目标文件,再用支持 16 位 DOS 程序的链接器生成 EXE。MASM32 常用的 Win32 链接流程不能直接用于这段代码。
下载的文件中没有 masm.exe 或 ml64.exe,并不代表安装有误。这里需要的汇编器是 ml.exe;ml64.exe 用于 x64 汇编,这段代码用不到它。
如何安装和检查 MASM32
从 MASM32 项目网站 下载安装包,按提示完成安装。以下示例假定安装目录为:
C:\masm32
安装后,检查这些常用文件和目录是否存在:
C:\masm32\bin\ml.exe
C:\masm32\bin\link.exe
C:\masm32\include
C:\masm32\lib
在 Windows 命令提示符 cmd.exe 中查看工具帮助:
C:\masm32\bin\ml.exe /?
C:\masm32\bin\link.exe /?
使用完整路径可以避免误调用其他开发工具中的同名程序,无需安装 VS Code,也不必先配置 PATH。
下面的命令都使用 cmd.exe 语法。如果 Windows Terminal 当前打开的是 PowerShell,可以先输入 cmd,进入命令提示符后再执行。
先修正程序中的两个问题
DOS 加载这种 EXE 时,不能假定 DS 已指向 .data。访问 message 前,需要先初始化数据段:
mov ax, @data
mov ds, ax
另一个问题是,int 21h 的字符串输出功能要求 AH = 09h。原来的指令:
mov ax, 0009h
会将 AH 设为 00h、AL 设为 09h,没有选中字符串输出功能。应改为:
mov ah, 09h
将下面的代码保存为 hello.asm:
.MODEL small
.STACK 100h
.data
message BYTE "hello world", "$"
.code
_start:
mov ax, @data
mov ds, ax
mov ah, 09h
lea dx, message
int 21h
mov ax, 4C00h
int 21h
END _start
入口标签是 _start,前面没有反斜杠。如果文件中写的是 \_start,应删除 \。
字符串末尾的 $ 是 DOS int 21h、AH=09h 要求的结束标记,不会被打印。
使用 ml.exe 生成 OBJ 文件
进入 hello.asm 所在目录,执行:
C:\masm32\bin\ml.exe /c /omf /Fohello.obj hello.asm
各参数的含义如下:
| 参数 | 作用 |
|---|---|
/c |
只汇编,不自动调用链接器 |
/omf |
生成 OMF 格式的目标文件 |
/Fohello.obj |
指定目标文件名 |
hello.asm |
输入的汇编源文件 |
执行成功后会得到 hello.obj,此时还需要链接才能生成可执行文件。
这条命令适用于支持 /omf 的 ml.exe。如果工具不接受该参数,先检查版本和 /? 输出,确认调用的是 MASM32 安装目录中的工具。不要改用 /coff 构建这段 DOS 程序,它对应另一套目标文件格式和链接流程。
使用 16 位链接器生成 EXE
链接器需要支持 16 位 OMF 输入和 DOS MZ EXE 输出。MASM32 常用的 Win32 link.exe 无法完成这一步。应查看所用工具的帮助和随附文档,确认它的用途,不能只看文件名。
假设已经准备好兼容的 Microsoft 16 位分段链接器,并将其命名、保存为:
C:\tools\link16.exe
执行:
C:\tools\link16.exe hello.obj,hello.exe;
这条命令使用旧式 Microsoft LINK 的语法:
hello.obj是输入目标文件。hello.exe是输出文件。- 末尾的
;表示其余字段使用默认值,避免继续交互询问。
link16.exe 这个名字是为了区分不同的链接器。将 Win32 的 link.exe 重命名为 link16.exe,不会让它获得 16 位链接能力。如果使用其他兼容链接器,需要按该工具的参数语法执行。
完整的两步构建命令为:
C:\masm32\bin\ml.exe /c /omf /Fohello.obj hello.asm
C:\tools\link16.exe hello.obj,hello.exe;
这份程序没有引用外部库,不需要添加 MASM32 的 Win32 库文件。
fixup errors 应该怎样排查
Fixup 与地址重定位有关。汇编器生成目标文件时,会留下需要链接器处理的地址信息。目标格式、地址宽度或链接器能力不匹配,都可能导致这类错误。
缺少完整错误文本,目前还无法确定具体原因。这份程序可以优先检查以下几项:
- 是否用 Win32 链接器处理了 16 位目标文件。
- 是否加入了
/coff,或沿用了面向 Win32 的构建脚本。 - 修改参数后,是否重新生成了
hello.obj,避免继续链接旧文件。
使用 /c 将汇编和链接分开,可以判断错误发生在哪一步。执行 ml hello.asm 时,ml.exe 可能自动调用链接器,所以看起来由 ml.exe 报出的错误,也可能发生在链接阶段。
初始化 DS 和设置 AH=09h 解决的是运行时错误;如果选错了链接器,还需要单独处理。
生成的 hello.exe 能否直接运行
这个 hello.exe 是 16 位 DOS 可执行文件。64 位 Windows 不提供直接运行这类程序所需的 NTVDM,因此即使成功生成 EXE,通常也需要 DOSBox 一类的 DOS 运行环境。内置终端只是命令行界面,不会提供 DOS 中断服务。
要保留原代码,需要准备兼容的 16 位链接器和能够运行 DOS 程序的环境。如果想使用 MASM32 的常规 Win32 工具链,并让程序直接在 Windows 中运行,就需要将它改写为 32 位 Windows 程序,使用 Windows API 输出文字和退出进程。仅把 .MODEL small 改成 .MODEL flat,无法让 int 21h 在 Win32 程序中工作。
备注:内容仅供参考。
