38820
写 NestJS 的时候，用 Copilot / Cursor / Claude Code 生成的代码经常有几类框架层面的错：模块循环依赖、Controller 上忘了加 Guard、Controller 里直接调 ORM、注册了但没人用的 provider。ESLint 的 Nest 插件基本不查这些，Nest Devtools 得把应用跑起来才能看。
所以我做了 nestjs-doctor，一个开源（MIT）的 NestJS 静态分析工具，直接读源码：
npx nestjs-doctor@latest .
不启动应用，不调 LLM，代码不上传。扫完给一个 0 到 100 的分，每条问题带文件和行号，同一个 commit 在本地和 CI 得分一致。
加 --report 会生成一个 HTML 报告：
- 模块依赖图，循环依赖会高亮
- 每个 HTTP 接口的调用链，从 Controller 到 Service 再到 Repository，一眼看到哪个接口直接碰了数据库
- Prisma / TypeORM / Drizzle / MikroORM 的 ER 图，从实体代码里读出来
- 在
main.ts加几行、真实启动一次，再加--timings <path>，多一页启动耗时，能看到哪个 provider 拖慢了启动
内置规则分五类：安全、正确性、架构、性能、数据库 schema。团队自己的约定可以写成自定义规则，一个 ts-morph 文件放进 customRulesDir 就能加载，比如"Controller 里不许直接用 Repository"。
也能跑在 pre-commit、GitHub Action（只评论 PR 新引入的问题）和 VS Code 里，支持 monorepo。国内走 npmmirror 也行，版本是同步的。
公开项目今天的分：twentyhq/twenty 99，immich 97，nocodb 95。
仓库：https://github.com/RoloBits/nestjs-doctor
文档（英文）：https://www.nestjs.doctor/docs?from=cnode
我是作者，欢迎提 issue，尤其想知道国内团队常见的 Nest 项目结构里有没有规则没覆盖到的。