进行 C#/.NET、Blazor 或 Unity…

适用于使用 C# 与 .NET 进行后端、Blazor 前端或 Unity 游戏开发时，快速落实代码风格、命名、现代语法、错误处理、API 设计、性能、依赖注入、测试与安全等最佳实践。

适用场景

解决思路

1. 编写简洁、符合惯用法的 C# 代码，并提供准确的示例。
2. 遵循 .NET 和 C# 约定与最佳实践。
3. 视情况使用面向对象和函数式编程模式。
4. 集合操作优先使用 LINQ 和 lambda 表达式。
5. 使用描述性的变量和方法名（例如 `IsUserLoggedIn`、`GetUserById`）。
6. 按 .NET 约定组织文件结构（Controllers、Models、Services 等）。
7. 类名、方法名和公共属性使用 PascalCase。
8. 局部变量和私有字段使用 camelCase。
9. 常量使用 SCREAMING_SNAKE_CASE。
10. 接口以 `I` 为前缀（例如 `IUserService`）。
11. 私有字段以下划线为前缀（例如 `_userRepository`）。
12. 使用文件范围命名空间使代码更简洁。
13. 对常用命名空间使用 global usings。
14. 利用 records 表示不可变数据类型。
15. 使用模式匹配进行类型检查和解构。
16. 使用可空引用类型并正确标注。
17. 对简单方法和属性使用表达式成员。
18. 使用目标类型 new 表达式（`new()`）。
19. 使用 switch 表达式编写简洁的条件逻辑。
20. 优先使用字符串内插而非字符串拼接。
21. 对预期异常使用 try-catch 块。
22. 为领域特定错误创建自定义异常类。
23. 使用 `ArgumentNullException.ThrowIfNull()` 进行参数验证。
24. 在合适时使用 Result 模式表示操作结果。
25. 记录异常时附带上下文信息。
26. Web API 遵循 RESTful 约定。
27. 使用 DTO 在层之间传输数据。
28. 实现正确的 HTTP 状态码。
29. 使用 action filters 处理横切关注点。
30. 为 API 合理设置版本。
31. 对 I/O 密集型操作使用 `async/await`。
32. 在合适的地方实现缓存。
33. 在循环中进行字符串拼接时使用 `StringBuilder`。
34. 使用泛型避免装箱/拆箱。
35. 在高性能场景使用 `Span<T>` 和 `Memory<T>`。
36. 对依赖使用构造函数注入。
37. 使用合适的生命周期注册服务（Scoped、Transient、Singleton）。
38. 使用接口作为服务抽象。
39. 在 `Program.cs` 或 `Startup.cs` 中配置 DI。
40. 使用 xUnit 或 NUnit 编写单元测试。
41. 使用 Moq 或 NSubstitute 进行 mocking。
42. 遵循 Arrange-Act-Assert 模式。
43. 争取对业务逻辑有高测试覆盖率。
44. 使用 FluentAssertions 编写可读的断言。
45. 验证所有用户输入。
46. 使用参数化查询或 Entity Framework 防止 SQL 注入。
47. 实现正确的身份验证和授权。
48. 将机密存储在配置中（User Secrets、Azure Key Vault）。
49. 所有通信使用 HTTPS。
50. 使用基于组件的架构。
51. 实现合适的状态管理。
52. 使用级联参数共享状态。
53. 使用 `@key` 和虚拟化优化渲染。
54. 恰当处理组件生命周期事件。
55. 使用 MonoBehaviour 实现游戏对象行为。
56. 使用 ScriptableObjects 作为数据容器。
57. 遵循 Component 模式实现模块化。
58. 使用协程处理基于时间的操作。
59. 对频繁实例化的对象实现对象池。

适用边界 · 注意事项

• 非 C#/.NET 项目或团队不使用 C# 技术栈时，不应套用这些规范。
• 当项目已有强制且不同的代码风格/命名约定时，不应生搬硬套。
• Blazor 或 Unity 特定建议仅适用于对应框架/引擎，不涉及这些场景时无需采用。