WebStorm本身不内置SolidJS脚手架支持,但能完整运行SolidJS项目,关键在于使用create-solid-app创建项目、禁用Volar、启用TypeScript/JSX支持、修改package.json的dev脚本为"vite dev --host"并确保solid-refresh插件正确加载。

WebStorm 本身不内置 SolidJS 脚手架支持,但能完整运行 SolidJS 项目——关键在于用对命令、配对语言服务、避开 Volar 干扰。
创建 SolidJS 项目必须用 create-solid-app
SolidJS 官方只维护 create-solid-app 这一个脚手架,不兼容 Vue CLI 或 Vite 的默认模板(除非手动选 Solid 模板)。直接运行:
npx create-solid-app@latest my-solid-app- 选
typescript+pnpm(或 npm,但 WebStorm 对 pnpm 的依赖图解析更准) - 进目录后不要立即用 WebStorm 打开根目录,先
pnpm install成功再打开
如果跳过安装直接打开,WebStorm 会报 Cannot resolve module 'solid-js',不是配置问题,是 node_modules 根本没生成。
WebStorm 必须禁用 Volar,启用 TypeScript 和 JSX 支持
Volar 是 Vue 专属语言服务器,SolidJS 用的是 TypeScript + JSX + 自定义编译器(solid-refresh),Volar 会劫持 .tsx 文件的语法校验,导致:
使用 Vite 8、React 19、Tailwind CSS v4、shadcn/ui、Biome、Vitest 和 Hono 构建全栈 TypeScript 应用,涵盖前端(Vite/Rolldown 构建 + 开发)...
-
createStore报红,提示 “cannot find name” - 组件 props 类型推导失效
- Live Templates 不触发 Solid 片段
解决方法:Settings → Languages & Frameworks → TypeScript → Vue.js → 取消勾选 “Enable Vue.js support”。再确认 JavaScript version 设为 JSX,并勾选 Allow auto-import for TypeScript。
运行命令要改 package.json 的 scripts 字段
默认 create-solid-app 生成的是 "dev": "vite",但 WebStorm 的 “Run Configuration” 识别不到 vite 的入口逻辑,直接点 ▶️ 会失败。必须手动改:
- 把
"dev": "vite"改成"dev": "vite dev --host"(加--host才能被 WebStorm 的内置终端正确绑定) - 或者新建 Run Configuration:选择
npm类型 → Command:run→ Scripts:dev→ Working directory 指向项目根 - 启动后访问
http://localhost:5173,不是 3000 —— Vite 默认端口是 5173
热更新失效?检查 solid-refresh 插件是否加载
SolidJS 的 HMR 依赖 solid-refresh,它不是自动注入的。如果修改组件后页面不刷新,大概率是插件没生效:
- 确认
vite.config.ts中有solidPlugin()(来自@solidjs/vite-plugin-solid) - 检查
node_modules/.vite/deps下是否有solid-refresh相关缓存文件 - 删掉
node_modules/.vite和pnpm-lock.yaml,重装依赖(尤其当从旧版 Solid 升级时)
WebStorm 不会帮你检测这个插件链是否断裂,得靠控制台输出判断:启动时应看到 [vite] hot updated: /src/App.tsx,而不是静默无反应。

















