WebStorm 2026.1 原生支持 SvelteKit 全栈开发，但需手动配齐三类关键设置：.svelte 文件类型绑定、Svelte Language Server 启用、Node.js 全栈运行配置，否则默认降级为 CSR，导致服务端路由不执行、断点失效、类型提示缺失。
WebStorm 2026.1 能跑通 SvelteKit 全栈开发，但默认配置下 npm run dev 实际只启动 CSR（纯客户端渲染），+page.server.ts 不执行、+server.ts 断点不命中、$lib 跳转失效——不是项目问题，是 IDE 没识别为全栈模式。
确认 WebStorm 版本和 Svelte 插件已真正启用
低于 2022.3 的版本对 $:、{#if} 等语法基本无解析能力，标红≠代码错，而是 IDE 根本不认。必须满足两个硬条件：
- Help > About 中显示版本 ≥
2022.3（推荐直接用2026.1） - Settings > Plugins 中启用的是作者为
JetBrains的Svelte插件，禁用所有svelte-intellij类废弃插件 - 插件启用后必须重启 WebStorm —— 否则加载器不初始化，
$.svelte文件仍被当纯文本处理
绑定 .svelte 文件类型并清理冲突规则
WebStorm 默认把 .svelte 塞进 Text files 类型里，导致语法高亮、折叠、bind: 补全全部失效。关键动作不是“加”，而是“删+绑”：
- Settings > Editor > File Types >
Text files，在Registered Patterns中删掉*.svelte - 同页面找到
Svelte Component类型（若无，点 + 新建，Name 填Svelte Component，Pattern 填*.svelte） - 检查
HTML Files的Registered Patterns，确保里面没有*.svelte—— 否则它只走 HTML 解析器，{#each}直接报错 - 改完后，已打开的
.svelte文件右下角语言栏会显示Plain Text，手动点它选Svelte才生效；或执行File > Reload project from Disk
启用 Svelte Language Server 并配齐三类全栈调试开关
仅靠插件只能做基础高亮，export let name: string、$$Props、+server.ts 断点等依赖 @sveltejs/language-server。而 WebStorm 不会自动拉包、也不会自动启用它：
- 终端运行：
npx svelte-kit sync（生成.svelte-kit/types） - Settings > Languages & Frameworks > TypeScript > Svelte，勾选
Enabled（注意：这个开关藏在 TypeScript 设置里） - 确认
.svelte-kit/types在 Settings > Languages & Frameworks > JavaScript > Libraries 中被标记为Source（不是Not included） - Run > Edit Configurations…，新增一个
Node.js配置：
– Working directory：项目根目录
– JavaScript file：node_modules/.bin/svelte-kit
– Application parameters：dev --host
– 勾选Allow parallel run（SvelteKit 需同时监听前端 5173 和服务端端口）
检查 svelte.config.js 和 adapter 配置是否到位
WebStorm 判断是否启用 SSR 的依据之一，就是 svelte.config.js 中是否声明了有效的 kit.adapter。空配置或 adapter-auto 在 IDE 内部识别逻辑中可能被降级：
- 确保项目根目录存在
svelte.config.js，且导出对象含kit.adapter，例如：import adapter from '@sveltejs/adapter-node';export const config = { kit: { adapter } }; - 若用
adapter-static，需确认你真要 SSG 模式——否则load函数不触发、POST /api/xxx返回 404 是预期行为，不是配置失败 - 修改
svelte.config.js后，右键项目 →Reload project from disk，强制刷新框架识别状态 -
$lib别名跳转失败？检查tsconfig.json中compilerOptions.paths是否正确映射："$lib/*": ["src/lib/*"]
最易被忽略的点：WebStorm 对服务端上下文的类型检查是静默宽松的。+layout.server.ts 里写 document.body 不报错，但实际编译时会被剥离——IDE 不提示，得靠人工规避。真正的全栈链路，从来不是装完插件就自动跑通，而是三处手动配齐：文件类型绑定、语言服务器启用、全栈运行配置落地。缺一不可。
