WebStorm 中 Astro 支持需满足五步：Node.js ≥ v16.12.0（推荐 v18.20.8+）；安装 JetBrains 官方 Astro 插件（紫色原子图标）；用 create astro@latest 以相对路径、启用 TypeScript 初始化；打开项目时点 “Trust Project” 并自动运行 npm install；WebStorm 2026.1 起须手动启用 Astro 语言服务器。
Node.js 和 Astro 插件必须先就位
WebStorm 不会自动装 Node.js，也不会默认启用 Astro 支持。缺一不可，否则 astro dev 脚本灰色不可点、.astro 文件无语法高亮、import 不自动补全。
检查两件事：
- 终端运行
node -v，必须 ≥v16.12.0；推荐用v18.20.8或更高（Astro 官方当前最低要求） - 进
Settings | Plugins，搜Astro，只勾选 JetBrains 官方插件（图标是紫色原子符号），不是第三方 “Astro Language Support” - 如果搜不到，说明 WebStorm 版本低于
2023.3，需升级
用 create astro@latest 初始化时别跳过交互
在 WebStorm 内置终端（Alt+F12）里执行命令，不是复制粘贴完就切走。关键选项直接影响后续智能提示是否生效：
- 项目路径必须写成
./my-site这种相对路径，写成my-site或绝对路径，WebStorm 无法识别为 Astro 项目结构 - 务必选
Yes, use TypeScript—— 即使你不用 TS，也要选。因为 WebStorm 的组件属性推导、props补全严重依赖@astrojs/types，纯 JS 模式下功能大幅降级 - starter template 建议选
blank，避免模板自带的复杂配置干扰初始调试
打开已有 Astro 项目必须点 “Trust Project”
直接 File | Open 打开外部创建的 Astro 项目，WebStorm 会弹安全提示。点 “Preview in Safe Mode” 是最大误区：
-
package.json里的dev脚本保持灰色、src/pages/下文件不识别为页面入口、Emmet缩写失效 - 必须点 “Trust Project”，然后立刻在弹窗中点
Run 'npm install'—— 不能等手动敲命令，否则 WebStorm 不加载node_modules中的类型定义，TS 补全不工作 - 装完依赖后看右下角是否有
Astro: Ready提示；没有就执行File | Invalidate Caches and Restart
WebStorm 2026.1 必须手动启用 Astro 语言服务器
2026.1 版本起，Astro 语言服务器（LS）不再随插件自动启动。不启用会导致：astro dev 无法识别、组件属性无补全、import 不触发自动导入。
- 路径：
Settings | Languages & Frameworks | JavaScript | Frameworks | Astro，勾选Enable Astro language server - 若该选项灰显，说明没装
@astrojs/language-server：运行npx astro add language-server，再重启 WebStorm - 启用后右下角会出现
Astro LS: Ready；此时可卸载旧版紫色原子插件，避免冲突 - 确认
astro.config.mjs中output配置（如'static'或'serverless'）被正确解析，否则 LS 会跳过类型推导
