核心用法
Microsoft Code Reference 是面向 Azure SDK、.NET 生态及 Microsoft Graph 开发者的权威代码验证工具。通过三个核心能力构建完整工作流：
1. API 精准检索 (microsoft_docs_search)：按命名空间+类名+方法名定位官方文档，支持验证方法是否存在、参数签名、所属 NuGet/PyPI 包。
2. 可运行代码片段 (microsoft_code_sample_search)：按任务描述+编程语言获取微软官方维护的 working samples，覆盖初始化、认证、异常处理等完整上下文。
3. 深度文档获取 (microsoft_docs_fetch)：针对重载方法、复杂参数或完整类定义，拉取原始文档页面。
典型场景：编写 Blob 上传代码前，先检索 "BlobClient UploadAsync Azure.Storage.Blobs" 确认方法签名，再获取 "upload blob managed identity" Python 样例比对实现，最后针对 403 错误查询 "Azure Blob Storage RBAC permissions" 排查权限配置。
显著优点
- 权威性：直接对接 Microsoft Learn MCP Server 与官方代码仓库，信息源为微软维护的实时文档
- 防幻觉：显式设计用于捕获 LLM 易犯的错误方法名（如虚构
UploadFile）、错误命名空间、已废弃的 v11 SDK 模式 - 多语言覆盖：C#、Python、JavaScript/TypeScript、Java 等 Azure SDK 主流语言均有官方样例
- 混合工作流支持：提供
mslearnCLI 降级方案，MCP 不可用时仍可命令行查询
潜在局限
- 生态边界：专注微软技术栈，对 AWS/GCP/非微软服务无覆盖
- 版本时效依赖：若 Learn 文档本身存在滞后（如预览版 API），工具同样反映延迟
- 离线不可用：需网络连接至 Microsoft Learn 服务
- CLI 降级体验：
npx mslearn需 Node.js 环境，纯 Python 开发者可能需额外配置
适合人群
- 使用 Azure SDK (v12+)、Microsoft Graph、.NET 框架的开发者
- 需要验证 Copilot/ChatGPT 生成代码准确性的高级工程师
- 维护跨版本 SDK 迁移（如 Storage v11→v12）的 DevOps 团队
常规风险
| 风险类型 | 说明与缓解 |
|---------|-----------|
| 误信过时文档 | 微软文档偶有版本标记不清，关键 API 应交叉验证发布日期与 GitHub 源码 |
| 权限配置遗漏 | 代码样例假设 RBAC/连接字符串已就绪，生产部署需额外验证身份链 |
| CLI 执行风险 | `npx` 执行远程包，建议固定版本或改用全局安装后的可信本地副本 |