CL 环境变量

CL 工具使用以下环境变量:

  • CL 和 _CL_(如果已定义)。 CL 工具会将 CL 环境变量中定义的选项和自变量预置到命令行自变量前面,并在处理之前附加 _CL_ 中定义的选项和自变量。

  • INCLUDE,必须指向 Visual Studio 安装的 \include 子目录。

  • LIBPATH,指定用于搜索使用 #using 引用的元数据文件的目录。 有关 LIBPATH 的详细信息,请参阅 #using

可以使用以下语法设置 CL 或 _CL_ 环境变量:

SET CL=[ [option] ... [file] ...] [/link link-opt ...]
SET _CL_=[ [option] ... [file] ...] [/link link-opt ...]

有关 CL 和 _CL_ 环境变量的自变量的详细信息,请参阅 MSVC 编译器命令行语法

你可以使用这些环境变量来定义你最常使用的文件和选项。 然后使用命令行为 CL 提供更多的文件和选项,以实现特定目的。 CL 和 _CL_ 环境变量上限为 1024 个字符(命令行输入上限)。

不能使用 /D 选项定义使用等号 (=) 的符号。 可以将等号替换为数字符号 (#)。 通过这种方式,可以使用 CL 或 _CL_ 环境变量定义具有显式值的预处理器常量(例如,/DDEBUG#1 可定义 DEBUG=1)。

有关详细信息,请参阅通过命令行使用 MSVC 工具集

示例

以下命令是设置 CL 环境变量的示例:

SET CL=/Zp2 /Ox /I\INCLUDE\MYINCLS \LIB\BINMODE.OBJ

设置 CL 环境变量时,如果在命令行输入 CL INPUT.C,则有效命令将变为:

CL /Zp2 /Ox /I\INCLUDE\MYINCLS \LIB\BINMODE.OBJ INPUT.C

下面的示例使普通 CL 命令编译源文件 FILE1.c 和 FILE2.c,然后链接对象文件 FILE1.obj、FILE2.obj 和 FILE3.obj:

SET CL=FILE1.C FILE2.C
SET _CL_=FILE3.OBJ
CL

这些环境变量使调用 CL 的效果与以下命令行相同:

CL FILE1.C FILE2.C FILE3.OBJ

另请参阅

设置编译器选项
MSVC 编译器选项