修改.NET Runtime添加Dictionary2类后无法在项目中调用的问题排查

你可能遗漏的关键步骤及修改内容 #

• 访问修饰符与命名空间一致性：确保你在System.Collections.cs（引用程序集）和Dictionary.cs（实现程序集）中创建的Dictionary2类都标记为public，并且和原Dictionary保持相同的命名空间System.Collections.Generic。原Dictionary是公开可见的，若复制时未显式添加public，默认访问级别为internal，会导致外部应用无法访问。
• 项目文件与编译范围：检查System.Collections库的项目文件（如src/libraries/System.Collections/System.Collections.csproj），确认新增的Dictionary2类型被正确纳入编译范围。修改源码后需重新编译相关库，不要复用旧编译结果，执行命令：.\build.cmd -s System.Collections+System.Private.CoreLib，确保生成的DLL包含最新的Dictionary2。
• 引用路径与运行时绑定：控制台应用默认会使用系统或NuGet提供的.NET Runtime库，你需要强制应用使用自定义编译版本。可通过修改项目文件，添加对编译后的System.Collections.dll和System.Private.CoreLib.dll的绝对路径引用；或使用dotnet run --runtime C:\rt5\artifacts\bin\coreclr\windows.x64.Debug（根据你的编译目标路径调整）指定自定义运行时。

排查步骤 #

• 检查类型可见性：用DotPeek打开编译后的System.Collections.dll和System.Private.CoreLib.dll，确认Dictionary2的访问修饰符为public，且两个程序集中的类型定义完全一致。
• 解析编译错误详情：提取控制台应用的具体编译错误信息（如“找不到类型”“无法访问私有成员”），直接定位问题——若提示“无法访问”，大概率是访问修饰符问题；若提示“找不到类型”，可能是程序集引用错误或编译时未包含该类型。
• 验证编译结果：重新编译时查看build.cmd的输出日志，检查是否存在关于Dictionary2的编译警告或错误，确认相关程序集生成成功，路径正确（一般在C:\rt5\artifacts\bin下对应库的目录）。
• 隔离测试：创建极简控制台项目，仅引用自定义编译的System.Collections.dll，尝试编写using System.Collections.Generic; var dict = new Dictionary2<int, string>();，看是否能正常编译，逐步排除其他依赖干扰。

推荐学习资源 #

• .NET Runtime源码仓库中的CONTRIBUTING.md和BUILDING.md：详细讲解编译流程、项目结构和源码修改的基本规范。
• 《.NET Core 底层原理与实战》：涵盖.NET运行时核心库的设计、编译和调试方法，适合探索源码时参考。
• 微软官方.NET Runtime技术博客：包含大量核心库实现细节的深度解析，帮助理解类型系统和程序集加载机制。

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