WebStorm 对 Qwik 的支持需手动配置三步：标记 node_modules/qwik 为资源根以加载类型定义；附加 qwik/jsx-runtime 库以正确解析 JSX；添加自定义 File Watcher 监听 .qwik 和 .qrl 等文件实现热更新。
Qwik 本身不依赖特定 IDE，但 WebStorm 对它的支持需要手动补足几处关键配置，否则会出现类型提示缺失、组件跳转失效、热更新异常等问题。直接开箱即用会卡在「找不到 qwik 类型定义」或「useSignal 无法识别」这类报错上。
WebStorm 识别 Qwik 类型定义失败
根本原因是 Qwik 使用了自定义的 TypeScript 类型注入机制（通过 types 字段 + qwik.d.ts 声明文件），而 WebStorm 默认只扫描 node_modules/@types 和项目根目录下的 types 文件夹，不会主动加载 node_modules/qwik/types。
- 打开
File → Settings → Languages & Frameworks → TypeScript - 在
Compiler options → Type acquisition下，取消勾选Download type definitions automatically（避免干扰） - 手动添加类型路径：点击
Node.js and NPM → Package manager → node_modules/qwik，右键 →Mark as → Resource root - 重启 WebStorm，再检查
node_modules/qwik/types/index.d.ts是否被索引（可在Go to → Symbol中搜useSignal验证）
Qwik 组件点击跳转不到源码
Qwik 的 JSX/TSX 文件中使用的是 qwik/jsx-runtime，而非 React 的 react/jsx-runtime，WebStorm 默认按 React 规则解析 JSX，导致 onClick 等属性无法关联到组件定义。
- 进入
Settings → Languages & Frameworks → JavaScript → Libraries - 点击
+→Attach Directory，选择node_modules/qwik/jsx-runtime - 确保
Preferences → Editor → General → Code Completion中启用了Show the auto-completion popup - 如果仍无效，检查项目 tsconfig.json 是否包含：
"jsx": "preserve"和"jsxImportSource": "qwik"
Qwik 开发服务器热更新不触发 WebStorm 自动保存
Qwik 默认使用 vite 启动开发服务器，而 WebStorm 的 File Watchers 不会自动监听 .qwik 或 .tsx 文件变更并触发保存 —— 这会导致修改后页面不刷新，误以为 HMR 失效。
- 打开
Settings → Tools → File Watchers - 点击
+→Custom，名称填qwik-save-on-change - Program:
echo（仅用于触发保存，无需真正执行命令） - Arguments:
saved - Working directory:
$ProjectFileDir$ - Scope:
Project Files - File types:
ts, tsx, jsx, qrl, qwik（注意加上qrl和qwik扩展名） - 勾选
Auto-save edited files to trigger watcher
Qwik 的支持不是“开箱即用”，而是靠显式声明类型路径、修正 JSX 解析器、补全文件监听范围这三步闭环。漏掉任意一环，都会让开发体验退回到纯文本编辑器级别——尤其是 qrl 文件的跳转和 useStore 的类型推导，必须靠 node_modules/qwik/types 被正确标记为资源根才能生效。 
