typescript 编译器需本地安装并手动配置路径，tsconfig.json 必须存在且配置合理，vue 文件需启用 vue 插件并声明 lang="ts"，避免依赖 file watcher 而应使用 tsc --watch 或构建工具。
确认 TypeScript 编译器已安装并被 WebStorm 识别
WebStorm 不自带 TypeScript 编译器，必须依赖项目本地的 typescript 包（推荐）或全局安装版本。若没装，tsc 命令在终端能运行，但 WebStorm 仍可能报“Cannot find TypeScript compiler”——因为它默认不读全局路径。
- 执行
npm install typescript --save-dev（推荐），确保node_modules/typescript存在 - 打开
Settings/Preferences → Languages & Frameworks → TypeScript - 在
TypeScript version下拉菜单中，**手动选择Project preferences下的node_modules/typescript/lib/tsc.js**（不是“Bundled”或“Global”） - 若下拉列表为空，点击右侧刷新按钮；若仍无，检查
node_modules/typescript是否真的存在、权限是否正常
tsconfig.json 必须存在且配置合理
没有 tsconfig.json，WebStorm 的类型检查、自动导入、跳转定义等功能会大面积失效，甚至把 .vue 里的 <script lang="ts"></script> 当作普通 JS 处理。
- 在项目根目录运行
tsc --init生成基础配置 - 重点核对以下几项（尤其 Vue 3 项目）：
"target": "esnext"、"module": "esnext"、"jsx": "preserve"、"moduleResolution": "node"、"strict": true、"include": ["src/**/*"] -
"types"字段建议显式添加["node", "webpack-env"]（如用 Webpack）或["vite/client"]（如用 Vite），否则import.meta.env等会标红 - 删掉
exclude中误加的"src"——它会导致整个源码目录不参与类型检查
Vue 单文件中的 TypeScript 支持要靠插件 + lang 属性激活
即使 TypeScript 配置全对，.vue 文件里写 <script></script> 依然没类型提示？大概率是 Vue 插件没启，或没声明语言。
- 进
Settings → Plugins，搜索并启用Vue.js插件（2023.1+ 版本原生支持，但需手动开） -
<script></script>标签必须带lang="ts"，写成<script lang="ts"></script>，否则 WebStorm 默认按 JS 解析模板内脚本 - 若用组合式 API，确保
defineComponent或defineAsyncComponent被正确识别——这依赖@vue/runtime-core和@vue/reactivity的类型定义，可通过Alt+Enter在package.json里快速安装@types/node和@vue/runtime-core
别依赖 File Watcher 自动编译，用 tsc --watch 或构建工具更稳
网上常见教程教你在 File Watchers 里配 tsc，但实际容易出问题：编译失败不报错、增量编译漏文件、与 Vite/Webpack 冲突导致重复构建。
- WebStorm 的
File Watcher本质是调命令行，**不感知tsconfig.json的references或composite设置**，多包项目极易失效 - 开发阶段优先用
tsc --watch（在终端跑）或直接起npm run dev（Vite/Vue CLI）——它们才真正理解项目结构 - 如果坚持用 File Watcher，请勾选
Trigger after save，并在Arguments里明确传--project tsconfig.json，避免它乱读父目录配置
tsconfig.json 的有效性、以及你有没有在该用 lang="ts" 的地方真写了它——少一个，提示就断一截。
