PhpStorm 中启用 TypeScript 类型检查需开启 TypeScript Language Service：进入 Settings → Languages & Frameworks → TypeScript，勾选 Enable TypeScript language service，并确保 Node.js 解释器路径正确、本地安装了 typescript 包；修改 tsconfig.json 后需手动点击 Reload project 或执行 Synchronize 刷新配置。
如何在 PhpStorm 中启用 TypeScript 类型检查
PhpStorm 默认不会主动执行 TypeScript 的类型检查，它只做语法高亮和基础补全；真要看到 TSC 报错（比如 Argument of type 'string' is not assignable to parameter of type 'number'），必须让 IDE 调用本地安装的 tsc 进行实时检查。
关键操作是开启「TypeScript Language Service」：
- 打开 Settings / Preferences → Languages & Frameworks → TypeScript
- 勾选
Enable TypeScript language service - 确认
Node interpreter指向正确的 Node.js 路径（通常是项目内node_modules/.bin/tsc所在的 Node） - 如果项目有
tsconfig.json，PhpStorm 会自动读取其中的compilerOptions（如"strict": true），但"noEmit": true不影响类型检查
注意：若未安装 typescript 包（全局或本地），PhpStorm 会提示 “Cannot find TypeScript compiler”，此时需先运行 npm install --save-dev typescript。
为什么修改了 tsconfig.json 后 PhpStorm 仍不生效
常见现象是改了 "target" 或 "lib"，但代码里用了 Array.prototype.at() 却没报错——这通常不是缓存问题，而是 PhpStorm 没有重新加载配置。
立即学习“PHP免费学习笔记（深入）”；
触发重载的可靠方式：
完整的Galileo AI平台 TypeScript/JS SDK 参考，用于评估、观察和保护 GenAI 应用。适用于构建 Node.js 或 TypeScript 项目。
- 保存
tsconfig.json后，手动点击右上角Reload project图标（小圆圈带箭头） - 或执行
File → Synchronize，强制刷新文件系统状态 - 检查
tsconfig.json是否在项目根目录；若在子目录（如src/tsconfig.json），PhpStorm 默认不识别，需在设置中手动指定路径 - 确保没有多个
tsconfig.json冲突（例如根目录和src/下各有一个），PhpStorm 只认最外层那个
一个容易被忽略的点："include" 和 "exclude" 仅控制编译范围，不影响类型检查范围——只要文件被 IDE 索引到（即出现在项目视图中），就会参与类型校验。
配置编译输出：tsc 编译不生成 .js 文件？
PhpStorm 自带的 tsc 编译器（通过 Ctrl+F9 或 Build → Build Project 触发）默认只做类型检查，不输出 JS，除非明确启用编译。
正确做法是配置 Compiler options：
- 进入 Settings → Languages & Frameworks → TypeScript
- 取消勾选
Use TypeScript version下方的Compile on save（这个选项实际无效，且易误导） - 改用
Build → Compile TypeScript菜单项，它会读取tsconfig.json中的"outDir"、"declaration"等配置 - 若需每次保存自动编译，应使用
File Watchers插件 + 自定义tsc --watch，而非依赖内置构建
验证是否成功：检查 tsconfig.json 是否含 "outDir": "./dist"，且 ./dist 目录为空时执行编译，它应被创建并填充 JS 文件。若无反应，大概率是 tsc 版本太低（
遇到 "Cannot find name 'console'" 等全局类型错误怎么办
这类报错本质是 TypeScript 不知道当前环境有哪些全局变量，和浏览器或 Node.js 的运行时无关，纯属类型声明缺失。
解决路径很直接：
- 确认
tsconfig.json中"lib"包含对应环境，例如前端项目加["es2020", "dom"]，Node 项目加["es2020", "node"] - 若用了
"types": []显式清空了默认类型，需手动补回，如"types": ["node", "jest"] - 检查是否有
node_modules/@types/node或@types/jest等包缺失，缺失则运行npm install --save-dev @types/node - PhpStorm 有时不会立刻识别新装的
@types包，可尝试File → Invalidate Caches and Restart → Just Restart
真正麻烦的是混用环境（比如 Electron 主进程+渲染进程），这时需要拆成多个 tsconfig.json 并用 references 关联，PhpStorm 对该特性支持尚不稳定，建议优先用命令行 tsc -b 构建。
