MSVC C/C++编译器选项 cl命令参数
宇文飞翮
C/C++ 编译器选项
-优化-
/O1 最大优化(优选空间) /O2 最大优化(优选速度)
/Ob<n> 内联扩展(默认 n=0) /Od 禁用优化(默认)
/Og 启用全局优化 /Oi[-] 启用内部函数
/Os 优选代码空间 /Ot 优选代码速度
/Ox 优化(优选速度) /Oy[-] 启用帧指针省略
/favor:<blend|ATOM> 选择优化所针对的处理器，为以下值之一:
blend - 针对几种不同 x86 处理器的优化组合
ATOM - Intel(R) Atom(TM) 处理器
-代码生成-
/Gu[-] 确保 distinct 函数具有非重复地址 /Gw[-] 分隔链接器的全局变量
/GF 启用只读字符串池 /Gm[-] 启用最小重新生成
/Gy[-] 分隔链接器函数 /GS[-] 启用安全检查
/GR[-] 启用 C++ RTTI /GX[-] 启用 C++ EH (与 /EHsc 相同)
/guard:cf[-] 启用 CFG (控制流保护) /EHs 启用 C++ EH (没有 SEH 异常)
/EHa 启用 C++ EH (w/ SEH 异常) /EHc 外部 "C" 默认为 nothrow
/EHr 始终生成 noexcept 运行时终止检查
/fp:<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 Runtime 的程序集
noAssembly - 不产生程序集
nostdlib - 搜索程序集时忽略系统 .NET Framework 目录
nostdimport - 不隐式导入任何必需的程序集
initialAppDomain - 启用 Visual C++ 2002 的初始 AppDomain 行为
/Gd __cdecl 调用约定 /Gr __fastcall 调用约定
/Gz __stdcall 调用约定 /GZ 启用堆栈检查(/RTCs)
/Gv __vectorcall 调用约定 /QIfist[-] 使用 FIST 而不是 ftol()
/hotpatch 确保可热修补映像的函数填充
/arch:<IA32|SSE|SSE2|AVX|AVX2|AVX512> 最小 CPU 架构要求，以下之一:
IA32 - 不使用增强指令并将 x87 用于浮点
SSE - 允许使用支持 SSE 的 CPU 可用的指令
SSE2 - (默认)允许使用支持 SSE2 的 CPU 可用的指令
AVX - 允许使用支持 AVX 的 CPU 可用的指令
AVX2 - 允许使用支持 AVX2 的 CPU 可用的指令
AVX512 - 允许使用支持 AVX-512 的 CPU 可用的指令
/Qimprecise_fwaits 仅在“try”边界而不是“try”内部生成 FWAIT
/Qsafe_fp_loads 生成安全 FP 负载
/Qspectre-load Enable spectre mitigations for all instructions which load memory
/Qspectre-load-cf Enable spectre mitigations for all control-flow instructions which load memory
-输出文件-
/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> 命名预处理的文件
/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
-语言-
/std:<c++14|c++17|c++latest> C++ 标准版
c++14 – ISO/IEC 14882:2014 (默认)
c++17 – ISO/IEC 14882:2017
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 支持(默认为关闭)
/await 启用可恢复函数扩展
/constexpr:depth<N> constexpr 评估的递归深度限制(默认值: 512)
/constexpr:backtrace<N> 在诊断中显示 N constexpr 评估(默认值: 10)
/constexpr:steps<N> 在 N 个步骤后终止 constexpr 评估(默认值: 100000)
/Zi 启用调试信息 /Z7 启用旧式调试信息
/Zo[-] 为优化的代码生成更丰富的调试信息(默认开启)
/ZH:SHA_256 在调试信息(实验)中将 SHA256 用于文件校验和
/Zp[n] 在 n 字节边界上包装结构 /Zl 省略 .OBJ 中的默认库名
/vd{0|1|2} 禁用/启用 vtordisp /vm<x> 指向成员的指针类型
/ZI 启用“编辑并继续”调试信息 /openmp 启用 OpenMP 2.0 语言扩展
/openmp:experimental 会启用 OpenMP 2.0 语言扩展并选择 OpenMP 3.0+ 语言扩展
- 杂项 -
@<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[-] 启用本机“仅我的代码”
-链接-
/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 支持其他安全功能和警告
类似资料：