TypeScript注释文档规范
TSDoc 是一个面向 TypeScript 代码文档注释的标准化提案，目标是让不同工具在解析同一份源码注释时不会因各自的 JSDoc 扩展语法而产生冲突。它不是一个完整的文档托管平台，而是规范、标签体系和解析器生态的组合。官方提供 @microsoft/tsdoc 作为开源参考解析器，并提供 TSDoc Playground 用于交互式体验解析效果。
从功能与用途看，TSDoc 主要解决 TypeScript API 文档、构建流程和编辑器工具中的注释解析一致性问题。正文举例覆盖 TypeDoc、DocFX、API Extractor、ESLint、Visual Studio Code 以及开发者自定义脚本，这些工具都可能读取注释中的 @param、@returns、@link、@internal 等内容。TSDoc 的设计强调三点：可扩展性、互操作性和熟悉语法。工具可以定义自有标签，但这些标签需要遵循可被其他工具安全识别和丢弃的模式，从而减少误解析。
TSDoc 明确提供开源参考实现 @microsoft/tsdoc，适合工具作者直接集成解析器以保证兼容性。相关 npm 包还包括 @microsoft/tsdoc-config 与 eslint-plugin-tsdoc。文档结构较完整，包含规范、标签参考、贡献指南、路线图和使用说明，且正文对为什么不能直接以 JSDoc 作为标准给出了清晰解释：JSDoc 语法并非严格规范化，且大量标签服务于普通 JavaScript 类型标注，而 TypeScript 已有强类型系统。
正文未提及任何商业定价、企业版或付费支持；结合其开源 npm 包定位，使用门槛较低。优点是问题定位精准，尤其适合专业 SDK、组件库和大型 TypeScript 工具链，能降低文档生成和 API 审查中的不确定性。局限也很明显：它本身不是开箱即用的文档站产品，价值依赖 TypeDoc、API Extractor、ESLint 等工具链的采用；同时主要聚焦 TypeScript，其他语言场景信息不足。
TSDoc 适合 TypeScript 库维护者、文档生成器作者、企业级 SDK 团队，以及需要用注释驱动构建、Lint 或 API 审查流程的团队。中国访问情况正文未提供，域名和 npm/GitHub 相关资源的可用性可能受网络环境影响，建议实际验证；若访问不稳定，可参考 JSDoc、TypeDoc 或 DocFX 的本地文档与镜像生态作为补充。
本测评基于公开资料整理,不构成购买建议,请以 tsdoc.org 官网实际信息为准。
微软生态开源规范，TS开发者有价值。
评分明细(分布与用户短评)接入中。当前展示 TG4G 综合评分,数据源自公开测评与用户反馈。