.NET 开发助手

这个技能能帮你做什么

如果你在用 C# 和 .NET 开发项目，这个技能能帮你写出更规范、更可靠的代码。它不是教你 C# 语法，而是告诉你好的 .NET 项目应该怎么组织、怎么设计、怎么处理常见问题。

简单说，它能帮你：

• 组织代码 —— 类怎么设计、依赖怎么管理、代码怎么分层
• 安全编码 —— 避免空值、处理好异步操作、防止资源泄漏
• 提升可维护性 —— 代码结构清晰，后期修改不容易引入问题
• 处理配置 —— 配置文件怎么管理、不同环境怎么切换
• 设计 API —— 接口怎么设计更合理、错误怎么处理更优雅

什么时候用

项目启动时 —— 先确定技术方案和代码规范，再开始开发

写新功能时 —— 不确定某个功能怎么实现最规范？它会给你最佳实践

审查代码时 —— 检查代码是否符合 .NET 社区推荐的做法

重构时 —— 把旧的、混乱的代码整理成结构清晰、易维护的样子

学习时 —— 了解 .NET 生态中常用的设计模式和最佳实践

主要覆盖哪些场景

1. 数据模型设计
   • 优先使用不可变对象，数据一旦创建就不修改
   • 使用记录类型（record）简化数据对象的定义
   • 正确处理空值，明确标注哪些字段可为空
2. 依赖管理
   • 通过接口解耦模块，降低代码间的耦合度
   • 使用依赖注入框架自动组装各个模块
   • 避免在代码中直接创建依赖，方便后续替换和测试
3. 异步编程
   • 正确使用 async/await 处理异步操作
   • 避免阻塞线程导致的性能问题
   • 合理使用并行操作提升效率
   • 传递取消信号，让长时间操作可以被中断
4. 配置管理
   • 将配置文件映射为强类型对象
   • 支持不同环境（开发、测试、生产）的配置切换
   • 避免在代码中硬编码配置值
5. 错误处理
   • 使用结果对象（Result Pattern）明确表达操作的成功或失败
   • 提前验证输入参数，失败尽早返回
   • 合理设计异常层次，方便调用方处理
6. 数据访问
   • 使用仓库模式封装数据访问逻辑
   • 合理配置数据库查询，避免性能问题
   • 处理数据映射和转换
7. Web 应用
   • 设计清晰的 API 接口和路由
   • 使用中间件处理通用的请求逻辑（如日志、认证）
   • 处理请求和响应的标准化

怎么用

设计模块时 —— 告诉它"我要设计一个订单模块"，它会建议合适的结构和模式

不确定怎么写时 —— 问它"这个场景用异步还是同步？"或"怎么处理这个错误？"

审查代码时 —— 把代码发给它，它会指出不符合最佳实践的地方

优化性能时 —— 它会告诉你哪些写法可能导致性能问题、怎么优化

核心原则

做 .NET 开发时，记住这几条原则：

1. 不可变优先 —— 数据一旦创建就不修改，通过创建新对象来更新
2. 显式优于隐式 —— 明确标注空值、权限等，不要依赖默认值
3. 依赖抽象 —— 依赖接口而不是具体实现，方便替换和测试
4. 异步到底 —— 用了 async 就一路 async，不要混用同步阻塞
5. 尽早失败 —— 输入有问题就立即返回，不要在后面才报错
6. 单一职责 —— 每个类、每个方法只做一件事

适用场景

• ASP.NET Core Web 应用开发
• .NET 后端服务开发
• 企业级应用架构设计
• 代码审查和质量提升
• 从旧版本 .NET 迁移到新版
• 学习 .NET 最佳实践

不适用场景

• 前端开发（如 React、Vue、Angular）
• 移动端开发（虽然 .NET 有 MAUI，但主要针对后端模式）
• 纯脚本编写（如 Python、Shell 脚本）
• 数据库设计（虽然涉及数据访问，但不涉及数据库架构设计）