掌握Visual Studio项目配置【基础篇】

撬动未来的支点

已于 2023-02-03 10:12:56 修改

阅读量5.3k

点赞数

分类专栏： Qt开发 C++ 文章标签： visual studio c++ windows

于 2023-01-03 00:51:32 首次发布

本文链接：https://blog.csdn.net/u012790503/article/details/128526398

版权

Qt开发同时被 2 个专栏收录

67 篇文章 23 订阅

订阅专栏

C++

3 篇文章 1 订阅

订阅专栏

1. 前言

Visual Studio是Windows上最常用的C++集成开发环境之一，简称VS。

VS功能十分强大，对应的，其配置系统较为复杂。不管是对于初学者还是有一定开发经验的开发者来说，捋清楚VS的配置系统的脉络，不是一件容易的事情。

笔者在工作中发现，确实有开发者对VS的基础配置项的作用模棱两可。一方面原因是VS配置的相关资料比较零散，不容易快速完整地查找到；另一方面，网络上找到的资料大多来自微软官方，其内容多为英文或译文，读起来晦涩难懂。因此，对VS配置进行一番系统的专题研究并分享出来很有必要。

作为基础篇，本文讲解VS的基础配置。

2. 熟悉项目配置界面

2.1 新建项目

我们以VS2015 Win32项目为例，讲解C++项目配置。
新建项目时，选择Win32项目，如下图所示：

新建Win32项目

2.2 打开项目属性页

新建项目完成后，在解决方案管理器中的项目名称上右键，选择属性，如下所示：
打开项目属性页

弹出的项目属性页对话框如下所示：

项目属性页

项目属性页中各个序号所代表的区域分别为：

区域编号	描述
区域1	当前正在修改的配置名称。Debug配置在开发调试阶段使用，Release配置在软件发布时使用。“活动Debug”表示当前项目正在使用的配置是Debug配置。
区域2	当前正在修改的配置对应的目标平台名称。Win32代表32位Windows系统，x64代表64位Windows系统。
区域3	配置项分类树。
区域4	具体配置项。
区域5	具体配置项作用描述。

3. 难点分析

我们知道，集成开发环境出现的目的是，为开发者屏蔽底层编译系统的琐碎细节，让软件开发更加快捷方便。

那么为什么VS中还会有各种复杂的配置项？这些配置项大大增加了VS的使用难度。原因有两点：

VS中的配置是需要用户来完善的，集成开发环境无法将其完全屏蔽。
不同的项目有不同的配置需求，这就要求集成开发环境必须给开发者提供配置接口。

综上看来，VS的配置是我们无法绕过的，必须掌握。

VS的配置有一部分是比较难懂的，这是因为它和底层编译系统息息相关。想要弄懂VS的配置，就必须了解VS的底层编译系统。本来集成开发环境就是想把编译系统的细节屏蔽掉，但实际上，我们还是要去学习其底层编译系统。可见，仅仅浮于表面，很多问题是无法解决的，了解底层对我们解决难题来说至关重要。

4. 从软件构造系统原理讲起

为什么要从软件构造系统原理讲起呢？因为VS是运行在软件构造系统 MSBuild 之上的，软件构造系统是让项目配置真正生效的地方。

关于GUI和底层系统的关系，这里多说几句。在学习和研究软件系统时，我们要抛弃使用GUI（图形用户界面）思考的方式。GUI仅仅是一个将软件功能暴露给用户的一种交互接口。当我们从开发者的角度去研究一个软件系统时，我们的关注点和思考点不应该只停留在软件界面GUI上，而是应该将软件界面从软件中分离出去，深入研究位于GUI后面的、真正向外提供功能的底层系统原理。首先，同一个软件系统可以有各种各样的GUI设计，例如git有很多不同的图形客户端；再者，GUI只是软件系统将部分功能暴露出来的图形接口，它是软件系统完整功能的子集。所以说，GUI只是一个表象，系统的核心和本质在底层系统。我们大多数人习惯了使用Windows图形界面的方式与系统交互，而不习惯linux命令行的方式与系统交互。从用户的角度来说，图形用户界面确实比命令行更加友好。但是作为开发者，透过GUI看底层是我们的必修课。

回到正题。关于软件构造系统，在上篇文章《掌握Qt构造系统》中有所描述。

软件构造系统，简单来说，就是一套完整的软件构造工具和流程，可以将其看做是开发者的软件生产车间。它是一个典型的输入输出系统。

软件构造系统的输入是开发者提供的代码资源，输出是用户可用的软件产品。从代码资源到软件产品的加工过程，由构造系统中的工具和流程来完成。

图示如下：

软件构造流程

开发者为了将代码生成为可执行程序，必须至少为软件构造系统提供以下信息：

项目基本信息：项目名称、项目类型、编译工具、开发语言等信息。一般在创建项目时配置。
输入信息：构造系统的输入是开发者提供的代码资源。代码资源就是指项目内的一切文件，包括，头文件，源文件，共享库，资源文件等等。为了能够方便地对项目文件进行管理和编辑，IDE一般都会提供图形用户界面，供开发者进行操作。例如VS中的项目资源管理器用来管理项目和项目资源；代码文本编辑器、资源编辑器被用来编辑具体的单个文件。
构造参数：软件构造系统是灵活的，高度可配置的。开发者可以根据自己的需要，修改软件系统中构造工具的执行参数，以控制软件产品的生成过程。
输出信息：输出信息主要包含软件产品的名称、版本、运行权限等配置。

配置好了以上信息以后，软件构造系统就能按照开发者的意图生成软件产品。

下面我们将结合软件构造系统基本原理，详细分析VS项目配置项的含义及配置方法。

5. 基本配置讲解

