VSCode 不执行 SWC 编译，仅需确保 tsconfig.json 与 .swcrc 配置一致并重启 TS Server；常见问题源于 TS 语言服务未同步 SWC 的 jsx、decorator 等解析规则。
VSCode 里 SWC 不会自动替代 Babel，必须关掉原有构建流程
VSCode 本身不参与代码编译，它只是编辑器。你看到的“SWC 替代 Babel”效果，实际来自项目里运行的构建工具（如 vite、next dev、swc-cli），不是 VSCode 配置出来的。VSCode 唯一能做的，是配合这些工具——比如正确识别 .swcrc、不误报语法错误、让 TypeScript 插件不和 SWC 的 transform 冲突。
常见错误现象：import type 报错、装饰器标红、JSX 元素类型不识别，其实不是 SWC 没生效，而是 VSCode 的 TS 语言服务还在用默认编译配置解析文件。
- 确认项目已安装 SWC 工具链（如
@swc/core+swc-loader或@swc/jest），VSCode 不负责执行它们 - 关闭任何基于 Babel 的实时检查插件（如旧版
Babel JavaScript语法高亮扩展） - 确保
tsconfig.json中"compilerOptions": { "jsx": "react-jsx" }与 SWC 的jsc.transform.react.runtime一致，否则 JSX 提示会错乱
tsconfig.json 和 .swcrc 必须对齐 jsx / decorator / importAttributes 配置
TS 编译器（VSCode 依赖它做语义检查）和 SWC 运行时 transform 是两套系统，但它们对同一段代码的理解必须一致，否则会出现「VSCode 标红但项目能跑」或「项目报错但编辑器没提示」。
典型不匹配场景：swc 开了 jsc.transform.decorator.version = "2022-03"，但 tsconfig.json 还是 "experimentalDecorators": true（对应旧版装饰器），结果 VSCode 认为装饰器语法非法，而 SWC 却成功编译了。
-
.swcrc里启用jsc.transform.decorator→tsconfig.json必须设"decoratorMetadata": true且"target"≥"ES2022" -
.swcrc用jsc.parser.syntax = "typescript"且含importAttributes→tsconfig.json要加"moduleResolution": "bundler"和"allowImportingTsExtensions": true - TS 插件默认不读
.swcrc，所以所有影响类型检查的选项（如jsx模式）必须显式写进tsconfig.json
VSCode 的 TypeScript 插件需要手动重启 TS Server
改完 tsconfig.json 或新增 .swcrc 后，VSCode 不会自动重载 TypeScript 语言服务。你看到的语法报错、跳转失败、补全缺失，大概率是旧缓存导致的。
错误现象：明明 .swcrc 已配好 jsc.transform.react.runtime = "automatic"，但 React 依然要手动 import React from 'react' 才不报错——其实是 TS Server 还在按老配置解析。
- 快捷键
Ctrl+Shift+P（macOS 是Cmd+Shift+P）→ 输入Restart TS server→ 回车 - 或者右下角点击 TypeScript 版本号（如
Version 5.3）→ 选Restart TS Server - 如果项目用了
pnpm或bun，确保typescript是 workspace 本地安装，而非全局；否则 VSCode 可能加载错版本
不要在 VSCode 设置里配 “swc.enable”: true 这类伪配置
目前没有任何 VSCode 官方或主流扩展提供 swc.enable 这样的开关项。搜到的所谓“VSCode SWC 插件”，基本是过时的语法高亮包，或把 swc-cli 封装成命令调用的简易工具——它们不改变语言服务行为，也不加速编译。
容易踩的坑：在 settings.json 里手写 "swc.enable": true，以为开启了 SWC 支持，结果既无效果，又干扰后续排查。
- VSCode 原生不支持 SWC 作为语言服务器，别找“一键启用”设置
- 真要预览 SWC 输出，用命令行跑
npx swc src/index.ts -o lib/index.js更可靠 - 调试 SWC 配置问题，优先看构建命令的输出（如
vite build --debug），而不是 VSCode 的 Problems 面板
最常被忽略的一点：SWC 的 jsc.parser 和 jsc.transform 是分离的，前者影响 VSCode 能否正确 parse 语法（决定是否标红），后者才真正编译。很多人只调 transform，忘了 parser 也要同步开 experimental 功能。
