nodejs 后端，怎么比较好的生成接口文档？(排除 nest.js)

有没有正经开发 nodejs 后端的老哥帮忙看看

不用 swagger 吗？

后端就跟前端对接而已啊, 前端能看不懂你的代码?
你把关键方法的注释按 jsdoc 写好就行了, 直接把项目 pull 权限开给前端组.

经历过的正经的大项目基本最后都上了 Nest.js

小项目的话，最近在做 CF Worker 相关，CF 强推 https://github.com/cloudflare/chanfana ，可以根据 Zod 生成 OpenAPI 文档

推荐 orpc( https://orpc.unnoq.com/ ) ：你只管写代码，orpc 会直接根据 zod 、valibot 类型生成 OpenAPI 文档。
更推荐 GQLoom ( https://gqloom.dev/ ) : 你只管写代码，GQLoom 会直接根据 zod 类型、valibot 类型、drizzle 表定义 、Prisma 模型定义生成 GraphQL 文档。

让 AI 给你生成 swagger

我自己写了一套..

完全不用 Nest.js
没有 Zod 依赖..

恕我直言现在 Node.js 生态里面，我不是针对谁，全部都是🗑️

cursor 打开项目，ctrl+i, 帮我生成接口文档

参考 elysiajs ，配合 drizzle 的话，可以达到全链路强类型。

https://elysiajs.com

让 AI review 代码，顺便生成 markdown 格式的接口文档

我很好奇，有公司使用 nodejs 开发后端？

让 ai 写 openapi 文档

感觉 immich 做的就挺好

直接用 swagger / openapi spec 啊

前后端都是 js/ts 了，你们应该单独开一个项目把所有接口约定在 interface 里。

如果用 fastify ，可以用 json schema ，接口文档，基本的入参校验都有了。json schema 用 typebox + ai 写，还算方便。

公司只能接受 java ，接的私活用 node

遵循 openapi 规范，直接通过接口拿到全局视图

hono openapi

都用 node 了，其实可以不生成文档，直接生成 npm lib 给前端用