用 Microsoft.Build.Evaluation.Project
读取 .csproj 是最直接的方式
MSBuild 提供了官方 API，
Microsoft.Build.Evaluation.Project类能加载、解析并保留原始格式（包括注释、空行、属性组顺序），比直接 XML 解析更安全。但注意：它依赖当前 MSBuild 环境（如 SDK 版本、全局属性），不是纯静态解析器。 必须引用
Microsoft.Build和
Microsoft.Build.FrameworkNuGet 包（建议 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不会保存，也不会影响磁盘文件。 添加新属性：
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()的语义差异——前者保格式，后者重排版，选错就等于白改。
