VSCode新建项目为何不自动包含Reference Libraries？

Question

在VSCode中新建项目（如通过`mkdir myproj && cd myproj && dotnet new console`）后，项目虽能正常编译运行，但**Solution Explorer或引用节点下常不显示Reference Libraries（如.NET SDK内置的System、Microsoft.*等程序集）**。这是因为VSCode本身是轻量级编辑器，**不内置项目系统或MSBuild引擎**，其C#支持依赖C# Dev Kit（含OmniSharp或Razor Language Server），而这些工具默认仅解析项目文件（`.csproj`）显式声明的``或``，**不会自动枚举或展示SDK隐式引入的Reference Assemblies（由Microsoft.NETCore.App.Ref等共享框架提供）**。这并非配置错误，而是设计使然：.NET SDK通过``自动注入目标框架引用，但VSCode未将这类隐式引用纳入UI层级展示。开发者仍可正常使用`System.Console`等类型——IntelliSense与编译均不受影响，仅“引用列表”视觉缺失。解决方案非必需，但可通过安装“Project Manager for C#”等插件增强可视化，或理解其底层机制避免误判为环境异常。

Answer 1

```html

一、现象层：VSCode中“引用缺失”的视觉错觉

新建 dotnet new console 项目后，在 VSCode 的 Solution Explorer（或 C# Dev Kit 的 References 节点）中，System、Microsoft.Extensions.* 等基础程序集完全不可见。开发者第一反应常是“环境没装好”或“.csproj 配置错误”，但 Console.WriteLine("OK") 编译运行丝滑无误——这揭示了问题本质：是 UI 展示缺位，而非功能失效。

二、机制层：.NET SDK 隐式引用与编辑器能力边界的碰撞

• SDK 自动注入机制：现代 .NET SDK（≥5.0）通过 <Sdk>Microsoft.NET.Sdk</Sdk> 触发 Microsoft.NETCore.App.Ref 元包隐式解析，自动将 System.Runtime、System.Console 等 Reference Assemblies 注入编译上下文；
• VSCode 架构约束：VSCode 本身无 MSBuild 引擎，C# Dev Kit 依赖 OmniSharp（或新架构下的 Razor Language Server）做语义分析，而其 Project Model 仅枚举 <PackageReference> 和显式 <Reference>，对 SDK 内置的 FrameworkReference 不作 UI 映射；

三、验证层：用 CLI 和诊断工具交叉印证

执行以下命令可证实隐式引用真实存在且被正确加载：

dotnet msbuild -t:ShowResolvedReferences myproj.csproj
# 输出包含：System.Runtime.dll, System.Console.dll, Microsoft.NETCore.App.Ref/... 
dotnet build --verbosity:detailed | findstr "ReferenceAssemblies"

四、对比层：VS Code vs Visual Studio 的设计哲学差异

维度	Visual Studio	VSCode + C# Dev Kit
项目系统	内置完整 MSBuild 服务与 Solution (.sln) 模型	无原生项目系统，依赖语言服务器模拟轻量模型
引用可视化	显示 All References（含 FrameworkReference 隐式项）	仅显示显式声明项（<PackageReference> / <Reference>）

五、解法层：三类可行路径（按推荐度排序）

1. 认知升级（首选）：接受这是设计使然，非 Bug；IntelliSense、Go-to-Definition、编译均 100% 正常，无需干预；
2. 插件增强：安装 Project Manager for C# 或启用 C# Dev Kit 的 "csharp.showReferencesInSolutionExplorer": true（部分版本支持）；
3. 显式声明（不推荐）：在 .csproj 中手动添加 <FrameworkReference Include="Microsoft.NETCore.App" /> —— 可强制出现在 UI，但破坏 SDK 默认行为，易引发版本冲突。

六、延伸思考：为什么 .NET SDK 要隐藏这些引用？

这是微软向“约定优于配置”演进的关键实践：
✅ 减少模板噪声（.csproj 从 30 行压缩至 5 行）
✅ 避免开发者误删/降级核心框架引用
✅ 支持跨平台统一元数据（Windows/macOS/Linux 共享同一 SDK Ref 包）
⚠️ 副作用：编辑器 UI 层需适配新范式，VSCode 尚未全量对齐。

七、流程图：引用解析与展示的分离路径

graph LR
A[dotnet new console] --> B[生成 .csproj]
B --> C[SDK 解析 FrameworkReference]
C --> D[MSBuild 编译时注入 System.*]
D --> E[编译/运行成功]
C -.-> F[OmniSharp 读取 .csproj]
F --> G[仅提取显式 <PackageReference>]
G --> H[Solution Explorer 显示为空]
E -.-> H

```