PhpStorm TypeScript 功能需三要素联动：启用插件、项目根目录存在 tsconfig.json、TypeScript 版本设为“Project default”并指向 node_modules 内 tsserver.js；否则仅高亮无类型检查。
PhpStorm 默认不自动启用 TypeScript 类型检查和编译功能——即使你装了 tsc、写了 tsconfig.json，IDE 也可能只当它是带高亮的普通文本。关键在三个联动点：插件状态、tsconfig.json 存在性、以及 TypeScript 服务路径是否指向项目级安装版本。
TypeScript 插件已启用但无类型提示
常见现象是 .ts 文件有语法高亮，但 Ctrl+Click 跳转失败、变量无类型推导、any 泛滥且不报错。根本原因不是插件没开，而是 PhpStorm 没识别出这是个 TypeScript 项目。
- 确认项目根目录存在
tsconfig.json（哪怕只有{"compilerOptions": {"allowJs": true}}）；空文件或放在src/下都不行 - 检查设置 →
Languages & Frameworks → TypeScript→ “TypeScript version” 是否设为 “Project default”；若手动指定，路径必须是./node_modules/typescript/lib/tsserver.js，不是tsc可执行文件 - 删掉项目下的
.idea和node_modules/.idea，重启 PhpStorm —— 缓存错位会导致类型路径解析静默失败
tsconfig.json 生效但“Compile on save”不触发输出
勾选了 “Compile on save”，保存后却没生成 .js 文件，或报错 “Cannot write to output directory”。这不是配置写错了，而是 PhpStorm 对编译行为做了限制。
- 确保
tsconfig.json中outDir是相对路径（如"outDir": "./dist"），不能是"../dist"或绝对路径；PhpStorm 明确禁止向上跨目录写入 -
include字段必须覆盖你的源文件，比如文件在根目录就别只写"include": ["src/**/*"]；可用"include": ["**/*.ts"]快速验证 - “Compile on save” 不等价于
tsc --watch，它只编译当前编辑的文件及其直接依赖；全量构建仍需终端运行npx tsc
路径别名（@/、~/）标红但 tsc 编译正常
代码能跑、终端 tsc 成功，但 PhpStorm 里 import { foo } from '@/utils' 一直标红，跳转也失效。这是因为 TypeScript 编译器和 PhpStorm 的模块解析逻辑不共享配置。
完整的Galileo AI平台 TypeScript/JS SDK 参考，用于评估、观察和保护 GenAI 应用。适用于构建 Node.js 或 TypeScript 项目。
立即学习“PHP免费学习笔记（深入）”；
-
tsconfig.json中必须同时定义baseUrl和paths，且baseUrl不能为空字符串；推荐写成"baseUrl": "./" - PhpStorm 不读
jsconfig.json，纯 TS 项目也得配tsconfig.json；哪怕只是空配置，也要存在 - 检查设置 →
Languages & Frameworks → JavaScript → Libraries→ 确保node_modules被标记为 “JavaScript library”，否则模块解析链从第一步就断了
“Cannot find name 'React'” 类型缺失错误
这类错误不是 React 没装，而是 PhpStorm 没加载 @types/react。它不会像 tsc 那样自动扫描 node_modules/@types，尤其当项目没 package.json 或 tsconfig.json 显式声明时。
- 在
tsconfig.json的compilerOptions中加"types": ["react", "react-dom"]（按需列）；这样 PhpStorm 会严格按此列表加载，不依赖隐式发现 - 如果用了
declare global扩展全局类型，确保对应文件（如types/global.d.ts）被include字段覆盖 - 手动添加类型库：设置 →
Languages & Frameworks → TypeScript → Library types→ 点+→ 选中node_modules/@types/react目录
最易被忽略的是：PhpStorm 的 TypeScript 支持高度依赖 tsconfig.json 的存在与位置，而不是内容复杂度。一个最小化但位置正确的 tsconfig.json，比一个写满配置却放在子目录里的文件更有效。
