通俗易懂--.csproj 文件

.csproj 文件

.csproj，是C#项目文件的扩展名，它是“C Sharp Project”的缩写。.net开发环境中建立项目时，会产生.csproj文件，这是C#的工程文件，其中记录了与工程有关的相关信息，例如包含的文件，程序的版本，所生成的文件的类型和位置信息等。

【作用】

.csproj究竟是做什么用的？它是给开发工具用的，例如我们再熟悉不过的Visual Studio，以及大家可能没有接触过的MSBuild.exe。

Visual Studio会根据csproj里的XML定义来管理项目文件以及相关其他一些种类非常丰富的数据及操作，MSBuild也会根据csproj文件来得知编译这个项目需要有哪些依赖，默认输出路径，Pre-Build和Post-Build需要哪些操作等。

Visual Studio和MSBuild都是开发工具，这就是csproj存在的唯一意义：为“开发工具”提供信息。而到了运行环境中，根本不会有人关心所谓的csproj文件——也就是“程序是从哪里来的”。

即.csproj类似于工程图纸

【各个部件的作用】

PropertyGroup(存放属性)

PropertyGrouph是用来存放属性的地方，这与它的名字非常契合。

在这里写属性就像在代码中定义属性或变量一样，只要写了，就会生成一个指定名称的属性。

比如，我们写：

1. <PropertyGroup>

2. <Foo> watermelon is a fruit </Foo>

3. </PropertyGroup>

那么，就会生成一个 Foo 属性，值为字符串 watermelon is a fruit。至于这个属性有什么用，那就不归这里管了。

PropertyGroup可以定义很多个，里面都可以同等地放属性。至于为什么会定义多个，原因无外乎有两个：

1. 增加可读性 —— 将一组相关的属性放在一起，便于阅读和理解意图；
2. 便于加条件 —— 有的属性在 Debug 和 Release 下不一样（例如条件编译符 DefineConstants）。

ItemGroup(存放集合)

ItemGroup是用来指定集合的地方。

集合里面一些常见的项：

• Reference：引用某个程序集
• PackageReference：引用某个NuGet包
• ProjectReference：引用某个项目
• Compile：常规的 C# 编译
• None：执行一些通用的操作（或者只是为了在 Visual Studio 列表中能够有一个显示）
• Folder：一个空的文件夹

ItemGroup 也可以放很多组，同样是为了提升可读性或者增加条件。

Import(导入)

Import是为了导入属性（props）和Targets（后面会具体说Targets）。

被我们 Import 进来的那些文件，可以用两种扩展名表示，一种是用来定义属性，为 .props；另一种用来定义行为，为 .targets。这两种文件除了含义不同以外，内容的格式都是完全一样的 —— 即 csproj 文件格式。

虽然 csproj 文件中可以完全实现引入的 props 文件的功能，但为了在多个项目中使用，一处更新，到处生效，因此选择单独用 props 文件来存放。

Target

一般来说， Target 节点写在 csproj 文件的末尾，但这个并不是强制的。Targets 是一种非常强大的功能扩展方式，支持 msbuild 预定义的一些指令，支持命令行，甚至支持使用 C# 直接编写（当然编译成 dll 会更方便些），还支持这些的排列组合和顺序安排。而我们实质上的编译过程便全部由这些 Targets 来完成。甚至可以说，编译过程就是靠这些 Target 的组合来完成的。

Project

所有的 csproj 文件都是以 Project 节点为根节点。

下面列出新旧两款 csproj 文件格式的差异：

其中，在各部件中，白色代表必须，灰色代表可选；而更接近背景色的灰色代表一般情况下都是不需要的。

可以看出，新格式的最大好处之一就是简洁。而这一优势，靠的就是 Project 节点，新格式中的 Project 节点有 sdk 属性 —— 所谓 sdk，其实是一大波 .targets 文件的集合。它帮我们导入了公共的属性、公共的编译任务，还帮我们自动将项目文件夹下所有的 **\*.cs 文件都作为 ItemGroup 的项引入进来。

【 .sln 和 .csproj 的区别】

1. .sln：即 solution，解决方案

    .csproj：即 C sharp project，C# 项目

2. 解决方案是项目的集合，项目是文件的集合；一个 sln 中可以包含多个 csproj。一个 csproj 可以包含多个文件； csproj 可以作为单独的项目运行，也可以在 sln 中添加 csproj 统一管理。

3. sln 和 csproj 都可以双击运行，如果解决方案中只有一个项目(就是说一个项目对应一个csproj)，但是一个解决方案会包含多个项目，那么两个方式是没有区别的；但是如果一个解决方案中包含多个项目， sln 会加载该解决方案中所有的项目，而 csproj 只会加载当前项目。

4. 关于 sln 和 csproj 的几个问题

（1）C#、.net 中，.sln 文件可以删掉重新生成吗？

.sln 是项目文件，删除后项目的一些设置会无法恢复，因为解决方案里面可能有关于这个项目文件的很多信息，所以一般不建议删除重建；但一般也没有太大的问题，用VS直接打开 .csproj 工程文件，会自动建上 sln 的。

（2）下载的 ASP.net 源码没有.sln 或 .csproj 文件如何使用？

从 Visual Studio IDE 的菜单  "文件" --> "打开" --> "网站" ，然后从右边的目录中选择要打开的网站目录，不需要有 .sln 文件就可以打开网站并调试运行。如果是 WebSite 模式那么是不需要 .sln 文件的，可以通过 File -> WebSite -> OpenWebSite 打开。如果不是 WebSite 模式，那么可以自己建立一个空项目，然后把文件 Copy 进去即可。

参考链接：初学C#，总结一下.sln和.csproj的区别_c# sln-CSDN博客