phpstorm typescript 开发无需额外插件，仅需正确配置 tsconfig.json 路径别名、file watcher 和增量编译参数，并确保本地 typescript 版本兼容项目配置。
PhpStorm 自带的 Javascript and TypeScript 插件已覆盖绝大多数 TypeScript 开发需求，**额外安装插件通常不必要，甚至可能引入冲突或性能拖累**。真正需要补充的，只有两类场景：路径别名解析失效、或项目结构复杂导致 IDE 无法自动识别 tsconfig.json 语义。
tsconfig.json 路径别名（baseUrl/paths）不生效
即使 tsconfig.json 里写了 "baseUrl": "." 和 "paths": { "@/*": ["src/*"] }，import { foo } from "@/utils" 仍标红——这不是插件问题，是 PhpStorm 没把路径映射加载进符号索引。
- 先确认
tsconfig.json文件本身没报错（右下角应显示 TS 图标），且文件位于项目根目录 - Settings → Languages & Frameworks → TypeScript → “TypeScript version” 必须设为
Project default（即读取node_modules/typescript），不能选Bundled - 关键一步：Settings → Languages & Frameworks → JavaScript → Libraries → Add →
node_modules→ 勾选Include subdirectories，让 IDE 显式扫描类型定义 - 如果用了
pnpm或bun，确保node_modules已生成；PhpStorm 不会自动触发包安装
File Watcher 编译失败或无限循环
保存 .ts 文件后无 .js 输出，或控制台反复报 Cannot write file because it would overwrite input file，说明 File Watcher 和 tsconfig.json 的路径配置打架了。
-
tsconfig.json中必须显式声明"outDir": "./dist"和"rootDir": "./src"（不能省略） - Settings → Tools → File Watchers → TypeScript → Arguments 字段填：
--project $ProjectFileDir$/tsconfig.json --noEmit false（不要加--outDir，它由 tsconfig 控制） - Output paths to refresh 必须严格匹配输出路径，例如：
$ProjectFileDir$/dist/$FileNameWithoutExtension$.js,$ProjectFileDir$/dist/$FileNameWithoutExtension$.js.map - Working directory 必须是
$ProjectFileDir$（即项目根目录），否则tsc找不到tsconfig.json
增量编译（incremental）不提速
改一个文件却全量编译整个项目，CPU 占用飙升，是因为 TypeScript 的增量机制被绕过了。
- 仅在
tsconfig.json加"incremental": true无效；必须同时加"composite": true -
"composite": true会生成.tsbuildinfo，该文件需保留在项目中（但可加到.gitignore） - File Watcher 的 Program 字段必须指向真实
tsc可执行文件（如node_modules/.bin/tsc），不能只写tsc——后者依赖 shell PATH，而 PhpStorm 启动时可能未加载你的 shell 配置 - macOS/Linux 用户若用
zsh或fish，需在 Settings → Appearance & Behavior → System Settings → Shell path 中填对路径（如/bin/zsh）
最容易被忽略的是：PhpStorm 对 TypeScript 的支持深度，取决于你本地 tsc 的版本与项目 tsconfig.json 的兼容性。比如用了 moduleResolution: "bundler" 却装了旧版 TypeScript，IDE 就会静默放弃路径解析——此时装任何插件都救不了，得先升级 typescript 包。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
