PAYATHON 2026

如何安装 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 与地址重定位有关。汇编器生成目标文件时,会留下需要链接器处理的地址信息。目标格式、地址宽度或链接器能力不匹配,都可能导致这类错误。

缺少完整错误文本,目前还无法确定具体原因。这份程序可以优先检查以下几项:

  1. 是否用 Win32 链接器处理了 16 位目标文件。
  2. 是否加入了 /coff,或沿用了面向 Win32 的构建脚本。
  3. 修改参数后,是否重新生成了 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 程序中工作。

备注:内容仅供参考。