webstorm默认不支持js/ts混编，因其按扩展名静态绑定语言服务，.js和.ts互不互通；需启用tsconfig.json的allowjs与checkjs、显式include js路径、添加jsdoc类型标注，并将javascript版本设为es.next。
WebStorm 能跑 JS 和 TS 混编项目，但默认不认——必须手动关掉“自动推断语言”的惯性逻辑，否则 import 从 .ts 文件跳转进 .js 就会断，require 的类型提示也基本失效。
为什么 WebStorm 默认不支持 JS/TS 混编
WebStorm 对文件类型的识别是“静态绑定”：它根据扩展名决定用哪套语言服务，.js 走 JavaScript 服务，.ts 走 TypeScript 服务，两者之间默认不互通。比如你在 index.js 里写 import { foo } from './utils.ts'，IDE 不会去解析 utils.ts 的导出类型，也不会把 foo 的类型带进 index.js 的作用域。
- JS 文件里无法获得来自 TS 文件的类型推导（即使
utils.ts有完整接口定义） - TS 文件里
importJS 文件时，若没配@types或declare module，会报Cannot find module 'xxx' - File Watcher 编译时，
.js文件不会被tsc处理，但若tsconfig.json的include误含**/*.js，反而触发error TS6133: 'xxx' is declared but its value is never read
tsconfig.json 必须启用 allowJs 和 checkJs
这是混编项目的前提开关。只设 allowJs: true 不够，checkJs: true 才能让 WebStorm 在 JS 文件里读取 JSDoc 类型并参与类型检查。
-
allowJs：允许tsc读取.js文件（否则直接跳过） -
checkJs：让tsc对.js文件做类型校验（WebStorm 的类型提示、悬停、跳转依赖这个） - 务必搭配
maxNodeModuleJsDepth（如设为2），否则node_modules里的 JS 库类型不会被扫描 -
include字段要显式包含 JS 路径，例如："include": ["src/**/*", "tests/**/*"]，不能只写["src/**/*.ts"]
示例片段：
{
"compilerOptions": {
"allowJs": true,
"checkJs": true,
"maxNodeModuleJsDepth": 2,
"moduleResolution": "node",
"skipLibCheck": true,
"strict": false
},
"include": ["src/**/*"]
}
JS 文件必须加 JSDoc 类型标注才有效
WebStorm 不会凭空猜 JS 函数返回值，checkJs 只校验已有类型声明。没 JSDoc 的 JS 文件，在 TS 里 import 后仍是 any。
- 导出函数必须标注
@returns和参数@param，例如：
/**
* @param {string} name
* @returns {number}
*/
export function getNameLength(name) {
return name.length;
}
- 导出对象用
@type声明结构，例如：/** @type {{ id: number; name: string }} */ const user = { id: 1, name: 'a' }; - 第三方 JS 库缺失类型时，优先在
src/typings/下建xxx.d.ts，而不是靠@ts-ignore压制错误（后者 WebStorm 不认）
WebStorm 设置里禁用“JavaScript language version”硬限制
Settings → Languages & Frameworks → JavaScript 里，默认选了某个 ECMAScript 版本（如 ES2022）。这会导致 JS 文件按该版本语法解析，但和 TS 的 target 冲突，尤其在使用装饰器、export * as ns 等新特性时，JS 文件会报红而 TS 不报。
- 把 JavaScript language version 改成
ECMAScript version: <code>ES.Next（不是下拉列表里的具体年份） - 确保 TypeScript 设置（Languages & Frameworks → TypeScript）中指定的是本地
node_modules/typescript/lib/tsc.js，不是 Bundled - 如果项目用 Vite 或 Webpack，别依赖 WebStorm 的 File Watcher 编译 JS/TS 混合输出——它只管单文件，不处理模块图。应以构建工具为准，WebStorm 仅作编辑辅助
真正容易被忽略的是：混编项目里，tsconfig.json 的 exclude 别写 ["node_modules", "dist", "build"] 就完事。如果 src 下有 .d.ts 声明文件，又同时存在同名 .js，tsc 会优先加载 .d.ts 而忽略 .js 的实现——这时你改了 JS 代码，类型却还是旧的，调试时非常难定位。
