需安装官方Svelte扩展、配置TypeScript支持、设置SvelteKit调试、修复ESLint冲突、手动指定LSP路径。

如果您正在使用 VSCode 进行 Svelte 应用开发，但编辑器缺乏语法高亮、智能补全或调试支持，则可能是由于缺少必要扩展或配置未生效。以下是针对该问题的多种解决方法：

本文运行环境：MacBook Air，macOS Sequoia。

一、安装官方 Svelte 扩展

VSCode 默认不内置 Svelte 支持，需通过 Marketplace 安装由 Svelte 官方维护的语言工具包，以启用语法解析、标签闭合、属性提示等核心功能。

1、在 VSCode 中按下 Cmd+Shift+X 打开扩展面板。

2、在搜索框中输入 Svelte for VS Code，确认发布者为 Svelte（官方认证徽章）。

3、点击“安装”，安装完成后重启 VSCode 窗口（使用 Cmd+Shift+P 输入 “Developer: Reload Window” 执行）。

二、配置 TypeScript 支持

Svelte 项目常与 TypeScript 混合使用，若 .svelte 文件中 TS 类型未被识别，需确保 TS 语言服务能正确加载 Svelte 类型定义。

1、在项目根目录下确认存在 tsconfig.json 文件，且其中包含 "include": ["src/**/*"] 配置项。

2、在项目中运行 npm install --save-dev svelte-preprocess @tsconfig/svelte。

3、在 tsconfig.json 的 "compilerOptions" 中添加 "types": ["svelte"]。

三、启用 SvelteKit 调试配置

对于基于 SvelteKit 的项目，需手动配置 launch.json 以支持断点调试和热重载集成，否则 F5 启动将无法进入源码调试流程。

1、在项目根目录创建 .vscode/launch.json 文件（若不存在）。

2、写入以下内容：{"version": "0.2.0","configurations": [{"type": "pwa-node","request": "launch","name": "SvelteKit Debug","runtimeExecutable": "npm","runtimeArgs": ["run","dev","--","--inspect"],"console": "integratedTerminal","port": 9229}]}。

3、确保已全局安装 @sveltejs/kit 并在 package.json 中 dev 脚本含 --inspect 参数。

四、修复 ESLint 与 Svelte 冲突

当 ESLint 报出 '$$props' is not defined 或类似错误时，说明 ESLint 未识别 Svelte 特殊变量，需扩展其作用域解析规则。

1、安装 eslint-plugin-svelte3（Svelte v3）或 eslint-plugin-svelte（v4+）。

2、在 .eslintrc.cjs 中的 extends 数组内加入 'plugin:svelte/recommended'。

3、在 processor 配置中添加 'svelte3/svelte3'（或对应版本处理器）。

五、启用 Svelte 语言服务器（LSP）手动路径

部分网络受限环境无法自动下载 Svelte LSP 二进制文件，导致语法检查失效，此时需指定本地已下载的 server 路径。

1、从 GitHub Releases 页面下载最新 svelte-language-server tarball（如 v10.12.0）并解压。

2、在 VSCode 设置中搜索 Svelte: Language Server Path。

3、点击“编辑设置 (JSON)”，添加键值对："svelte.language-server.path": "/path/to/svelte-language-server"。