MSVC C/C++编译器选项 cl命令参数

水深无声 2023-07-14 05:45 71阅读 0赞

## 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 支持其他安全功能和警告