VC命令行编译参数介绍

 

CL.exe   是控制   Microsoft   C   和   C++   编译器与链接器的   32   位工具。编译器产生通用对象文件格式   (COFF)   对象   (.obj)   文件。链接器产生可执行文件   (.exe)   或动态链接库文件   (DLL)。  

  注意，所有编译器选项都区分大小写。  

  若要编译但不链接，请使用   /c。  

  使用   NMAKE   生成输出文件。  

  使用   BSCMAKE   支持类浏览。  

  以下是一个完整的编译器选项分类列表。  

  优化  

  选项   作用    

  /O1   创建小代码    

  /O2   创建快速代码    

  /Oa   假设没有别名    

  /Ob   控制内联展开    

  /Od   禁用优化    

  /Og   使用全局优化    

  /Oi   生成内部函数    

  /Op   改善浮点数一致性    

  /Os   代码大小优先    

  /Ot   代码速度优先    

  /Ow   假定在函数调用中使用别名    

  /Ox   使用最大优化   (/Ob1gity   /Gs)    

  /Oy   省略框架指针    

  代码生成  

  选项   作用    

  /clr   启用   C++   的托管扩展并产生在公共语言运行库上运行的输出文件    

  /EH   指定异常处理模型    

  /G3   优化代码以优选   386   处理器。在   Visual   C++   5.0   中已经停用，编译器将忽略此选项    

  /G4   优化代码以优选   486   处理器。在   Visual   C++   5.0   中已经停用，编译器将忽略此选项    

  /G5   优化代码以优选   Pentium    

  /GB   与   /G6   等效；将   _M_IX86   的值设置为   600    

  /Gd   使用   __cdecl   调用约定    

  /Ge   激活堆栈探测    

  /GF  

  /GF   启用字符串池    

  /GH   调用挂钩函数   _penter    

  /GH   调用挂钩函数   _pexit    

  /GL   启用全程序优化    

  /Gm   启用最小重新生成    

  /Gr   启用运行时类型信息   (RTTI)    

  /Gr   使用   __fastcall   调用约定    

  /GS   控制堆栈探测    

  /GT   支持使用静态线程本地存储区分配的数据的纤程安全    

  /GX   启用同步异常处理    

  /Gy   启用函数级链接    

  /GZ   使用   __stdcall   调用约定    

  /MD   使用   MSVCRT.lib   创建多线程   DLL    

  /MDd   使用   MSVCRTD.lib   创建调试多线程   DLL    

  /ML   使用   LIBC.lib   创建单线程可执行文件    

  /MLd   使用   LIBCD.lib   创建调试单线程可执行文件    

  /MT   使用   LIBCMT.lib   创建多线程可执行文件    

  /MTd   使用   LIBCMTD.lib   创建调试多线程可执行文件    

  输出文件  

  选项   作用    

  /FA  

  /FA   创建列表文件  

  设置列表文件名    

  /Fd   重命名程序数据库文件    

  /Fe   重命名可执行文件    

  /Fm   创建映射文件    

  /Fo   创建对象文件    

  /Fp   指定预编译头文件名    

  /FR  

  /FR   生成浏览器文件    

  /Fx   将插入的代码与源文件合并    

  调试  

  选项   作用    

  /GS   缓冲区安全检查    

  /GZ   与   /RTC1   相同    

  /RTC   启用运行时错误检查    

  /Wp64   检测   64   位可移植性问题    

  /Yd   将完整的调试信息放在所有对象文件中    

  /Yl   创建调试库时插入   PCH   引用    

  /Z7   生成与   C   7.0   兼容的调试信息    

  /Zd   生成行号    

  /Zi   生成完整的调试信息    

  预处理器  

  选项   作用    

  /AI   指定在解析传递到#using   指令的文件引用时搜索的目录    

  /c   在预处理期间保留注释    

  /D   定义常数和宏    

  /E   将预处理器输出复制到标准输出    

  /EP   将预处理器输出复制到标准输出    

  /Fl   预处理指定的包含文件    

  /FU   强制使用文件名，就像它已被传递到#using   指令一样    

  /I   在目录中搜索包含文件    

  /P   将预处理器输出写入文件    

  /U   移除预定义宏    

  /U   移除所有的预定义宏    

  /X   忽略标准包含目录    

  /ZI   将调试信息包含在与“编辑并继续”兼容的程序数据库中    

  语言  

  选项   作用    

  /noBool   取消   C++   bool、true   和   false   关键字    

  /vd   取消或启用隐藏的   vtordisp   类成员    

  /vmb   对指向成员的指针使用最佳的基    

  /vmg   对指向成员的指针使用完全一般性    

  /vmm   声明多重继承    

  /vms   声明单一继承    

  /vmv   声明虚拟继承    

  /Za   禁用语言扩展    

  /Zc   在   /Ze   下指定标准行为    

  /Ze   启用语言扩展    

  /Zg   生成函数原型    

  /Zl   从   .obj   文件中移除默认库名    

  /Zp   n   封装结构成员    

  /Zs   只检查语法    

  链接  

  选项   作用    

  /F   设置堆栈大小    

  /LD   创建动态链接库    

  /LDd   创建调试动态链接库    

  /link   将指定的选项传递给   LINK    

  /MD   使用   MSVCRT.lib   编译以创建多线程   DLL    

  /MDd   使用   MSVCRTD.lib   编译以创建调试多线程   DLL    

  /ML   使用   LIBC.lib   编译以创建单线程可执行文件    

  /MLd   使用   LIBCD.lib   编译以创建调试单线程可执行文件    

  /MT   使用   LIBCMT.lib   编译以创建多线程可执行文件    

  /MTd   使用   LIBCMTD.lib   编译以创建调试多线程可执行文件    

  预编译头  

  选项   作用    

  /Y-   忽略当前生成中的所有其他预编译头编译器选项    

  /Yc   创建预编译头文件    

  /Yd   将完整的调试信息放在所有对象文件中    

  /Yu   在生成期间使用预编译头文件    

  /YX   自动处理预编译头    

  杂项  

  选项   作用    

  @   指定响应文件    

  /?   列出编译器选项    

  /c   编译但不链接    

  /H   限制外部（公共）名称的长度    

  /HELP   列出编译器选项    

  /J   更改默认的   char   类型    

  /NOLOGO   取消显示登录版权标志    

  /QI0f   确保   Pentium   0F   指令没有问题    

  /QIfdiv   FDIV、FPREM、FPTAN   和   FPATAN   指令有缺陷的   Intel   Pentium   微处理器的变通方法    

  QIfist   当需要从浮点类型转换为整型时取消   Helper   函数   _ftol   的调用    

  /showIncludes   在编译期间显示所有包含文件的列表    

  /Tc  

  /Tc   指定   C   源文件    

  /Tp  

  /Tp   指定   C++   源文件    

  /V   设置版本字符串    

  /w   设置警告等级    

  /w   禁用所有警告    

  /Wall   启用所有警告，包括默认情况下禁用的警告    

  /WL   在从命令行编译   C++   源代码时启用错误信息和警告消息的单行诊断    

  /Zm   设置编译器的内存分配限制    

