C# 编译器选项（Visual Studio配置）

- 日理万妓 2021-06-26 16:06 522阅读 0赞

下列编译器选项按类别排序。 关于按字母顺序排列的列表，请参阅按字母顺序列出的 C\# 编译器选项。  
\#\#优化

<table> 
 <thead> 
  <tr> 
   <th align="left">选项</th> 
   <th align="left">目标</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">-filealign</td> 
   <td align="left">指定输出文件中各节的大小。</td> 
  </tr> 
  <tr> 
   <td align="left">-optimize</td> 
   <td align="left">启用/禁用优化。</td> 
  </tr> 
 </tbody> 
</table>

\#\#输出文件

<table> 
 <thead> 
  <tr> 
   <th align="left">选项</th> 
   <th align="left">目标</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">-deterministic</td> 
   <td align="left">如果输入相同，则会导致编译器输出的程序集其二进制内容在整个编译中相同。</td> 
  </tr> 
  <tr> 
   <td align="left">-doc</td> 
   <td align="left">指定要将已处理的文档注释写入到的 XML 文件。</td> 
  </tr> 
  <tr> 
   <td align="left">-out</td> 
   <td align="left">指定输出文件。</td> 
  </tr> 
  <tr> 
   <td align="left">-pathmap</td> 
   <td align="left">指定编译器输出的源路径名的映射</td> 
  </tr> 
  <tr> 
   <td align="left">/pdb</td> 
   <td align="left">指定 .pdb 文件的文件名和位置。</td> 
  </tr> 
  <tr> 
   <td align="left">-platform</td> 
   <td align="left">指定输出平台。</td> 
  </tr> 
  <tr> 
   <td align="left">/preferreduilang</td> 
   <td align="left">指定编译器输出的语言。</td> 
  </tr> 
  <tr> 
   <td align="left">/refout</td> 
   <td align="left">除主程序集之外，还生成引用程序集。</td> 
  </tr> 
  <tr> 
   <td align="left">/refonly</td> 
   <td align="left">生成引用程序集，而不生成主程序集。</td> 
  </tr> 
  <tr> 
   <td align="left">-target</td> 
   <td align="left">使用下列五个选项之一指定输出文件的格式：-target:appcontainerexe、-target:exe、-target:library、-target:module、-target:winexe 或 -target:winmdobj。</td> 
  </tr> 
  <tr> 
   <td align="left"><code>-modulename:&lt;string&gt;</code></td> 
   <td align="left">指定源模块的名称</td> 
  </tr> 
 </tbody> 
</table>

\#\#.NET Framework 程序集

<table> 
 <thead> 
  <tr> 
   <th align="left">选项</th> 
   <th align="left">目标</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">-addmodule</td> 
   <td align="left">指定一个或多个模块作为此程序集的一部分。</td> 
  </tr> 
  <tr> 
   <td align="left">-delaysign</td> 
   <td align="left">指示编译器添加公钥，但将此程序集保留为未签名状态。</td> 
  </tr> 
  <tr> 
   <td align="left">-keycontainer</td> 
   <td align="left">指定加密密钥容器的名称。</td> 
  </tr> 
  <tr> 
   <td align="left"><code>-keyfile</code></td> 
   <td align="left">指定包含加密密钥的文件名。</td> 
  </tr> 
  <tr> 
   <td align="left">/lib</td> 
   <td align="left">指定通过 -reference 的方式引用的程序集的位置。</td> 
  </tr> 
  <tr> 
   <td align="left">-nostdlib</td> 
   <td align="left">指示编译器不导入标准库 (mscorlib.dll)。</td> 
  </tr> 
  <tr> 
   <td align="left">-publicsign</td> 
   <td align="left">应用公钥而不签名程序集，但在程序集中设置位，来表示程序集已签名。</td> 
  </tr> 
  <tr> 
   <td align="left">-reference</td> 
   <td align="left">从包含程序集的文件导入元数据。</td> 
  </tr> 
  <tr> 
   <td align="left">-analyzer</td> 
   <td align="left">从此程序集（缩写形式：/a）运行分析器</td> 
  </tr> 
  <tr> 
   <td align="left">-additionalfile</td> 
   <td align="left">命名其他文件，这些文件不会直接影响代码生成，但可能由分析器用于生成错误或警告。</td> 
  </tr> 
 </tbody> 
</table>

\#\#调试/错误检查

