webstorm无法识别svelte组件，90%是因文件类型未绑定、插件未真正加载或语言服务器未启动；需删text files中.svelte、添加svelte component类型、禁用html files中的.svelte，并确保webstorm≥2022.3、启用jetbrains官方插件、安装@ sveltejs/language-server且勾选typescript设置中的svelte选项。
WebStorm 无法识别 Svelte 组件，90% 是文件类型没绑对、插件没真正加载，或语言服务器压根没跑起来——不是代码写错了，也不是项目坏了。
为什么 .svelte 文件打开全是白底黑字、没有高亮和补全
WebStorm 默认把 .svelte 当成纯文本（Text files 类型），根本不会触发 Svelte 解析逻辑。即使装了插件，只要文件类型没正确映射，就只是“看着像前端文件，实则被当作文档”。
- 进
Settings > Editor > File Types，在Text files的Registered Patterns列表里删掉*.svelte（老版本自动加的兜底规则） - 找到
Svelte Component类型（若没有，点+新建，Name 填Svelte Component，Pattern 填*.svelte） - 检查
HTML Files的Registered Patterns，确保里面没有*.svelte——否则它只走 HTML 解析器，{#if}和$:全当非法标记 - 改完后，已打开的
.svelte文件右下角语言栏会显示Plain Text，手动点它选Svelte才生效；或者执行File > Reload project from Disk
$: 声明标红、{#each} 报 Unexpected token
这是典型插件“看似启用、实则未初始化”的表现。JetBrains 官方 Svelte 插件在 WebStorm 2022.3 之前不支持语法校验，2022.3+ 才开始真正解析 Svelte 特有语法。
- 打开
Help > About，确认版本 ≥2022.3；低于就升级 IDE，别试兼容方案 - 进
Settings > Plugins，搜Svelte，只启用作者是JetBrains的那个，禁用所有叫svelte-intellij的废弃插件 - 插件启用后必须重启 WebStorm——不重启，插件加载器根本不运行
- 确保项目根目录有
svelte.config.js或至少jsconfig.json，否则插件无法推断export let name: string这类类型信息
类型检查和智能补全还是不工作
内置插件只做基础语法识别，真正的类型推导、TS 支持、$$Props 补全，得靠 @sveltejs/language-server。WebStorm 不会自动拉这个包，也不自动启用它。
- 在项目根目录运行：
npm install --save-dev @sveltejs/language-server - 进
Settings > Languages & Frameworks > TypeScript > Svelte，勾选Enabled（注意路径：它藏在 TypeScript 设置里，但控制的是 Svelte LS） - 如果补全仍不出现，大概率是缓存卡住了：执行
File > Invalidate Caches and Restart > Invalidate and Restart - 终端里想跑类型检查？别敲
svelte-check（会报command not found），直接用npx svelte-check—— 它能自动定位node_modules/.bin/svelte-check
热更新（HMR）不触发、保存没反应
这不是 WebStorm 配置问题，而是开发服务器本身没接好 HMR 通道。SvelteKit/Vite 的 HMR 依赖 dev server 启动时的 WebSocket 连接，WebStorm 只负责转发保存事件。
- 确认你用的是
npm run dev或npm run dev -- --host（某些网络环境需显式开 host） - 检查终端输出是否有
HMR enabled或Connected to Vite HMR server类似提示 - 如果用的是自定义脚本（比如
rollup -w），HMR 基本不可用——Svelte 官方推荐用 SvelteKit 或 Vite 脚手架 - WebStorm 的
Save automatically设置（Settings > Appearance & Behavior > System Settings）要打开，否则编辑器不主动写磁盘，dev server 根本收不到变更
最容易被忽略的一点：插件启用、文件绑定、语言服务器三者必须全部到位且版本匹配，缺一不可。很多人调了一上午，最后发现只是忘了重启 WebStorm，或者 svelte.config.js 里少了个 kit 字段导致语言服务器启动失败。
