什么是cl.exe?
cl.exe(Compile and Link.exe) 是一个控制 Microsoft C++ (MSVC) C 和 C++ 编译器和链接器的工具。 cl.exe 只能在支持 Microsoft Visual Studio for Windows 的操作系统上运行。
编译器生成通用对象文件格式 (COFF) 对象 (.obj) 文件。 链接器生成可执行文件 (.exe) 文件或动态链接库 (DLL)。
所有编译器选项均区分大小写。 可以使用正斜杠 (/
) 或短划线 (-
) 指定编译器选项。
若要在不链接的情况下进行编译,请使用 /c 选项。
备注:
只能从 Visual Studio 开发人员命令提示启动此工具。 不能从系统命令提示符或从文件资源管理器启动此工具。 有关详细信息,请参阅通过命令行使用 MSVC 工具集。
如何通过命令行来运行cl.exe?
安装Visual Studio以及C和C++支持
在 Visual Studio 中安装 C 和 C++ 支持 | Microsoft Learn
cl.exe是MSVC的一部分,安装完之后,你可以在MSVC的bin目录下的子目录找到它。
一共四个版本,Hostx64-x64,Hostx64-x86,Hostx86-x64,Hostx86-x86,下图是其中一个:
如果你安装了VS Code和CMake Tools插件,也可以查到到对应4个版本的MSCV的cl.exe编译器,如下图所示:
X64\X86\X86-64的区别
x86是指intel的开发的一种32位指令集,从386开始时代开始的,一直沿用至今,是一种cisc指令集,所有intel早期的cpu,amd早期的cpu都支持这种指令集,ntel官方文档里面称为“IA-32”
x86_64是x86 CPU开始迈向64位的时候,有2选择:1、向下兼容x86。2、完全重新设计指令集,不兼容x86。AMD抢跑了,比Intel率先制造出了商用的兼容x86的CPU,AMD称之为AMD64,抢了64位PC的第一桶金,得到了用户的认同。而Intel选择了设计一种不兼容x86的全新64为指令集,称之为IA-64(这玩意似乎就是安腾),但是比amd晚了一步,而且IA-64也挺惨淡的,因为是全新设计的CPU,没有编译器,也不支持windows(微软把intel给忽悠了,承诺了会出安腾版windows server版,但是迟迟拿不出东西)。。。后来不得不在时机落后的情况下也开始支持AMD64的指令集,但是换了个名字,叫x86_64,表示是x86指令集的64扩展,大概是不愿意承认这玩意是AMD设计出来的。
也就是说实际上,x86_64,x64,AMD64基本上是同一个东西,我们现在用的intel/amd的桌面级CPU基本上都是x86_64。
添加cl.exe所在目录到系统变量“Path”
通过我的电脑属性查看你当前机器使用的CPU类型:
我笔记本使用的是Intel 64位的CPU,因此我这里会使用bin的.\Hostx86\x64\子目录下的cl.exe。
因此把该目录添加到系统变量“Path”中:
打开一个新的命令行窗口,输入“cl”按回车,就可以显示当前cl.exe对应的版本:
如何使用cl.exe命令?
MSVC 编译器命令行语法 | Microsoft Learn
C:\Users\Laolang>cl /?
用于 x64 的 Microsoft (R) C/C++ 优化编译器 19.36.32537 版
版权所有(C) Microsoft Corporation。保留所有权利。
C/C++ 编译器选项
-优化-
/O1 最大优化(优选空间) /O2 最大优化(优选速度)
/Ob<n> 内联扩展(默认 n=0) /Od 禁用优化(默认)
/Og 启用全局优化 /Oi[-] 启用内部函数
/Os 优选代码空间 /Ot 优选代码速度
/Ox 优化(优选速度)
/favor:<blend|AMD64|INTEL64|ATOM> 选择优化所针对的处理器,为以下值之一:
blend - 针对几种不同 x64 处理器的优化组合
AMD64 - 64 位 AMD 处理器
INTEL64 - Intel(R)64 架构处理器
ATOM - Intel(R) Atom(TM) 处理器
-代码生成-
/Gu[-] 确保 distinct 函数具有非重复地址 /Gw[-] 分隔链接器的全局变量
/GF 启用只读字符串池 /Gm[-] 启用最小重新生成
/Gy[-] 分隔链接器函数 /GS[-] 启用安全检查
/GR[-] 启用 C++ RTTI /GX[-] 启用 C++ EH (与 /EHsc 相同)
/guard:cf[-] 启用 CFG (控制流保护) /guard:ehcont[-] 启用 EH 继续元数据(CET)
/EHs 启用 C++ EH (没有 SEH 异常) /EHa 启用 C++ EH (w/ SEH 异常)
/EHc 外部 "C" 默认为 nothrow /EHr 始终生成 noexcept 运行时终止检查
/fp:<contract|except[-]|fast|precise|strict> 选择浮点模型:
协定 - 生成代码时考虑浮点收缩 except[-] - 在生成代码时考虑浮点异常
fast - "fast" 浮点模型;结果可预测性比较低
precise - "precise" 浮点模型;结果可预测
strict - "strict" 浮点模型(意味着 /fp:except)
即使使用 /fp:except,/Qfast_transcendentals 也生成内联内部 FP
/Qspectre[-] 对 CVE 2017-5753 启用缓解措施
/Qpar[-] 启用并行代码生成
/Qpar-report:1 自动并行化诊断;指示已并行化循环
/Qpar-report:2 自动并行化诊断;指示未并行化循环
/Qvec-report:1 自动向量化诊断;指示已向量化循环
/Qvec-report:2 自动向量化诊断;指示未向量化循环
/GL[-] 启用链接时代码生成 /volatile:<iso|ms> 选择可变模型:
iso - Acquire/release 语义对可变访问不一定有效
ms - Acquire/release 语义对可变访问一定有效
/GA 为 Windows 应用程序进行优化 /Ge 对所有函数强制堆栈检查
/Gs[num] 控制堆栈检查调用 /Gh 启用 _penter 函数调用
/GH 启用 _pexit 函数调用 /GT 生成纤程安全 TLS 访问
/RTC1 启用快速检查(/RTCsu) /RTCc 转换为较小的类型检查
/RTCs 堆栈帧运行时检查 /RTCu 未初始化的局部用法检查
/clr[:option] 为公共语言运行时编译,其中 option 是:
pure : 生成仅包含 IL 的输出文件(没有本机可执行代码)
safe : 生成只包含 IL 的可验证输出文件
netcore : 生成以 .NET Core 运行时为目标的程序集
noAssembly : 不生成程序集
nostdlib : 搜索程序集时忽略系统 .NET Framework 目录
nostdimport : 不隐式导入任何必需的程序集
(按回车键继续)
initialAppDomain : 启用 Visual C++ 2002 的初始 AppDomain 行为
implicitKeepAlive- : 关闭 System::GC::KeepAlive(this)的隐式值
/fsanitize=解决启用地址消毒代码生成
/homeparams 强制将传入寄存器的参数写入到堆栈中
/GZ 启用堆栈检查(/RTCs) /Gv __vectorcall 调用约定
/arch:<AVX|AVX2|AVX512> 最小 CPU 架构要求,以下之一:
AVX - 允许使用支持 AVX 的 CPU 可用的指令
AVX2 - 允许使用支持 AVX2 的 CPU 可用的指令
AVX512 - 允许使用支持 AVX-512 的 CPU 可用的指令
/QIntel-jcc-erratum 为 Intel JCC Erratum 启用缓解措施
/Qspectre-load 对加载内存的所有指令启用 spectre 缓解措施
/Qspectre-load-cf 对加载内存的所有控制流指令启用 spectre 缓解措施
/Qspectre-jmp[-] 为无条件跳转指令启用 Spectre 缓解
/fpcvt:<IA|BC> 无符号整数转换兼容性为 FP IA - 与 VCVTTSD2USI 指令兼容的结果
BC - 与 VS2017 及更低版本的编译器兼容的结果
-输出文件-
/Fa[file] 命名程序集列表文件 /FA[scu] 配置程序集列表
/Fd[file] 命名 .PDB 文件 /Fe<file> 命名可执行文件
/Fm[file] 命名映射文件 /Fo<file> 命名对象文件
/Fp<file> 命名预编译头文件 /Fr[file] 命名源浏览器文件
/FR[file] 命名扩展 .SBR 文件 /Fi[file] 命名预处理的文件
/Fd: <file> 命名 .PDB 文件 /Fe: <file> 命名可执行文件
/Fm: <file> 命名映射文件 /Fo: <file> 命名对象文件
/Fp: <file> 命名 .PCH 文件 /FR: <file> 命名扩展 .SBR 文件
/Fi: <file> 命名预处理的文件 /Ft<dir> 为 #import 生成的头文件的地址
/doc[file] 处理 XML 文档注释,并可选择命名 .xdc 文件
-预处理器-
/AI<dir> 添加到程序集搜索路径 /FU<file> 强制使用程序集/模块
/C 不抽出注释 /D<name>{=|#}<text> 定义宏
/E 预处理到 stdout /EP 预处理到 stdout,无行号
/P 预处理到文件 /Fx 将插入的代码合并到文件中
/FI<file> 命名强制包含文件 /U<name> 移除预定义的宏
/u 移除所有预定义的宏 /I<dir> 添加到包含搜索路径
/X 忽略“标准位置” /PH 在预处理时生成 #pragma file_hash
/PD 打印所有宏定义
-语言-
/std:<c++14|c++17|c++20|c++latest> C++ 标准版
c++14 - ISO/IEC 14882:2014 (默认值)
c++17 - ISO/IEC 14882:2017
c++20 - ISO/IEC 14882:2020
c++latest - 最新草案标准(功能集可能更改)
/permissive[-] 使某些非符合代码可编译(功能集可更改)(默认开启)
/Ze 启用扩展(默认) /Za 禁用扩展
/ZW 启用 WinRT 语言扩展 /Zs 只进行语法检查
/Zc:arg1[,arg2] C++ 语言合规性,这里的参数可以是:
forScope[-] 对范围规则强制使用标准 C++
wchar_t[-] wchar_t 是本机类型,不是 typedef
auto[-] 对 auto 强制使用新的标准 C++ 含义
trigraphs[-] 启用三元祖(默认关闭)
rvalueCast[-] 强制实施标准 C++ 显式类型转换规则
strictStrings[-] 禁用从字符串文本到 [char|wchar_t]*
的转换(默认关闭)
implicitNoexcept[-] 在必需的函数上启用隐式 noexcept
threadSafeInit[-] 启用线程安全的本地静态初始化
(按回车键继续)
inline[-] 如果是 COMDAT,则删除未引用的函数或数据
或仅使用内部链接(默认关闭)
sizedDealloc[-] 启用 C++14 全局大小解除分配
函数(默认开启)
throwingNew[-] 假设运算符 new 在故障时引发(默认关闭)
referenceBinding[-] 临时引用不会绑定到非常数
lvalue 引用(默认关闭)
twoPhase- 禁用两阶段名称查找
ternary[-] 对条件运算符强制使用 C++11 规则(默认关闭)
noexceptTypes[-] 强制执行 C++17 noexcept 规则(在 C++17 或更高版本中默认开启)
alignedNew[-] 对动态分配的对象启用 C++17 对齐方式(默认开启)
hiddenFriend[-] 强制实施标准 C++ 隐藏好友规则(/permissive- 所隐含)
externC[-] 强制实施外部 "C" 函数的标准 C++ 规则(/permissive- 所隐含)
lambda[-] 使用更新的 lambda 处理器提供更好的 lambda 支持(默认为关闭)
tlsGuards[-] 生成 TLS 变量初始化的运行时检查(默认情况下启用)
zeroSizeArrayNew[-] 针对大小为零的对象数组的调用对象 new/delete (默认启用)
static_assert[-] 严格处理 "static_assert" (由 /permissive- 隐含)
gotoScope[-] 无法跳过变量的初始化(由 /permissive- 暗示)
templateScope[-] 强制执行标准 C++ 模板参数阴影规则
enumTypes[-] 启用标准 C++ 基础枚举类型(默认情况下关闭)
checkGwOdr[-] 强制执行标准 C++ 一个定义规则冲突
当 /Gw 已启用时(默认关闭)
__STDC__在 C 中将 __STDC__ 定义为 1
/await 启用可恢复函数扩展
/await:strict 启用使用早期语言版本的标准 C++20 协同例程支持
/constexpr:depth<N> constexpr 评估的递归深度限制(默认值: 512)
/constexpr:backtrace<N> 在诊断中显示 N constexpr 评估(默认值: 10)
/constexpr:steps<N> 在 N 个步骤后终止 constexpr 评估(默认值: 100000)
/Zi 启用调试信息 /Z7 启用旧式调试信息
/Zo[-] 为优化的代码生成更丰富的调试信息(默认开启)
/ZH:[MD5|SHA1|SHA_256] 哈希算法,用于在调试信息中计算文件校验和(默认值: SHA_256)
/Zp[n] 在 n 字节边界上包装结构 /Zl 省略 .OBJ 中的默认库名
/vd{0|1|2} 禁用/启用 vtordisp /vm<x> 指向成员的指针类型
/std:<c11|c17> C 标准版本
c11 - ISO/IEC 9899:2011
c17 - ISO/IEC 9899:2018
/ZI 启用“编辑并继续”调试信息 /openmp 启用 OpenMP 2.0 语言扩展
/openmp:experimental 会启用 OpenMP 2.0 语言扩展并选择 OpenMP 3.0+ 语言扩展
使用 LLVM 运行时 /openmp:llvm OpenMP 语言扩展
- 杂项 -
@<file> 选项响应文件 /?, /help 打印此帮助消息
/bigobj 生成扩展的对象格式 /c 只编译,不链接
/errorReport:option 已弃用。请将内部编译器错误报告给 Microsoft
none - 不发送报告 prompt - 提示立即发送报告
queue - 在下一次管理员登录时,提示发送报告(默认)
send - 自动发送报告 /FC 诊断中使用完整路径名
/H<num> 最大外部名称长度 /J 默认 char 类型是 unsigned
/MP[n] 最多使用“n”个进程进行编译 /nologo 取消显示版权信息
/showIncludes 显示包含文件名 /Tc<source file> 将文件编译为 .c
/Tp<source file> 将文件编译为 .cpp /TC 将所有文件编译为 .c
/TP 将所有文件编译为 .cpp /V<string> 设置版本字符串
/Yc[file] 创建 .PCH 文件 /Yd 将调试信息放在每个 .OBJ 中
/Yl[sym] 为调试库插入 .PCH 引用 /Yu[file] 使用 .PCH 文件
/Y- 禁用所有 PCH 选项 /Zm<n> 最大内存分配(默认值的百分比)
/FS 强制使用 MSPDBSRV.EXE
/source-charset:<iana-name>|.nnnn 集源字符集
/execution-charset:<iana-name>|.nnnn 集执行字符集
/utf-8 集源和到 UTF-8 的执行字符集
/validate-charset[-] 验证 UTF-8 文件是否只有合法字符
/fastfail[-] 启用 fast-fail 模式 /JMC[-] 启用本机“仅我的代码”
(按回车键继续)
/presetPadding[-] 将基于堆栈的类类型的填充初始化为零
/volatileMetadata[-] 对易失存储器访问生成元数据
/sourcelink [file] 包含源链接信息的文件
-链接-
/LD 创建 .DLL /LDd 创建 .DLL 调试库
/LN 创建 .netmodule /F<num> 设置堆栈大小
/link [链接器选项和库] /MD 与 MSVCRT.LIB 链接
/MT 与 LIBCMT.LIB 链接 /MDd 与 MSVCRTD.LIB 调试库链接
/MTd 与 LIBCMTD.LIB 调试库链接
-代码分析-
/analyze[-] 启用本机分析 /analyze:quiet[-] 没有对控制台的警告
/analyze:log<name> 对文件的警告 /analyze:autolog Log to *.pftlog
/analyze:autolog:ext<ext> Log to *.<ext>/analyze:autolog- 无日志文件
/analyze:WX- 警告不严重 /analyze:stacksize<num> 最大堆栈帧
/analyze:max_paths<num> 最大路径 /analyze:only Analyze, no code gen
-诊断-
/diagnostics:<args,...> 控制诊断消息的格式:
传统型 - 保留之前的格式
列[-] - 打印列信息
脱字号[-] - 打印列和源的指示行
/Wall 启用所有警告 /w 禁用所有警告
/W<n> 设置警告等级(默认 n=1)
/Wv:xx[.yy[.zzzzz]] 禁用在 xx.yy.zzzzz 版本后引入的警告功能
/WX 将警告视为错误 /WL 启用单行诊断
/wd<n> 禁用警告 n /we<n> 将警告 n 视为错误
/wo<n> 发出一次警告 n /w<l><n> 为 n 设置警告等级 1-4
/external:I <path> - 外部标头的位置
/external:env:<var> - 外部标头位置的环境变量
/external:anglebrackets - 将所有通过 <> 包含的标头视为外部
/external:W<n> - 外部标头的警告等级
/external:templates[-] - 跨模板实例化链评估警告级别
/sdl 支持其他安全功能和警告
/选项: 严格无法识别的编译器选项是一个错误
“hello csdn”验证cl.exe是否正常工作
#include <iostream>
using namespace std;
int main() {
cout << "hello, CSDN" << endl;
return 0;
}
进入源代码所在的目录,通过cl.exe编译和生成exe可执行文件:
这里会提示找不到iostream头文件,说明默认情况下,cl.exe是无法找到C++内置的标准库,解决方法如下:
1)添加 LIB 系统环境变量
2)添加 INCLUDE 系统环境变量
再次运行“cl hello.cpp /EHsc”,这时编译器可以找到iostream等基本的头文件,但因为缺少一些库还是不能正常编译。
“crtdbg.h”头文件在Windows Kits的ucrt子目录下可以找到(D:\Windows Kits\10\Include\10.0.22000.0\ucrt):
修改前面添加的 LIB 系统变量为:
D:\Program Files\Microsoft Visual Studio\2022\Community\VC\Tools\MSVC\14.36.32532\lib\x64;D:\Windows Kits\10\Lib\10.0.22000.0\ucrt\x64;D:\Windows Kits\10\Lib\10.0.22000.0\um\x64;D:\Windows Kits\10\Lib\10.0.22000.0\ucrt_enclave\x64;
修改前面添加的 INCLUDE 系统变量为:
D:\Program Files\Microsoft Visual Studio\2022\Community\VC\Tools\MSVC\14.36.32532\include;D:\Windows Kits\10\Include\10.0.22000.0\ucrt;D:\Windows Kits\10\Include\10.0.22000.0\um;D:\Windows Kits\10\Include\10.0.22000.0\winrt;D:\Windows Kits\10\Include\10.0.22000.0\shared;D:\Windows Kits\10\Include\10.0.22000.0\cppwinrt;
修改完,并保存确认生效,然后启动一个新的命令行窗口,再次运行“cl hello.cpp /EHsc”命令,这时候编译成功啦。
编译并直接运行:
备注:
这里使用EH参数,该参数的含义可以阅读:
查看自定义类的内存模型
#include <iostream>
class A
{
public:
virtual void test() { std::cout << "this is a test from A" << std::endl; };
};
class B : public A {
public:
void test() { std::cout << "this is a test from B" << std::endl; };
};
int main()
{
A a;
a.test();
B b;
b.test();
return 0;
}
# 查看类A的内存模型
D:\my_project\VCXXTutorials\cl.exe命令使用\CLExeDemo>cl.exe CPPTest.cpp /d1 reportSingleClassLayoutA
# 查看类B的内存模型
D:\my_project\VCXXTutorials\cl.exe命令使用\CLExeDemo>cl.exe CPPTest.cpp /d1 reportSingleClassLayoutB
类A拥有一个名为test的虚函数,类A的实例对象大小为8个字节。
类B是类A的子类,也拥有一个名为test的虚函数,类B的实例大小也为8个字节。