在VS Code中使用Bun单例时提示"Cannot find name Bun"问题求助

1. 安装Bun类型定义 #

Bun自带类型支持，但偶尔需要手动关联类型文件。在项目根目录的WSL终端执行：

bun add -d @types/bun

如果是全局安装的Bun，也可以全局安装类型：

bun add -g @types/bun

2. 切换VS Code的TypeScript版本 #

VS Code默认使用内置TypeScript，需要切换到Bun自带的版本才能正确识别Bun API：

• 按Ctrl+Shift+P（Mac为Cmd+Shift+P）打开命令面板
• 搜索TypeScript: Select TypeScript Version
• 选择Use Workspace Version（Bun会将TypeScript包放在项目的node_modules目录中）

3. 配置tsconfig/jsconfig文件 #

在项目根目录新建或修改tsconfig.json（JS项目则修改jsconfig.json），添加Bun的类型引用：

{
  "compilerOptions": {
    "types": ["bun"]
  }
}

4. 重启VS Code窗口 #

完成配置后，打开命令面板搜索Developer: Reload Window，刷新窗口使设置生效。

额外排查项 #

• 确认VS Code右下角状态栏显示的是WSL环境，避免连接到本地Windows环境
• 在WSL终端执行bun --version，确保Bun能正常运行且已加入系统PATH
• 暂时禁用其他可能冲突的TypeScript/JavaScript扩展，比如第三方Bun扩展或旧版语言服务插件

内容的提问来源于stack exchange，提问作者terraquad