一般情况下我们并不需要关心 Visual Studio 解决方案文件格式（.sln），因为 Visual Studio 对解决方案文件的自动修复能力是非常强的。但是如果遇到自动解冲突错误或者编译不通过了，那么此文件还是需要手工修改的。

基本概念

Visual Studio的解决方案文件由这三个部分组成：

  • 版本信息
    • Microsoft Visual Studio Solution File, Format Version 12.00

    • Visual Studio Version 16

    • VisualStudioVersion = 16.0.28606.126
    • MinimumVisualStudioVersion = 10.0.40219.1
  • 项目信息
    • Project
    • EndProject
  • 全局信息
    • Global
    • EndGlobal

虽然看起来是三个独立的部分，但其实除了版本号之外，项目信息和全局信息还是有挺多耦合部分的。
比如我们来看一个 sln 文件的例子，是一个最简单的只有一个项目的 sln 文件：
理解 Visual Studio 解决方案文件格式（.sln） - 图1

  1. Microsoft Visual Studio Solution File, Format Version 12.00
  2. # Visual Studio Version 16
  3. VisualStudioVersion = 16.0.29102.190
  4. MinimumVisualStudioVersion = 10.0.40219.1
  5. Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Walterlv.Demo", "Walterlv.Demo\Walterlv.Demo.csproj", "{DC0B1D44-5DF4-4590-BBFE-072183677A78}"
  6. EndProject
  7. Global
  8.     GlobalSection(SolutionConfigurationPlatforms) = preSolution
  9.         Debug|Any CPU = Debug|Any CPU
  10.         Release|Any CPU = Release|Any CPU
  11.     EndGlobalSection
  12.     GlobalSection(ProjectConfigurationPlatforms) = postSolution
  13.         {DC0B1D44-5DF4-4590-BBFE-072183677A78}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
  14.         {DC0B1D44-5DF4-4590-BBFE-072183677A78}.Debug|Any CPU.Build.0 = Debug|Any CPU
  15.         {DC0B1D44-5DF4-4590-BBFE-072183677A78}.Release|Any CPU.ActiveCfg = Release|Any CPU
  16.         {DC0B1D44-5DF4-4590-BBFE-072183677A78}.Release|Any CPU.Build.0 = Release|Any CPU
  17.     EndGlobalSection
  18.     GlobalSection(SolutionProperties) = preSolution
  19.         HideSolutionNode = FALSE
  20.     EndGlobalSection
  21.     GlobalSection(ExtensibilityGlobals) = postSolution
  22.         SolutionGuid = {F2F1AD1B-207B-4731-ABEB-92882F89B155}
  23.     EndGlobalSection
  24. EndGlobal

下面我们来一一说明。

结构

版本信息

  1. Microsoft Visual Studio Solution File, Format Version 12.00
  2. # Visual Studio Version 16
  3. VisualStudioVersion = 16.0.29102.190
  4. MinimumVisualStudioVersion = 10.0.40219.1

记录文件的格式版本是 12.0。使用 Visual Studio 2019 编辑/创建。

这里有一个小技巧，这里的 VisualStudioVersion 版本号设置为 15.0 会使得打开 sln 文件的时候默认使用 Visual Studio 2017，而设置为 16.0 会使得打开 sln 文件的时候默认使用 Visual Studio 2019。

项目信息

Porject

  1. Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Walterlv.Demo", "Walterlv.Demo\Walterlv.Demo.csproj", "{DC0B1D44-5DF4-4590-BBFE-072183677A78}"
  2. EndProject

项目信息至少由两行组成，第一行标记项目信息开始，而最后一行表示信息结束。
其格式为：

  1. Project("{项目类型}") = "项目名称", "项目路径", "项目 Id"
  2. EndProject

项目类型详见：
https://www.yuque.com/docs/share/b8b2120d-b628-4ec1-b4fb-c1206fd54c9c?#

项目名称和项目路径不必多说，都知道。对于文件夹而言，项目名称就是文件夹的名称，而项目路径也是文件夹的名称。

项目 Id 是在解决方案创建项目的过程中生成的一个新的 GUID，每个项目都不一样。对于 SDK 风格的 C# 项目文件，csproj 中可以指定项目依赖，而如果没有直接的项目依赖，而只是解决方案编译级别的依赖，那么也可以靠 sln 文件中的项目 Id 来指定项目的依赖关系。另外，也通过项目 Id 来对项目做一些编译上的解决方案级别的配置。