CL   命令行使用下列语法：  

  CL   [option...]   file...   [option   |   file]...   [lib...]   [@command-file]   [/link   link-opt...]  

  下表说明CL   命令的输入项意义    

  option   一个或多个   CL   选项。请注意，所有选项都应用于所有指定的源文件。选项是由一个正斜杠   (/)   或一个短划线   (–)   指定的。如果某个选项带有参数，则该选项的说明指定在选项和参数之间是否允许有空格。选项名（/HELP   选项除外）区分大小写。有关更多信息，请参阅   CL   选项的顺序。      

  file   一个或多个源文件、.obj   文件或库的名称。CL   编译源文件并将   .obj   文件和库的名称传递给链接器。有关更多信息，请参阅   CL   文件名语法。      

  lib   一个或多个库名。CL   将这些名称传递给链接器。    

  command-file   包含多个选项和文件名的文件。有关更多信息，请参阅   CL   命令文件。    

  link-opt   一个或多个链接器选项。CL   将这些选项传递给链接器。    

  您可以指定任意数目的选项、文件名和库名，条件是命令行上的字符数不超过   1024，该限制是操作系统指定的。 

vc 编译连接选项(

大家可能一直在用VC开发软件，但是对于这个编译器却未必很了解。原因是多方面的。大多数情况下，我们只停留在“使用”它，而不会想去“了解”它。因为它只是一个工具，我们宁可把更多的精力放在C++语言和软件设计上。我们习惯于这样一种“模式”：建立一个项目，然后写代码，然后编译，反反复复调试。但是，所谓：“公欲善其事，必先利其器”。如果我们精于VC开发环境，我们是不是能够做得更加游刃有余呢？

　　闲话少说。我们先来看一下VC的处理流程，大致分为两步：编译和连接。源文件通过编译生成了.obj文件；所有.obj文件和.lib文件通过连接生成.exe文件或.dll文件。下面，我们分别讨论这两个步骤的一些细节。

　　编译参数的设置。主要通过VC的菜单项Project->Settings->C/C++页来完成。我们可以看到这一页的最下面Project Options中的内容，一般如下：

/nologo /MDd /W3 /Gm /GX /ZI /Od /D "WIN32" /D "_DEBUG" /D "_WINDOWS" /D "_AFXDLL" /D "_M

BCS" /Fp"Debug/WritingDlgTest.pch" /Yu"stdafx.h" /Fo"Debug/" /Fd"Debug/" /FD /GZ /c

　　各个参数代表的意义，可以参考Msdn。比如/nologo表示编译时不在输出窗口显示这些设置（我们可以把这个参数去掉来看看效果）等等。一般我们不会直接修改这些设置，而是通过这一页最上面的Category中的各项来完成。

　　1) General：一些总体设置。Warning level用来控制警告信息，其中Level 1是最严重的级别；Warnings as errors将警告信息当作错误处理；Optimizations是代码优化，可以在Category的Optimizations项中进行更细的设置；Generate browse info用以生成.sbr文件，记录类、变量等符号信息，可以在Category的Listing Files项中进行更多的设置。Debug info，生成调试信息：None，不产生任何调试信息（编译比较快）；Line Numbers Only，仅生成全局的和外部符号的调试信息到.OBJ文件或.EXE文件，减小目标文件的尺寸；C 7.0- Compatible，记录调试器用到的所有符号信息到.OBJ文件和.EXE文件；Program Database，创建.PDB文件记录所有调试信息；Program Database for "Edit & Continue"，创建.PDB文件记录所有调试信息，并且支持调试时编辑。

