如何在Vanilla JS项目中实现伪构建以检测JSDoc类型错误？

我刚好碰到过几乎一模一样的场景，既然你已经靠VSCode的checkJS和JSDoc搭好了可靠的类型体系，那直接用TypeScript的tsc命令就是最贴合你需求的方案——它完全复用你现有的JSDoc和jsconfig配置，能精准扫描整个项目的类型错误，不会强加任何不必要的代码规范。

具体操作步骤： #

1. 完善你的jsconfig.json配置
   如果你已经有这个文件，只需要补充noEmit: true（避免生成TS文件，只做检查）和明确的文件扫描范围，示例配置：

   {
     "compilerOptions": {
       "checkJs": true,
       "noEmit": true,
       "strict": true, // 可选，开启严格类型检查，可根据项目需求调整
       "target": "ESNext" // 匹配你的项目JS语法版本
     },
     "include": ["src/**/*.js"], // 指定要扫描的所有JS文件路径
     "exclude": ["node_modules"]
   }
   

2. 安装TypeScript作为开发依赖
   不用在项目里写TS代码，只是借用它的类型检查能力：

   npm install typescript --save-dev
   # 或者用yarn/pnpm
   yarn add typescript --dev
   

3. 运行全量类型检查
   在项目根目录执行命令：

   npx tsc
   

   这时候tsc会读取你的jsconfig.json，扫描所有匹配的JS文件，输出和VSCode编辑器里完全一致的类型错误——包括你提到的「修改类型属性名后lint工具没检测到」这类问题，都会被精准拦截。

额外优化技巧： #

• 想要更友好的错误输出格式：加上--pretty参数，执行npx tsc --pretty
• 需要实时监控文件变化做检查：执行npx tsc --noEmit --watch
• 集成到CI流程：直接把tsc命令加到你的CI脚本中，一旦出现类型错误就终止构建

为什么这个方案比ESLint/JSLint更合适？ #

ESLint的类型检查依赖@typescript-eslint插件，需要额外配置才能对齐VSCode的checkJS检查逻辑，而且默认规则可能无法覆盖所有JSDoc相关的类型问题；而tsc和VSCode用的是同一套TypeScript引擎，检测结果完全一致，且所有检查规则都可以通过jsconfig.json的compilerOptions灵活配置，不会出现无法屏蔽的无关警告。

内容的提问来源于stack exchange，提问作者Kyoshiro Kokujou Obscuritas