PojectSection
Project和EndProject的内部还可以放ProjectSection。

比如对于解决方案文件夹，可以包含解决方案文件：

  1. Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution Items", "{B002382D-4C9E-4F08-85E5-F12E2C061F5A}"
  2.     ProjectSection(SolutionItems) = preProject
  3.         .gitattributes = .gitattributes
  4.         .gitignore = .gitignore
  5.         README.md = README.md
  6.         build\Version.props = build\Version.props
  7.     EndProjectSection
  8. EndProject

这个解决方案文件夹中包含了四个文件，其路径分别记录在了 ProjectSection 节点里面。

ProjectSection 还可以记录项目依赖关系（非项目之间的真实依赖，而是解决方案级别的编译依赖）：

  1. Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Walterlv.Demo", "Walterlv.Demo\Walterlv.Demo.csproj", "{DC0B1D44-5DF4-4590-BBFE-072183677A78}"
  2.     ProjectSection(ProjectDependencies) = postProject
  3.         {98FF9756-B95A-4FDB-9858-5106F486FBF3} = {98FF9756-B95A-4FDB-9858-5106F486FBF3}
  4.     EndProjectSection
  5. EndProject
  6. Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Walterlv.Demo2", "Walterlv.Demo2\Walterlv.Demo2.csproj", "{98FF9756-B95A-4FDB-9858-5106F486FBF3}"
  7. EndProject

在这一段节点里面，我们的 Walterlv.Demo 项目依赖于另外一个 Walterlv.Demo2 项目。依赖是以 项目 Id = 项目 Id 的方式写出来的；如果有多个依赖，那么就写多行。不用吐槽为什么一样还要写两遍，因为这是一个固定的格式，后面我们会介绍一些全局配置里面会有两个不一样的。

关于设置项目依赖关系的方法，除了 sln 文件里面的设置之外，还有通过设置项目依赖属性的方式;

全局信息

一个全局信息的例子如下：

  1. Global
  2.     GlobalSection(SolutionConfigurationPlatforms) = preSolution
  3.         Debug|Any CPU = Debug|Any CPU
  4.         Release|Any CPU = Release|Any CPU
  5.     EndGlobalSection
  6.     GlobalSection(ProjectConfigurationPlatforms) = postSolution
  7.         {DC0B1D44-5DF4-4590-BBFE-072183677A78}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
  8.         {DC0B1D44-5DF4-4590-BBFE-072183677A78}.Debug|Any CPU.Build.0 = Debug|Any CPU
  9.         {DC0B1D44-5DF4-4590-BBFE-072183677A78}.Release|Any CPU.ActiveCfg = Release|Any CPU
  10.         {DC0B1D44-5DF4-4590-BBFE-072183677A78}.Release|Any CPU.Build.0 = Release|Any CPU
  11.         {98FF9756-B95A-4FDB-9858-5106F486FBF3}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
  12.         {98FF9756-B95A-4FDB-9858-5106F486FBF3}.Debug|Any CPU.Build.0 = Debug|Any CPU
  13.         {98FF9756-B95A-4FDB-9858-5106F486FBF3}.Release|Any CPU.ActiveCfg = Release|Any CPU
  14.         {98FF9756-B95A-4FDB-9858-5106F486FBF3}.Release|Any CPU.Build.0 = Release|Any CPU
  15.     EndGlobalSection
  16.     GlobalSection(SolutionProperties) = preSolution
  17.         HideSolutionNode = FALSE
  18.     EndGlobalSection
  19.     GlobalSection(ExtensibilityGlobals) = postSolution
  20.         SolutionGuid = {F2F1AD1B-207B-4731-ABEB-92882F89B155}
  21.     EndGlobalSection
  22. EndGlobal

在这个全局信息的例子中，为解决方案指定了两个配置（Configuration），Debug 和 Release，平台都是 Any CPU。同时也为每个项目指定了单独的配置种类，可供选择，每一行都是 项目的配置 = 解决方案的配置 表示此项目的此种配置在解决方案的某个全局配置之下。