　　2) C++ Language：pointer_to_member representation用来设置类定义/引用的先后关系，一般为Best-Case Always表示在引用类之前该类肯定已经定义了；Enable Exception Handling，进行同步的异常处理；Enable Run-Time Type Information迫使编译器增加代码在运行时进行对象类型检查；Disable Construction Displacements，设置类构造/析构函数调用虚函数问题。

　　3) Code Generation：Processor表示代码指令优化，可以为80386、80486、Pentium、Pentium Pro，或者Blend表示混合以上各种优化。Use run-time library用以指定程序运行时使用的运行时库（单线程或多线程，Debug版本或Release版本），有一个原则就是，一个进程不要同时使用几个版本的运行时库。Single-Threaded，静态连接LIBC.LIB库；Debug Single-Threaded，静态连接LIBCD.LIB库；Multithreaded，静态连接LIBCMT.LIB库；Debug Multithreaded，静态连接LIBCMTD.LIB库；Multithreaded DLL，动态连接MSVCRT.DLL库；Debug Multithreaded DLL，动态连接MSVCRTD.DLL库。连接了单线程库就不支持多线程调用，连接了多线程库就要求创建多线程的应用程序。

　　Calling convention可以用来设定调用约定，有三种：__cdecl、__fastcall和__stdcall。各种调用约定的主要区别在于，函数调用时，函数的参数是从左到右压入堆栈还是从右到左压入堆栈；在函数返回时，由函数的调用者来清理压入堆栈的参数还是由函数本身来清理；以及在编译时对函数名进行的命名修饰（可以通过Listing Files看到各种命名修饰方式）。Struct member alignment用以指定数据结构中的成员变量在内存中是按几字节对齐的，根据计算机数据总线的位数，不同的对齐方式存取数据的速度不一样。这个参数对数据包网络传输等应用尤为重要，不是存取速度问题，而是数据位的精确定义问题，一般在程序中使用#pragma pack来指定。

　　4) Customize：Disable Language Extensions，表示不使用微软为标准C做的语言扩展；Eliminate Duplicate Strings，主要用于字符串优化（将字符串放到缓充池里以节省空间），使用这个参数，使得

