Microsoft.Build.Evaluation.Project 是读取 .csproj 最直接方式，能保留注释、空行和顺序，但需显式调用 MSBuild.Initialize() 并用 Project.Xml.Save() 保格式，避免 project.Save() 重排。

用 Microsoft.Build.Evaluation.Project 读取 .csproj 是最直接的方式

MSBuild 提供了官方 API，Microsoft.Build.Evaluation.Project 类能加载、解析并保留原始格式（包括注释、空行、属性组顺序），比直接 XML 解析更安全。但注意：它依赖当前 MSBuild 环境（如 SDK 版本、全局属性），不是纯静态解析器。

• 必须引用 Microsoft.Build 和 Microsoft.Build.Framework NuGet 包（建议 v17.0+，兼容 .NET 6/7/8）
• 首次调用 ProjectCollection.GlobalProjectCollection 前需初始化：调用 MSBuild.Initialize()（.NET 5+ 必须显式调用）
• 加载时若项目含 SDK（如 <sdk></sdk>），会触发自动导入逻辑，可能报错——此时应传入 new ProjectOptions { LoadSettings = ProjectLoadSettings.IgnoreMissingImports }
• 示例加载：

  MSBuild.Initialize();
  var project = Project.FromFile("MyApp.csproj", new ProjectOptions {
      LoadSettings = ProjectLoadSettings.IgnoreMissingImports
  });

修改 PropertyGroup 或 ItemGroup 要用 Project.Xml 而非 Project.Properties

Project.Properties 返回的是求值后的只读快照（例如 TargetFramework 的值是 "net6.0"），不能用于写入；真正可编辑的是底层 XML 树 Project.Xml。直接改 Properties 不会保存，也不会影响磁盘文件。

C#

"避开 C# 常见错误——空陷阱、异步陷阱、LINQ 陷阱及资源泄漏。"

下载

• 添加新属性：

  var propertyGroup = project.Xml.AddPropertyGroup();
  propertyGroup.AddProperty("PublishTrimmed", "true");

• 修改现有属性（需先定位）：

  var tfProp = project.Xml.PropertyGroups
      .FirstOrDefault(pg => pg.Properties.Any(p => p.Name == "TargetFramework"));
  if (tfProp != null) {
      tfProp.Properties.First(p => p.Name == "TargetFramework").Value = "net8.0";
  }

• 修改 PackageReference：

  var pkgRef = project.Xml.ItemGroups
      .SelectMany(g => g.Items)
      .FirstOrDefault(i => i.Name == "PackageReference" && i.Include == "Newtonsoft.Json");
  if (pkgRef != null) pkgRef.SetAttribute("Version", "13.0.3");

保存后格式错乱？记得调用 Project.Save() 并禁用自动重排

直接 project.Save() 会触发 MSBuild 内部的 XML 序列化，默认会删空行、合并属性、重排元素顺序——这会让团队协作时 Git Diff 失控。要保留人工排版，必须绕过默认行为。

• 正确做法：用 project.Xml.Save(filePath) 替代 project.Save()
• 原因：Project.Xml 是 Microsoft.Build.Construction.ProjectXml 实例，其 Save() 方法保持原始缩进与顺序（前提是原始文件本身没被 MSBuild 自动重写过）
• 如果项目含 <import></import> 且路径含属性（如 $(MSBuildThisFileDirectory)..\build\*.targets），保存后属性不会展开——这是预期行为，无需手动替换
• 警告：若项目使用 <project sdk="..."></project> 语法，Project.Xml.Save() 仍能写入，但部分 SDK 导入逻辑可能在下次加载时重新注入内容

遇到“Invalid static method invocation syntax”或“MSB4057”错误？检查 MSBuild 工具版本和上下文

这类错误通常不是代码写错了，而是运行环境不匹配。例如在 .NET Core 进程中加载了旧版 MSBuild 任务，或未设置必要全局属性。

• 确保目标框架与 MSBuild 版本对齐：.NET 6+ 项目推荐用 MSBuild 17.x（随 Visual Studio 2022 或 dotnet msbuild 提供）
• 加载前设置关键全局属性（尤其跨平台时）：

  var collection = ProjectCollection.GlobalProjectCollection;
  collection.GlobalProperties["MSBuildExtensionsPath"] = @"C:\Program Files\Microsoft Visual Studio\2022\Community\MSBuild";
  collection.GlobalProperties["VisualStudioVersion"] = "17.0";

• 避免在 ASP.NET Core 请求线程中调用：MSBuild API 非线程安全，高并发下可能崩溃，应限定在后台任务或 CLI 工具中使用
• 调试技巧：捕获 InvalidProjectFileException，检查 .Message 中是否含具体行号和“unexpected token”，常因 XML 注释格式异常（如 --> 出现在注释体中间）导致

实际操作中最容易忽略的是 MSBuild.Initialize() 调用时机和 Project.Xml.Save() 与 Project.Save() 的语义差异——前者保格式，后者重排版，选错就等于白改。