运行 LIB

各种命令行选项可用于控制 LIB。

LIB 命令行

若要运行 LIB,请键入命令 lib,然后键入正在使用 LIB 的任务的选项和文件名。 LIB 还接受命令文件中的命令行输入,这将在下一节中描述。 LIB 不使用环境变量。

LIB 命令文件

可以使用以下语法将命令行参数传递到命令文件中的 LIB:

LIB @command-file

command-file 文件是一个文本文件。 at 符号 (@) 与文件名之间不允许有空格或制表符。 command-file 名称没有默认扩展名。 指定完整文件名,包括任何扩展名。 无法使用通配符。 可以使用文件名指定绝对路径或相对路径。

在命令文件中,参数可以用空格或制表符分隔,因为它们可以在命令行上运行。 参数也可以用换行符分隔。 使用分号 (;) 标记批注。 LIB 忽略从分号到行尾的所有文本。

可以在命令文件中指定命令行的所有或部分,并且可以在 LIB 命令中使用多个命令文件。 LIB 接受命令文件输入,就像在命令行上的该位置指定一样。 不能嵌套命令文件。 除非使用 /NOLOGO 选项,否则 LIB 会回显命令文件的内容。

使用 LIB 选项

选项由选项说明符(短划线 (-) 或正斜杠 (/))及后跟的选项名构成。 选项名称不能缩写。 一些选项带有一个参数,在冒号 (:) 之后指定。 选项规范中禁止使用空格或制表符。 在命令行上使用一个或多个空格或制表符分隔选项规范。 选项名称及其关键字或文件名参数不区分大小写,但用作参数的标识符区分大小写。 LIB 按命令行和命令文件中指定的顺序处理选项。 如果使用不同参数重复某个选项,则要处理的最后一个选项优先。

以下选项适用于所有 LIB 模式:

/ERRORREPORT [NONE | PROMPT | QUEUE | SEND]

/ERRORREPORT 选项已弃用。 从 Windows Vista 开始,错误报告由 Windows 错误报告 (WER) 设置控制。

/LINKREPRO:directory-path
/LINKREPROTARGET:filename

为了帮助 Microsoft 诊断 lib.exe 崩溃和内部错误,你可以使用 /LINKREPRO 选项。 此选项会生成链接存储库,这是一组构建工件,允许 Microsoft 重现库操作期间发生的问题。 /LINKREPROTARGET 选项可以与 /LINKREPRO 选项一起使用。 此选项仅在 lib.exe 生成指定文件时生成链接再现工件。 有关详细信息,请参阅如何报告 Microsoft C++ 工具集的问题

/LTCG

“LTG”表示“链接时代码生成”。 此功能需要编译器 (cl.exe)、LIB 和链接器 (LINK) 之间的合作。 它们共同可以优化代码,超越了任何单独一个组件本身的能力范围。

LIB 的 /LTCG 选项指定来自 cl.exe 的输入包括使用 /GL 编译器选项生成的目标文件。 如果 LIB 遇到此类输入,并且未指定 /LTCG,它会在显示信息性消息后重新启动并启用 /LTCG。 换句话说,不需要显式设置此选项,但它会加快生成性能。 这是因为 LIB 不必重启自身。

在生成过程中,LIB 的输出将发送到 LINK。 LINK 有自己的单独的 /LTG 选项。 它用于执行各种优化,包括整个程序优化和配置文件引导优化 (PGO) 检测。 有关 LINK 选项的详细信息,请参阅 /LTG

/MACHINE

指定程序的目标平台。 通常,你不需要指定 /MACHINE。 LIB 从 .obj 文件推断机器类型。 但是,在某些情况下,LIB 无法确定计算机类型并发出错误消息。 如果发生此类错误,请指定 /MACHINE。 在 /EXTRACT 模式下,此选项仅用于验证。 在命令行中使用 lib /? 以查看可用的计算机类型。

/NOLOGO

禁止显示 LIB 版权消息和版本号,并阻止命令文件的回显。

/VERBOSE

显示有关会话进度的详细信息,包括正在添加的 .obj 文件的名称。 信息被发送到标准输出,并可重定向到文件。

/WX[:NO]

将警告视为错误。 有关详细信息,请参阅 /WX(将链接器警告视为错误)

其他选项仅适用于 LIB 的特定模式。 这些选项在描述每个模式的部分中进行了讨论。

另请参阅

LIB 引用