char *sBuffer = "This is a character buffer";

char *tBuffer = "This is a character buffer";

 

　　sBuffer和tBuffer指向的是同一块内存空间；Enable Function-Level Linking ，告诉编译器将各个函数按打包格式编译；Enables minimal rebuild，通过保存关联信息到.IDB文件，使编译器只对最新类定义改动过的源文件进行重编译，提高编译速度；Enable Incremental Compilation，同样通过.IDB文件保存的信息，只重编译最新改动过的函数；Suppress Startup Banner and Information Messages，用以控制参数是否在output窗口输出。

　　5) Listing Files：Generate browse info的功能上面已经提到过。这里可以进行更多的设置。Exclude Local Variables from Browse Info表示是否将局部变量的信息放到.SBR文件中。Listing file type可以设置生成的列表信息文件的内容：Assembly-Only Listing仅生成汇编代码文件（.ASM扩展名）；Assembly With Machine Code生成机器代码和汇编代码文件（.COD扩展名）；Assembly With Source Code生成源代码和汇编代码文件（.ASM扩展名）；Assembly, Machine Code,and Source生成机器码、源代码和汇编代码文件（.COD扩展名）。Listing file name为生成的信息文件的路径，一般为Debug或Release目录下，生成的文件名自动取源文件的文件名。

　　6) Optimizations：代码优化设置。可以选择Maximize Speed生成最快速的代码，或Minimize Size生成最小尺寸的程序，或者Customize定制优化。定制的内容包括：

　　Assume No Aliasing，不使用别名（提高速度）；

　　Assume Aliasing Across Function Calls，仅函数内部不使用别名；

　　Global Optimizations，全局优化，比如经常用到的变量使用寄存器保存，或者循环内的计算优化，如

i = -100;

while( i < 0 ){ i += x + y;}

 

　　会被优化为

i = -100;

t = x + y;

while( i < 0 ){i += t;}

Generate Intrinsic Functions，使用内部函数替换一些函数调用（提高速度）；

Improve Float Consistency，浮点运算方面的优化；

Favor Small Code，程序（exe或dll）尺寸优化优先于代码速度优化；

Favor Fast Code，程序（exe或dll）代码速度优化优先于尺寸优化；

Frame-Pointer Omission，不使用帧指针，以提高函数调用速度；

Full Optimization，组合了几种参数，以生成最快的程序代码。

 

　　Inline function expansion，内联函数扩展的三种优化（使用内联可以节省函数调用的开销，加快程序速度）：Disable不使用内联；Only __inline，仅函数定义前有inline或__inline标记使用内联；Any Suitable，除了inline或__inline标记的函数外，编译器“觉得”应该使用内联的函数，都使用内联。

　　7) Precompiled Headers：预编译头文件的设置。使用预编译可以提高重复编译的速度。VC一般将一些公共的、不大变动的头文件（比如afxwin.h等）集中放到stdafx.h中，这一部分代码就不必每次都重新编译（除非是Rebuild All）。

　　8) Preprocessor：预编译处理。可以定义/解除定义一些常量。Additional include directories，可以指定额外的包含目录，一般是相对于本项目的目录，如../Include。

　　连接参数的设置。主要通过VC的菜单项Project->Settings->Link页来完成。我们可以看到这一页的最下面Project Options中的内容，一般如下：

/nologo /subsystem:windows /incremental:yes /pdb:"Debug/WritingDlgTest.pdb" /debug /machi

ne:I386 /out:"Debug/WritingDlgTest.exe" /pdbtype:sept

　　下面我们分别来看一下Category中的各项设置。

　　1) General：一些总体设置。可以设置生成的文件路径、文件名；连接的库文件；Generate debug info，生成Debug信息到.PDB文件（具体格式可以在Category->Debug中设置）；Ignore All Default Libraries，放弃所有默认的库连接；Link Incrementally，通过生成. ILK文件实现递增式连接以提高后续连接速度，但一般这种方式下生成的文件（EXE或DLL）较大；Generate Mapfile，生成.MAP文件记录模块相关信息；Enable Profiling，这个参数通常与Generate Mapfile参数同时使用，而且如果产生Debug信息的话，不能用.PDB文件，而且必须用Microsoft Format。

