使用Vite搭建React+TypeScript时tsconfig.json报错求助

排查与修复步骤 #

• 同步项目本地依赖版本
  执行 npm ls typescript（用yarn则是yarn list typescript），查看项目实际安装的TypeScript版本，和同事的输出对比。如果不一致，删除node_modules、package-lock.json（或yarn.lock），重新执行npm install（或yarn install）拉取一致的依赖。

• 指定编辑器使用项目本地TS版本
  以VS Code为例，打开命令面板（Ctrl+Shift+P），输入TypeScript: Select TypeScript Version，选择Use Workspace Version，避免编辑器自动选用全局或其他不兼容的TS版本。

• 修正TS版本与配置的兼容性
  moduleResolution: "bundler"、allowImportingTsExtensions是TypeScript 5.x新增的特性，降级到4.8必然会报错——该版本根本不识别这些配置项。请将TS版本恢复到与同事一致的5.x版本，不要盲目降级。

• 核对Vite版本兼容性
  老版本Vite可能不支持TS 5.x的bundler模块解析模式。执行npm ls vite查看本地Vite版本，和同事保持一致，若版本过低则升级到对应兼容版本。

• 清除缓存并重启服务
  执行npx vite --clear-cache清除Vite缓存，重启开发服务；同时重启编辑器，避免残留的配置缓存干扰。

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