搭建TypeScript环境时类型错误代码未提示报错如何排查

按以下顺序逐一排查即可解决该类TS校验失效问题：

• 先确认校验命令的执行方式正确
  终端执行校验时需要注意两个核心规则：
  1. 直接执行tsc index.ts时，tsc会完全忽略项目根目录的tsconfig.json，使用默认编译规则处理单文件，且默认规则下不会因为类型错误终止编译，只会在终端打印报错信息。很多人看到执行后生成了.js文件就误以为没有报错，往上翻终端输出就能看到红色的类型错误提示。
  2. 想要让tsconfig.json的配置生效，必须在项目根目录直接执行不带任何文件名参数的tsc命令，才会读取配置扫描所有纳入范围的TS文件做校验。入门阶段建议在compilerOptions里加上"noEmitOnError": true，出现类型错误时就不会生成.js文件，判断更直观。
• 检查tsconfig.json的核心配置
  打开根目录的tsconfig.json，逐一确认以下配置：
  1. compilerOptions.strict必须设为true，入门阶段开严格模式能避免绝大多数校验失效问题，不要手动把这个值改成false。
  2. 检查include字段的路径规则是否覆盖了你的index.ts文件，如果手动配置了include但没写对路径（比如只写了["src/**/*.ts"]但index.ts放在根目录），tsc根本不会扫描到这个文件，自然不会报出错误。基础可用配置参考：

  {
    "compilerOptions": {
      "target": "ES2020",
      "module": "ESNext",
      "strict": true,
      "noEmitOnError": true
    },
    "include": ["**/*.ts"]
  }
  

  3. 检查index.ts文件顶部有没有写// @ts-nocheck注释，这个注释会直接跳过整个文件的类型校验。
• 检查编辑器的TS服务状态
  如果终端执行tsc能正常抛错，但编辑器里没有对应的飘红提示，属于编辑器TS服务加载异常：
  1. VS Code用户可以按Ctrl+Shift+P（Windows）/Cmd+Shift+P（Mac）调出命令面板，搜索执行「TypeScript: Restart TS Server」重启服务即可恢复提示。
  2. 点击编辑器右下角显示的TypeScript版本号，选择「使用工作区的TypeScript版本」，避免编辑器内置的旧版本TS和本地安装版本不匹配导致校验失效。
• 排查代码里的类型绕过逻辑
  检查文件内有没有给age变量加as any类型断言，或者存在declare let age: any这类全局类型声明，这类写法会直接绕过静态类型检查，不会触发赋值类型错误。

内容的提问来源于stack exchange，提问作者Brie