如果我们将这两个项目放到文件夹中，那么我们可以额外看到一个新的全局配置 NestedProjects 字面意思是说 {DC0B1D44-5DF4-4590-BBFE-072183677A78} 和 {98FF9756-B95A-4FDB-9858-5106F486FBF3} 两个项目在 {20B61509-640C-492B-8B33-FB472CCF1391} 项目中嵌套，实际意义代表 Walterlv.Demo 和 Walterlv.Demo2 两个项目在 Folder 文件夹下。

  1. GlobalSection(NestedProjects) = preSolution
  2.     {DC0B1D44-5DF4-4590-BBFE-072183677A78} = {20B61509-640C-492B-8B33-FB472CCF1391}
  3.     {98FF9756-B95A-4FDB-9858-5106F486FBF3} = {20B61509-640C-492B-8B33-FB472CCF1391}
  4. EndGlobalSection

理解 Visual Studio 解决方案文件格式（.sln） - 图2

上图解决方案下的整个解决方案全部内容如下：

  1. Microsoft Visual Studio Solution File, Format Version 12.00
  2. # Visual Studio Version 16
  3. VisualStudioVersion = 16.0.29102.190
  4. MinimumVisualStudioVersion = 10.0.40219.1
  5. Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Walterlv.Demo", "Walterlv.Demo\Walterlv.Demo.csproj", "{DC0B1D44-5DF4-4590-BBFE-072183677A78}"
  6.     ProjectSection(ProjectDependencies) = postProject
  7.         {98FF9756-B95A-4FDB-9858-5106F486FBF3} = {98FF9756-B95A-4FDB-9858-5106F486FBF3}
  8.     EndProjectSection
  9. EndProject
  10. Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Walterlv.Demo2", "Walterlv.Demo2\Walterlv.Demo2.csproj", "{98FF9756-B95A-4FDB-9858-5106F486FBF3}"
  11. EndProject
  12. Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Folder", "Folder", "{20B61509-640C-492B-8B33-FB472CCF1391}"
  13. EndProject
  14. Global
  15.     GlobalSection(SolutionConfigurationPlatforms) = preSolution
  16.         Debug|Any CPU = Debug|Any CPU
  17.         Release|Any CPU = Release|Any CPU
  18.     EndGlobalSection
  19.     GlobalSection(ProjectConfigurationPlatforms) = postSolution
  20.         {DC0B1D44-5DF4-4590-BBFE-072183677A78}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
  21.         {DC0B1D44-5DF4-4590-BBFE-072183677A78}.Debug|Any CPU.Build.0 = Debug|Any CPU
  22.         {DC0B1D44-5DF4-4590-BBFE-072183677A78}.Release|Any CPU.ActiveCfg = Release|Any CPU
  23.         {DC0B1D44-5DF4-4590-BBFE-072183677A78}.Release|Any CPU.Build.0 = Release|Any CPU
  24.         {98FF9756-B95A-4FDB-9858-5106F486FBF3}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
  25.         {98FF9756-B95A-4FDB-9858-5106F486FBF3}.Debug|Any CPU.Build.0 = Debug|Any CPU
  26.         {98FF9756-B95A-4FDB-9858-5106F486FBF3}.Release|Any CPU.ActiveCfg = Release|Any CPU
  27.         {98FF9756-B95A-4FDB-9858-5106F486FBF3}.Release|Any CPU.Build.0 = Release|Any CPU
  28.     EndGlobalSection
  29.     GlobalSection(SolutionProperties) = preSolution
  30.         HideSolutionNode = FALSE
  31.     EndGlobalSection
  32.     GlobalSection(NestedProjects) = preSolution
  33.         {DC0B1D44-5DF4-4590-BBFE-072183677A78} = {20B61509-640C-492B-8B33-FB472CCF1391}
  34.         {98FF9756-B95A-4FDB-9858-5106F486FBF3} = {20B61509-640C-492B-8B33-FB472CCF1391}
  35.     EndGlobalSection
  36.     GlobalSection(ExtensibilityGlobals) = postSolution
  37.         SolutionGuid = {F2F1AD1B-207B-4731-ABEB-92882F89B155}
  38.     EndGlobalSection
  39. EndGlobal

如约智惠
您身边的生活助手
如约智惠.jpg