JavaScript静态检查需组合使用工具：ESLint负责语法与规范检查，TypeScript提供类型保障，JSDoc支持渐进式类型检查，jscodeshift用于重构分析，SonarJS增强质量维度；新项目推荐TS+ESLint，存量项目可逐步迁移。
JavaScript 本身是动态类型语言，运行时才确定变量类型和结构，因此容易出现拼写错误、未定义变量、类型不匹配等问题。要提前发现这些问题，需要借助静态代码分析工具——它们不运行代码，而是通过解析源码的语法树（AST）来检查潜在问题。
ESLint：最主流的 JavaScript 静态检查工具
ESLint 是目前使用最广泛的可配置静态检查工具，支持自定义规则、插件扩展和多种格式（如 TypeScript、Vue、React）。它能检测语法错误、风格问题（如缩进、分号）、潜在 bug（如变量未使用、条件恒真）等。
- 安装：用 npm install eslint --save-dev 安装，再通过 npx eslint --init 生成配置文件（如 .eslintrc.js）
- 常用配置项包括 env（指定运行环境）、extends（继承共享规则集，如 eslint:recommended 或 plugin:react/recommended）、rules（开启/关闭具体规则）
- 可与编辑器（VS Code）集成，实时高亮提示；也可在 CI 流程中运行，防止问题代码合入主干
TypeScript：静态类型检查的深度方案
TypeScript 不是传统意义上的“检查工具”，而是 JavaScript 的超集，通过添加类型注解，在编译阶段进行严格的静态类型检查。它能捕获 JS 中难以发现的类型错误，比如调用不存在的方法、传参类型不符、属性访问越界等。
React 组件生成器
下载
根据项目规范生成 React 和 Vue 组件，包括 TypeScript 类型定义、Ant Design 5 集成、Tailwind CSS 样式及 Vitest 测试文件。当用户提出创建、生成或搭建前端组件的需求时启用，例如：“帮我写一个表格组件”、“生成一个弹窗”、“create a form component”、“写一个列表页”、“生成一个下拉选择器”。该能力在以下任一场景触发：涉及 React/TSX/Vue 组件生成、UI 组件创建，或为组件生成测试文件。
- 需将 .js 文件重命名为 .ts，并安装 typescript 包；配置 tsconfig.json 控制检查严格度（如 strict: true 启用全量检查）
- 即使不编译为 JS，也能用 tsc --noEmit 单独做类型检查，适合纯检查场景
- 对大型项目、团队协作、长期维护尤其有价值，但需一定学习成本和代码改造
其他实用静态分析工具
除 ESLint 和 TypeScript 外，还有几类补充性工具，覆盖不同维度：
立即学习“Java免费学习笔记（深入）”；
- JSDoc + Type Checking：在 JS 文件中用 JSDoc 注释声明类型（如 /** @type {string[]} */），配合 TypeScript 的 checkJs 和 allowJs 选项，实现渐进式类型检查
- jscodeshift：基于 AST 的 codemod 工具，常用于大规模代码重构（如自动升级 API 调用），也具备分析能力
- SonarJS：企业级代码质量平台插件，集成在 SonarQube 中，提供复杂度、重复率、安全漏洞等更广维度的静态分析
如何选择和搭配使用
多数现代项目采用组合策略：ESLint 做基础语法与规范检查，TypeScript 做核心类型保障，再按需引入 JSDoc 或 CI 插件增强可靠性。
- 新项目建议直接用 TypeScript + ESLint（推荐 @typescript-eslint 插件）
- 存量 JS 项目可先接入 ESLint，逐步添加 JSDoc 类型注解，再过渡到 TS
- 避免规则冲突：例如 ESLint 的 no-unused-vars 和 TypeScript 的 noUnusedLocals 功能重叠，应关闭其一
