ML 和 ML64 命令行参考

汇编和链接一个或多个汇编语言源文件。 命令行选项区分大小写。

有关 ml64.exe 的详细信息，请参阅适用于 x64 的 MASM (ml64.exe)。

语法

ML [options] filename [ [options] filename]

ML64 [options] filename [ [options] filename] ...[/link link_options]

参数

options
选项在下表中列出：

选项	操作
/AT	启用微型内存模型支持。 为违反 .com 格式文件要求的代码构造启用错误消息。 此选项不等效于.MODELTINY指令。 在 ml64.exe 中不可用。
/Bl filename	在 filename 中选择备用链接器。
/c	仅进行汇编。 不进行链接。
/coff	生成对象模块的通用对象文件格式 (COFF) 类型。 Win32 汇编语言开发所需。 在 ml64.exe 中不可用。
/Cp	保留所有用户标识符的大小写。
/Cu	将所有标识符都映射为大写（默认）。 在 ml64.exe 中不可用。
/Cx	保留公共符号和外部符号中的大小写。
/Dsymbol⟦=value⟧	定义具有给定名称 symbol 的文本宏。 如果 value 缺失，则为空。 用空格分隔的多个标记必须用引号引起来。
/EP	生成预处理源列表（发送到 STDOUT）。 请参阅 /Sf。
/ERRORREPORT[ NONESEND | | PROMPT | QUEUE]	已弃用。 错误报告由 Windows 错误报告 (WER) 设置控制。
/F hexnum	将堆栈大小设置为 hexnum 字节（与 /link /STACK:<number> 相同）。 值必须以十六进制表示法表示。 在 /F 和 hexnum 之间必须留一个空格。
/Fe filename	命名可执行文件。
/Flfilename⟦⟧	生成汇编代码列表。 请参阅 /Sf。
/Fmfilename⟦⟧	创建链接器映射文件。
/Fo filename	为对象文件命名。 有关更多信息，请参见备注。
/FPi	为浮点算术生成仿真器修复（仅限混合语言）。 在 ml64.exe 中不可用。
/Frfilename⟦⟧	生成源浏览器 .sbr 文件。
/FRfilename⟦⟧	生成源浏览器 .sbr 文件的扩展形式。
/Gc	指定对函数调用和名称使用 FORTRAN 或 Pascal 样式约定。 与 OPTION LANGUAGE:PASCAL 相同。 在 ml64.exe 中不可用。
/Gd	指定对函数调用和名称使用 C 样式约定。 与 OPTION LANGUAGE:C 相同。 在 ml64.exe 中不可用。
/Gz	指定对函数调用和名称使用 __stdcall 约定。 与 OPTION LANGUAGE:STDCALL 相同。 在 ml64.exe 中不可用。
/H number	将外部名称限制为 number 个重要字符。 默认为 31 个字符。 在 ml64.exe 中不可用。
/help	显示 ML 命令行语法和选项的摘要。
/I pathname	设置 include 文件的路径。 最多允许 10 个 /I 选项。
/nologo	禁止显示成功进行汇编的消息。
/omf	生成对象模块文件格式 (OMF) 类型的对象模块。 /omf 意味着 /c。 ML.exe 不支持链接 OMF 对象。 在 ml64.exe 中不可用。
/quiet	禁止显示“汇编”消息。 在 Visual Studio 17.6 及更高版本中可用。
/Sa	启用列出所有可用信息的功能。
/safeseh	标记对象文件：它不包含任何异常处理程序，或者它包含全都使用 .SAFESEH 进行声明的异常处理程序。 在 ml64.exe 中不可用。
/Sf	将第一遍列表添加到列表文件。
/Sl width	在每行字符数中将源列表的行宽设置为 width。 范围为 60-255 或 0。 默认为 0。 与 PAGE width.
/Sn	生成列表时禁用符号表。
/Sp length	在每页行数中将源列表的页面长度设置为 length。 范围为 10-255 或 0。 默认为 0。 与 PAGE length.
/Ss text	指定源列表的文本。 与 SUBTITLE 文本相同。
/St text	指定源列表的标题。 与 TITLE 文本相同。
/Sx	在列表中启用 false 条件。
/Ta filename	汇编其名称不以 .asm 扩展名结尾的源文件。
/w	与 /W0 /WX 相同。
/W level	设置警告级别，其中 level = 0、1、2 或 3。
/WX	如果生成警告，则返回错误代码。
/X	忽略 INCLUDE 环境路径。
/Zd	生成对象文件中的行号信息。
/Zf	将所有符号公开。
/ZH:MD5	在调试信息中将 MD5 用于校验和。
/ZH:SHA_256	在调试信息中将 SHA256 用于校验和（Visual Studio 2022 版本 17.0 及更高版本中的默认设置）。
/Zi	在对象文件中生成 CodeView 信息。
/Zm	启用 M510 选项以尽量与 MASM 5.1 兼容。 在 ml64.exe 中不可用。
/Zpalignment⟦⟧	打包指定字节边界上的结构。 alignment 可以是 1、2、4、8 或 16。
/Zs	仅执行语法检查。
/?	显示 ML 命令行语法和选项的摘要。

filename
文件的名称。

link_options
链接选项。 有关详细信息，请参阅链接器选项。

备注

ML 和 ML64 的一些命令行选项跟放置相关。 例如，由于 ML 和 ML64 可以接受多个 /c 选项，因此必须在 /c 之前指定任何相应的 /Fo 选项。 以下命令行示例演示每个程序集文件规范的对象文件规范：

ml.exe /Fo a1.obj /c a.asm /Fo b1.obj /c b.asm

环境变量

变量	说明
INCLUDE	指定 include 文件的搜索路径。
ML	指定默认命令行选项。
TMP	指定临时文件的路径。

另请参阅

ML 错误消息
Microsoft 宏汇编程序参考