如何配置Bun类型支持使其在VS Code等编辑器正常显示类型提示？

本地Bun已可正常运行但IDE无完整类型提示，均为TypeScript服务未正确加载Bun类型定义导致，按以下步骤配置即可：

基础配置（所有编辑器通用前提） #

• 项目根目录必须存在正确配置的tsconfig.json，若项目未生成该文件，直接在根目录执行bun init -y即可自动生成带默认正确配置的文件
• 手动配置tsconfig.json时，需在compilerOptions.types数组中显式加入"bun"，参考配置如下：

{
  "compilerOptions": {
    "types": ["bun"],
    "target": "ESNext",
    "module": "ESNext",
    "moduleResolution": "bundler"
    // 其余原有业务配置保持不变即可
  }
}

• 不要依赖全局安装的Bun类型包，直接在项目本地执行bun add -d bun-types将类型包装为开发依赖，所有基于tsserver的编辑器默认都会扫描项目本地node_modules下的类型定义，全局安装的类型不会被自动识别。

VS Code 专属配置 #

• 在扩展市场搜索安装官方Bun扩展，扩展会自动接管Bun相关的类型识别、运行、调试逻辑
• 按快捷键调出命令面板：Windows/Linux按Ctrl+Shift+P，macOS按Cmd+Shift+P，搜索TypeScript: Select TypeScript Version，选择「使用工作区版本」
• 配置完成后如果仍有异常，在命令面板搜索TypeScript: Restart TS Server重启TS服务即可生效。

其他编辑器通用配置（WebStorm/Neovim/Sublime Text等） #

• 所有基于tsserver的编辑器，只要完成前面的基础配置（本地安装bun-types、tsconfig正确声明types），重启后即可自动识别Bun类型
• 无项目配置的单文件场景，直接在文件顶部添加三斜杠类型引用指令即可：

/// <reference types="bun" />

• WebStorm额外调整项：打开设置面板，找到Languages & Frameworks > TypeScript，将TypeScript版本切换为项目本地node_modules中安装的版本，不要使用IDE内置的TS版本，同时确认开启TypeScript Language Service开关。

常见异常排查 #

• 若配置后仍存在部分API提示缺失，检查tsconfig.json的compilerOptions.types数组中是否同时声明了"node"，Node.js类型定义与Bun类型存在部分API冲突，会导致Bun专属API提示被覆盖；如果确实需要混用Node类型，将"bun"放在types数组的最靠前位置即可
• 类型加载异常时可执行bun pm cache clear清理Bun依赖缓存，再重启编辑器TS服务
• 不要手动将Bun全局安装目录下的types文件夹路径加入编辑器配置，版本迭代时路径变化会导致类型失效。

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