寻求.NET/VS生态中操作解决方案与项目文件的DOM式API

1. MSBuild 原生 API（推荐无VS依赖场景） #

MSBuild的Microsoft.Build.Evaluation和Microsoft.Build.Execution命名空间提供了完全独立于Visual Studio的强类型API，能直接操作项目文件和解决方案，跨平台支持.NET Core/.NET 5+，完全匹配你的强类型编程需求。

核心能力： #

• 创建/加载.NET项目，可指定目标框架（如.NET 8）
• 强类型设置项目属性（如TargetFramework、OutputType）
• 添加代码文件并配置Build Action等属性
• 添加项目引用、NuGet包引用
• 通过SolutionFile类操作解决方案文件

代码示例： #

创建.NET 8类库项目并添加文件

using Microsoft.Build.Evaluation;
using System.IO;

// 定义项目路径
string projectPath = Path.Combine(Directory.GetCurrentDirectory(), "MyLibrary.csproj");

// 初始化项目模板，指定.NET 8为目标框架
Project project = Project.FromString(@"<Project Sdk=""Microsoft.NET.Sdk"">
  <PropertyGroup>
    <TargetFramework>net8.0</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
  </PropertyGroup>
</Project>");

// 创建类文件并添加到项目，设置Build Action为Compile
string classFilePath = Path.Combine(Directory.GetCurrentDirectory(), "MyClass.cs");
File.WriteAllText(classFilePath, "namespace MyLibrary { public class MyClass {} }");
project.AddItem("Compile", classFilePath);

// 保存项目
project.Save(projectPath);

添加项目引用并操作解决方案

// 加载或创建解决方案文件
string solutionPath = Path.Combine(Directory.GetCurrentDirectory(), "MySolution.sln");
SolutionFile solution = SolutionFile.Parse(solutionPath);

// 将新创建的项目添加到解决方案
solution.AddProject(projectPath, "MyLibrary", "MyLibrary");

// 加载另一个项目并添加项目引用
Project appProject = ProjectCollection.GlobalProjectCollection.LoadProject("MyApp.csproj");
appProject.AddItem("ProjectReference", projectPath);
appProject.Save();

// 保存解决方案
solution.Save();

2. Visual Studio SDK (EnvDTE/EnvDTE80)（依赖VS安装） #

你提到的VS SDK中的EnvDTE是Visual Studio的自动化API，可以作为独立COM API调用，但要求目标机器必须安装Visual Studio。它提供了完全贴合VS IDE模型的强类型对象，能完整模拟用户在VS中的操作逻辑。

核心能力： #

• 强类型创建/管理解决方案、项目
• 设置项目属性（目标框架、输出类型等）
• 添加文件并配置Build Action
• 添加项目引用、NuGet引用
• 支持操作VS的窗口、命令等扩展能力（按需使用）

代码示例（外部调用VS自动化） #

using EnvDTE80;
using System.Runtime.InteropServices;

// 启动或连接到VS实例（版本号对应你的VS版本，VS2022为17.0）
DTE2 dte = (DTE2)Marshal.GetActiveObject("VisualStudio.DTE.17.0");
dte.MainWindow.Visible = true;

// 创建新解决方案
Solution2 solution = (Solution2)dte.Solution;
solution.Create(@"C:\MySolution", "MySolution");

// 添加.NET 8类库项目
string templatePath = solution.GetProjectTemplate("ClassLibrary", "CSharp");
solution.AddFromTemplate(templatePath, @"C:\MySolution\MyLibrary", "MyLibrary", false);

// 获取项目并设置目标框架为.NET 8
Project project = solution.Projects.Item(1);
project.Properties.Item("TargetFramework").Value = "net8.0";

// 添加类文件并设置Build Action为Compile
ProjectItem classItem = project.ProjectItems.AddFromFile(@"C:\MySolution\MyLibrary\MyClass.cs");
classItem.Properties.Item("BuildAction").Value = 1; // 1对应Compile枚举值

注意事项： #

• 需要引用EnvDTE和EnvDTE80程序集（可通过NuGet或VS安装目录获取）
• 不同VS版本的ProgID不同，需对应调整
• 仅支持Windows平台，且依赖VS安装环境

3. 排除选项说明 #

你提到的CSCodeProvider、Roslyn（Microsoft.CodeAnalysis）不符合需求：

• CSCodeProvider仅用于编译代码，无法操作项目/解决方案结构
• Roslyn的Workspace API核心目标是代码分析，而非项目结构的创建与管理

建议总结 #

• 若需要跨平台、无VS依赖的方案，优先使用MSBuild原生API，它是.NET生态的标准项目操作工具，完全覆盖你的需求
• 若必须严格贴合VS项目模型，且运行环境保证有VS安装，可使用EnvDTE自动化API，其强类型模型更贴近VS操作逻辑

内容的提问来源于stack exchange，提问作者Raheel Khan