　　2) Customize：这里可以进行使用程序数据库文件的设置。Force File Output ，强制产生输出文件（EXE或DLL）；Print Progress Messages，可以将连接过程中的进度信息输出到Output窗口。

　　3) Debug：设置是否生成调试信息，以及调试信息的格式。格式可以有Microsoft Format、COFF Format（Common Object File Format）和Both Formats三种选择；Separate Types，表示将Debug格式信息以独立的.PDB文件存放，还是直接放在各个源文件的.PDB文件中。选中的话，表示采用后者的方式，这种方式调试启动比较快。

　　4) Input：这里可以指定要连接的库文件，放弃连接的库文件。还可以增加额外的库文件目录，一般是相对于本项目的目录，如../Lib。Force Symbol References，可以指定连接特定符号定义的库。

　　5) Output：Base Address可以改变程序默认的基地址（EXE文件默认为0x400000，DLL默认为x10000000），操作系统装载一个程序时总是试着先从这个基地址开始。Entry-Point Symbol可以指定程序的入口地址，一般为一个函数名（且必须采用__stdcall调用约定）。一般Win32的程序，EXE的入口为WinMain，DLL的入口为DllEntryPoint；最好让连接器自动设置程序的入口点。默认情况下，通过一个C的运行时库函数来实现：控制台程序采用mainCRTStartup (或wmainCRTStartup)去调用程序的main (或wmain)函数；Windows程序采用WinMainCRTStartup (或 wWinMainCRTStartup)调用程序的WinMain (或 wWinMain，必须采用__stdcall调用约定)；DLL采用_DllMainCRTStartup调用DllMain函数（必须采用__stdcall调用约定）。Stack allocations，用以设置程序使用的堆栈大小（请使用十进制），默认为1兆字节。Version Information告诉连接器在EXE或DLL文件的开始部分放上版本号。

　　值得注意的是，上面各个参数是大小写敏感的；在参数后加上“-”表示该参数无效；各个参数值选项

有“*”的表示为该参数的默认值；可以使用页右上角的“Reset”按钮来恢复该页的所有默认设置。

　　其它一些参数设置

　　1) Project->Settings->General，可以设置连接MFC库的方式（静态或动态）。如果是动态连

接，在你的软件发布时不要忘了带上MFC的DLL。

　　2) Project->Settings->Debug，可以设置调试时运行的可执行文件，以及命令行参数等。

　　3) Project->Settings->Custom Build，可以设置编译/连接成功后自动执行一些操作。比较有

用的是，写COM时希望VC对编译通过的COM文件自动注册，可以如下设置：

　　　Description: Register COM

　　　Commands: regsvr32 /s /c $(TargetPath)

　　　echo regsvr32 exe.time > $(TargetDir)/$(TargetName).trg

　　　Outputs: $(TargetDir)/$(TargetName).trg

　　4) Tools->Options->Directories，设置系统的Include、Library路径。

　　一些小窍门

　　1) 有时候，你可能在编译的时候，计算机突然非法关机了（可能某人不小心碰了电源或你的内存不稳定等原因）。当你重启机器后打开刚才的项目，重新进行编译，发现VC会崩掉。你或许以为你的VC编译器坏了，其实不然（你试试编译其它项目，还是好的！），你只要将项目的.ncb、.opt、.aps、.clw文件以及Debug、Release目录下的所有文件都删掉，然后重新编译就行

了。

　　2) 如果你想与别人共享你的源代码项目，但是把整个项目做拷贝又太大。你完全可以删掉以下文件：.dsw、.ncb、.opt、.aps、.clw、. plg文件以及Debug、Release目录下的所有文件。

　　3) 当你的Workspace中包含多个Project的时候，你可能不能直观地、一眼看出来哪个是当前项目。可以如下设置：Tools->Options->Format，然后在Category中选择Workspace window，改变其默认的字体（比如设成Fixedsys）就行了。

　　4) 如何给已有的Project改名字？将该Project关掉。然后以文本格式打开.dsp文件，替换原来的Project名字即可。

　　5) VC6对类成员的智能提示功能很有用，但有时候会失灵。你可以先关掉项目，将.clw和.ncb删掉，然后重新打开项目，点击菜单项View->ClassWizard，在弹出的对话框中按一下“Add All”按钮；重新Rebuild All。应该可以解决问题。