.NET 文档

.NET 文档是微软官方维护的开发平台参考，托管于 Microsoft Learn。编码时遇到 API 疑问或需要示例代码，打开 learn.microsoft.com/zh-cn/dotnet/ 就能直接定位到权威说明。文档覆盖 C#、F#、Visual Basic 三种语言，提供 .NET、.NET Framework、ASP.NET Core、ML.NET、.NET Aspire 的完整类库参考，所有内容免费开放，无需订阅即可浏览。

按 API 名称快速检索类库说明

API 参考文档按命名空间和类组织，支持直接搜索方法名或类型名。例如输入“String.Format”或“HttpClient”，结果页会列出重载列表、参数说明和异常信息。中文版与英文版可一键切换，中文翻译质量较高，对不熟悉英文术语的开发者更友好。当前默认版本为 .NET 9（2024 年 11 月发布），后续将切换至 .NET 10，文档站会同步更新版本选择器，方便查阅不同版本的差异。

复制可运行的代码示例

多数 API 页面附带代码示例，涵盖控制台应用、Web API、gRPC 等常见项目类型。示例代码可直接复制到本地编辑器运行，减少了自行编写测试片段的时间。教程部分提供分步实战指南，从创建项目到部署发布，每一步都有对应代码和解释。数据访问指南中，Entity Framework Core、ADO.NET、Dapper 的使用模式与事务处理策略均有详细说明，帮助开发者选择合适的数据操作方式。

诊断工具与 CLI 命令参考

工具与诊断指南集中收录了 dotnet CLI、MSBuild、IL 链接器以及性能分析工具的用法。例如 dotnet-trace 用于收集运行时事件，dotnet-dump 用于分析内存转储，文档给出了典型命令和参数示例。DevOps 与测试文档则覆盖 CI/CD 管道集成、代码覆盖率统计和负载测试策略，为团队提供自动化构建与质量保障的参考。

从 .NET Framework 迁移的官方指南

对于仍在使用 .NET Framework 的项目，文档站提供了系统性的迁移指南，包括 API 兼容性分析、项目文件转换和运行时配置调整。迁移指南按版本划分，从 .NET Framework 4.x 到 .NET Core 再到 .NET 5+，每一步都有对照说明。同类官方文档如 Oracle Java 官方文档、Go 编程语言官方文档、Python 官方文档也提供类似参考，但 .NET 文档的免费、免登录特性以及持续更新至最新版本的做法，使其成为 .NET 开发者日常查询的常用入口。