<table> 
 <thead> 
  <tr> 
   <th align="left">选项</th> 
   <th align="left">目标</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">-bugreport</td> 
   <td align="left">创建一个文件，其中包含可以轻松报告 bug 的信息。</td> 
  </tr> 
  <tr> 
   <td align="left">/checked</td> 
   <td align="left">指定溢出数据类型边界的整数算法是否将导致运行时异常。</td> 
  </tr> 
  <tr> 
   <td align="left">-debug</td> 
   <td align="left">指示编译器发出调试信息。</td> 
  </tr> 
  <tr> 
   <td align="left">-errorreport</td> 
   <td align="left">设置错误报告行为。</td> 
  </tr> 
  <tr> 
   <td align="left">/fullpaths</td> 
   <td align="left">指定编译器输出中文件的绝对路径。</td> 
  </tr> 
  <tr> 
   <td align="left">-nowarn</td> 
   <td align="left">取消编译器对指定警告的生成。</td> 
  </tr> 
  <tr> 
   <td align="left">/warn</td> 
   <td align="left">设置警告等级。</td> 
  </tr> 
  <tr> 
   <td align="left">-warnaserror</td> 
   <td align="left">将警告提升为错误。</td> 
  </tr> 
  <tr> 
   <td align="left"><code>-ruleset:&lt;file&gt;</code></td> 
   <td align="left">指定可禁用特定诊断的规则集文件。</td> 
  </tr> 
 </tbody> 
</table>

\#\#预处理器

<table> 
 <thead> 
  <tr> 
   <th align="left">选项</th> 
   <th align="left">目标</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">-define</td> 
   <td align="left">定义预处理器符号。</td> 
  </tr> 
 </tbody> 
</table>

\#\#资源

<table> 
 <thead> 
  <tr> 
   <th align="left">选项</th> 
   <th align="left">目标</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">-link</td> 
   <td align="left">使指定程序集中的 COM 类型信息对项目可用。</td> 
  </tr> 
  <tr> 
   <td align="left">-linkresource</td> 
   <td align="left">创建指向托管资源的链接。</td> 
  </tr> 
  <tr> 
   <td align="left">-resource</td> 
   <td align="left">将 .NET Framework 资源嵌入到输出文件。</td> 
  </tr> 
  <tr> 
   <td align="left">-win32icon</td> 
   <td align="left">指定要插入到输出文件的 .ico 文件。</td> 
  </tr> 
  <tr> 
   <td align="left">/win32res:</td> 
   <td align="left">指定要插入到输出文件的 Win32 资源。</td> 
  </tr> 
 </tbody> 
</table>

\#\#杂项

<table> 
 <thead> 
  <tr> 
   <th align="left">选项</th> 
   <th align="left">目标</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">@</td> 
   <td align="left">指定响应文件。</td> 
  </tr> 
  <tr> 
   <td align="left">-?</td> 
   <td align="left">列出到 stdout 的编译器选项。</td> 
  </tr> 
  <tr> 
   <td align="left">-baseaddress</td> 
   <td align="left">指定要加载 DLL 的首选基址。</td> 
  </tr> 
  <tr> 
   <td align="left">-codepage</td> 
   <td align="left">指定要用于编译中所有源代码文件的代码页。</td> 
  </tr> 
  <tr> 
   <td align="left">-help</td> 
   <td align="left">列出到 stdout 的编译器选项。</td> 
  </tr> 
  <tr> 
   <td align="left">-highentropyva</td> 
   <td align="left">指定可执行文件支持地址空间布局随机化 (ASLR)。</td> 
  </tr> 
  <tr> 
   <td align="left">-langversion</td> 
   <td align="left">指定语言版本：默认、ISO-1、ISO-2、3、4、5、6、7、7.1、7.2、7.3 或最新版</td> 
  </tr> 
  <tr> 
   <td align="left">-main</td> 
   <td align="left">指定 Main 方法的位置。</td> 
  </tr> 
  <tr> 
   <td align="left">-noconfig</td> 
   <td align="left">指示编译器不使用 csc.rsp 进行编译。</td> 
  </tr> 
  <tr> 
   <td align="left">-nologo</td> 
   <td align="left">禁止显示编译器横幅信息。</td> 
  </tr> 
  <tr> 
   <td align="left">-recurse</td> 
   <td align="left">搜索要编译的源文件的子目录。</td> 
  </tr> 
  <tr> 
   <td align="left">-subsystemversion</td> 
   <td align="left">指定可执行文件可以使用的子系统的最低版本。</td> 
  </tr> 
  <tr> 
   <td align="left">不安全</td> 
   <td align="left">启用使用 unsafe 关键字的代码编译。</td> 
  </tr> 
  <tr> 
   <td align="left">-utf8output</td> 
   <td align="left">显示使用 UTF-8 编码的编译器输出。</td> 
  </tr> 
  <tr> 
   <td align="left">-parallel[+|-]</td> 
   <td align="left">指定是否使用并发生成 (+)。</td> 
  </tr> 
  <tr> 
   <td align="left"><code>-checksumalgorithm:&lt;alg&gt;</code></td> 
   <td align="left">指定用于计算 PDB 中存储的源文件校验和的算法。 支持的值为：SHA1（默认值）或 SHA256。</td> 
  </tr> 
 </tbody> 
</table>

\#\#已过时的选项

<table> 
 <thead> 
  <tr> 
   <th align="left">选项</th> 
   <th align="left">目标</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">-incremental</td> 
   <td align="left">启用增量编译。</td> 
  </tr> 
 </tbody> 
</table>