开发 Go 1.22+ 与 NestJS…

适用于以 Go 标准库（1.22+）或 NestJS TypeScript 构建可扩展 API，并需要统一错误处理、输入校验、模块化架构与安全最佳实践的场景。

适用场景

解决思路

1. 使用最新稳定版 Go（1.22 或更高版本）。
2. 使用 net/http 包处理 HTTP。
3. 优先使用 Go 标准库，再引入外部依赖。
4. 使用 http.NewServeMux() 进行路由（Go 1.22+ 增强模式）。
5. 实现正确的 HTTP 方法处理。
6. 为所有响应返回合适的状态码。
7. 安全地处理请求体解析。
8. 实现全面的错误处理。
9. 向客户端返回有意义的错误消息。
10. 记录带有足够上下文的错误日志。
11. 为 API 特有故障使用自定义错误类型。
12. 校验所有传入请求数据。
13. 清洗输入以防止注入攻击。
14. 返回清晰的校验错误消息。
15. 尽早拒绝数据无效的请求。
16. 为横切关注点实现中间件。
17. 使用中间件进行日志记录和请求追踪。
18. 对受保护路由应用认证中间件。
19. 以中间件实现限流。
20. 所有代码和文档使用英文。
21. 为每个变量和函数声明类型。
22. 避免 any 类型；优先使用显式类型。
23. 启用严格 TypeScript 编译选项。
24. 类和接口使用 PascalCase。
25. 变量、函数和方法使用 camelCase。
26. 常量使用 SCREAMING_SNAKE_CASE。
27. 文件名使用 kebab-case。
28. 每个领域实现一个模块。
29. 保持模块专注且高内聚。
30. 仅导出必要组件。
31. 使用 barrel 文件整理导入。
32. 对所有输入和输出使用 DTO。
33. 使用 class-validator 装饰器进行校验。
34. 使用 class-transformer 转换数据。
35. 将 DTO 与领域实体分离。
36. 保持控制器轻薄。
37. 将业务逻辑委托给服务。
38. 使用正确的 HTTP 装饰器。
39. 实现一致的响应格式。
40. 实现共享可复用代码。
41. 提供 Configs：共享配置工具。
42. 提供 Decorators：自定义装饰器。
43. 提供 Guards：认证和授权。
44. 提供 Filters：异常过滤器。
45. 提供 Interceptors：请求/响应拦截器。
46. 提供 Pipes：校验和转换。
47. 实现认证守卫。
48. 使用基于角色的授权。
49. 在边界处校验所有输入。
50. 清洗输出以防止 XSS。

适用边界 · 注意事项

• 技术栈不是 Go 1.22+ 和 NestJS/TypeScript 时，不宜直接套用对应语言/框架的具体约定。
• 项目已有强制架构、命名或校验规范时，不应为遵循本技能而强行覆盖现有规范。
• 无法使用或升级到 Go 1.22+ 时，http.NewServeMux() 的增强路由模式等 Go 侧建议不适用。