5.1 常规属性页

常规属性编辑页

其中比较重要的几个配置项，解释如下：

目标平台：归属于输出信息配置。用于配置生成的软件所运行的平台，一般为Windows。一般确定后即不可修改。
目标平台版本：归属于输出信息配置。用于配置生成的软件使用的win SDK版本。关于SDK版本和使用的平台，参考官方文档：Windows SDK 和模拟器存档，地址：https://developer.microsoft.com/zh-cn/windows/downloads/sdk-archive/
输出目录：归属于输出信息配置。用于配置目标文件的输出目录，在此示例项目中表示应用程序Win32Project1.exe所在目录。图中此配置项的值是用两个VS内置变量/宏合成的：$(SolutionDir)的值为当前解决方案文件.sln文件所在目录，$(Configuration)的值为当前构建配置名称（Debug/Release）。还有很多内置宏，可以在属性值编辑对话框中查询，此对话框打开方式如下图：

打开属性值编辑对话框

打开后的值编辑对话框，如下图所示：

属性值编辑对话框

下方列出的所有内置变量/宏均可以根据需要使用。

中间目录：归属于输出信息配置。用于配置构建过程中产生的中间文件（如目标文件，构建日志等）的存放位置。
目标文件名：归属于输出信息配置，用于配置目标文件的文件名，不包含文件后缀名。
目标文件扩展名：归属于输出信息配置，用于配置目标文件后缀名。
平台工具集：归属于构造参数配置。用于选择MSBuild构建系统的版本。参考：如何：修改目标框架和平台工具集。并不是只要是exe应用程序就能在所有的Windows平台上都能运行。某些操作系统，例如xp系统，因为年代比较久远，只能使用特定的平台工具集来构建，才能在xp上正常运行。一般适用于生成xp系统应用程序的工具集名称以"_xp"结尾。

5.2 调试属性页

调试属性编辑页

调试器也可以认为是构造系统的一部分，它用于调试软件产品，帮助解决软件产品中存在的问题。

其中比较重要的配置项，解释如下：

命令：归属于构造参数配置。在点击调试按钮时，VS会执行此启动命令，启动被调试的程序。对于生成应用程序的项目，此值默认为目标文件路径$(TargetPath)，即直接启动项目生成的应用程序。对于生成共享库的项目，可以配置成调用此共享库的应用程序的路径。
命令参数：归属于构造参数配置。在启动被调试的程序时，VS会将此参数作为启动参数传递给被调试的程序。命令+命令参数，这两个配置项，共同指定了被调试程序的启动信息。
工作目录：归属于构造参数配置。用于指定被调试程序的工作目录，默认为项目目录$(ProjectDir)，可以一般设置为exe所在目录，即$(TargetDir)。程序启动需要读取当前目录下的一些配置文件，如果调试时发现文件明明和应用程序在同一个目录下，程序却提示找不到，通常就是因为工作目录没有设置成应用程序所在目录导致的。
附加：归属于构造参数配置。值为否，表示开始调试时，VS执行命令+命令参数启动一个新的进程用于调试；值为是，表示开始调试时，如果由命令配置项指定的应用程序正在运行，则将调试器附加到已存在的进程进行调试。
调试器类型：默认为自动，一般不需要修改。
环境：归属于构造参数配置。为被调试的程序指定环境变量。
合并环境：归属于构造参数配置。用于指定是否将上个配置项环境配置与当前VS的运行环境配置合并。

其他选项保持默认即可。关于调试器配置的官方文档，参考： C++ 调试配置的项目设置。

5.3 C/C++配置

C/C++配置，主要用于配置编译过程。

C/C++配置编辑页

其中，比较常用的配置有：

C/C++->常规->附加包含目录：归属于输入信息配置。用于添加头文件的包含目录。编译代码时，编译器会到已添加的头文件包含目录下查找头文件，引入相关定义。如果找不到头文件会出现未定义的错误。指定头文件包含目录，可以简化头文件包含语句，只需要直接包含头文件名，即：#include “xxxxx.h”，不需要指定头文件目录，编译器会自动查找。
C/C++->常规->多处理器编译：归属于构造参数配置。值为是，编译器会使用多个处理器内核并行编译，可以加快编译速度，但会增加CPU占用。值为否，编译器不使用多个处理器内核并行编译，编译速度较慢。
C/C++->优化：归属于构造参数配置。用于指定编译时的优化等级和优化方案。
C/C++->预处理器：归属于构造参数配置。用于预处理阶段，定义和取消定义宏，从而生成不同的代码。

5.4 链接器配置

链接器配置，主要用于配置程序链接过程。

链接器配置编辑页

其中，比较常用的配置有：

链接器->常规->输出文件：归属于输出信息配置。用于指定输出的目标文件路径，一般不做修改。
链接器->常规->启用增量链接：归属于构造参数配置。用于指定是否使用增量链接，加速程序链接过程。
链接器->常规->附加库目录：归属于输入信息配置。用于指定链接库目录。指定库目录可以简化依赖库的指定方式，即只需要指定依赖库名称即可，不需要指定路径。执行链接步骤时，链接器会到已添加的库目录下根据库名称查找对应的链接库，链接到程序中，最终生成目标文件。
链接器->输入->附加依赖项：归属于输入信息配置。用于指定需要链接到目标文件中的依赖库名称。
链接器->调试：归属于输出信息配置。用于指定代码优化等级、是否生成 .pdb 调试信息数据库文件以用于调试等。

基本配置项主要包含了构造系统的基本输入输出配置。掌握以上配置项，基本可以胜任日常80%的开发任务。

纸上得来终觉浅，任何一个选项都需要自己亲自配置、测试，才能真正掌握。