WebStorm运行Quasar项目必须满足Node.js≥18、用npm init quasar初始化、配置host:'0.0.0.0'以支持手机访问，三者缺一不可。
WebStorm 能直接运行 Quasar Framework 项目，但必须绕过两个硬性前提：Node.js 版本 ≥18（Quasar v2.14+ 用 Vite 构建时强制要求），且 create-quasar 必须通过 npm init quasar 触发，不能靠全局安装 @quasar/cli 启动。
Node.js 版本必须 ≥18，否则 npm init quasar 直接报错
Quasar CLI 自 v2.12 起默认使用 Vite，而 Vite 5.x 要求 Node.js ≥18。你在 WebStorm 终端里敲 npm init quasar，如果看到类似错误：
error create-quasar@1.5.5: The engine "node" is incompatible with this module. Expected version ">=18".
说明当前 Node.js 版本太低。这不是警告，是阻断式报错 —— 命令根本不会继续执行。
- 别试图用
npm install -g @quasar/cli替代：它已废弃，且与新版 Quasar 项目结构不兼容 - 别在 WebStorm 设置里只改 Node interpreter 路径：WebStorm 只读取该路径用于调试和语法检查，终端实际执行仍走系统 PATH
- Windows 用户注意：
nvm-windows切换版本后，需重启 WebStorm 才能刷新终端里的node -v输出
WebStorm 终端里初始化 Quasar 项目的正确命令是 npm init quasar
这是 Quasar 官方推荐的现代初始化方式，也是唯一能生成标准 Vite + TypeScript + Quasar v2 结构的入口。它会自动拉取最新 create-quasar 包，无需手动安装任何 CLI 工具。
- 执行前确保你在目标父目录下（比如
E:\projects），不是C:\Windows\System32或用户根目录 —— 否则生成的项目名可能变成奇怪的路径片段 - 首次运行会提示
Need to install the following packages: create-quasar@1.5.5，按回车确认即可，这是正常流程 - 后续选项里选
App with Quasar CLI（不是 PWA 或 SSR），否则 WebStorm 无法识别quasar dev脚本 - 生成完项目后，WebStorm 会自动索引依赖，但需手动右键项目根目录 →
Reload project，否则quasar命令在终端里可能提示“command not found”
quasar dev 在 WebStorm 里跑不起来？检查 package.json 的 scripts 字段
Quasar 项目启动依赖 package.json 中是否包含 "dev": "quasar dev" 这一行。如果缺失或拼写错误（比如写成 "serve"），WebStorm 的 npm 面板和 Run Configuration 都会失效。
- 打开
package.json，确认scripts下有"dev": "quasar dev"，没有就手动加进去 - WebStorm 的 Run Configuration →
npm类型 → Script path 选package.json→ Command 选dev，不要手输命令 - 如果终端报
Cannot find module 'quasar'，说明node_modules没装全，删掉重跑npm install，别跳过 - 默认启动地址是
http://localhost:8080，但 Quasar 会自动打开浏览器；若想改端口，在quasar.conf.js的devServer.port里设，不是靠命令行参数
手机访问 localhost 失败？关键在 quasar.conf.js 的 devServer.host
WebStorm 默认启动的是本地监听（localhost），手机连不上是因为没绑定到局域网 IP。这不是 WebStorm 的问题，而是 Quasar 的 Vite 配置项未开放。
- 打开
quasar.conf.js，找到devServer对象，在里面加一行：host: '0.0.0.0' - 别只改
port：Vite 默认只监听127.0.0.1，host: '0.0.0.0'才允许外部设备访问 - 手机浏览器输入
http://[你的电脑局域网IP]:8080（比如http://192.168.1.102:8080），不是localhost - Windows 防火墙可能拦截：临时关掉或添加
node.exe入站规则，否则即使配置正确也超时
Quasar 在 WebStorm 里真正卡点的地方从来不是 IDE 功能，而是 Node 版本、初始化命令、host 绑定这三处。一旦跨过去，热更新、组件跳转、TS 类型提示都正常，不用额外装插件。
