WebStorm 2025.2+ 自动识别 Bun：只需系统 PATH 包含 bun 且项目根目录存在 bun.lock 或 bun.lockb，无需手动配置 Runtime；macOS/Windows 用户需确保 GUI 启动继承 PATH，否则应从终端启动 IDE。
WebStorm 2025.2+ 不用手动配 Bun 运行时
只要系统 PATH 能查到 bun，且项目根目录下有 bun.lock 或 bun.lockb，WebStorm 就会自动启用 Bun——你不需要在 Settings → Languages & Frameworks → JavaScript → Runtime 里填路径或选 “Bun”。手动填了反而可能让 IDE 忽略 PATH 探测，导致后续运行/调试失败。
常见错误现象：Command 'bun' not found；右键 Run → Debug 报错找不到可执行文件；调试配置里显示 “Bun executable not found”。
- macOS 用户：GUI 启动的 WebStorm（Spotlight / Dock）通常不继承 shell 的 PATH（比如 zsh 配在
~/.zshrc里的），但终端里bun --version能跑 - Windows 用户：用 Scoop 或 Chocolatey 安装的
bun默认不写入系统 PATH，只对当前 PowerShell/CMD 会话生效 - 解决办法：清空
JavaScript Runtime页面中 “Bun” 字段（留空），重启 WebStorm；或者直接从终端启动：open -a "WebStorm"（macOS）或start webstorm（Windows，确保该终端已加载正确 PATH）
右键运行 .ts 文件时为什么没用 Bun？
WebStorm 只在满足两个条件时才默认用 Bun 执行：项目含 bun.lock/bun.lockb，且当前文件是 package.json 中定义的 script 入口，或你明确用了 “Run xxx.ts with Bun” 上下文菜单项。单纯双击打开一个孤立的 index.ts 并右键 Run，默认仍走 Node.js（除非你提前建好 Bun 运行配置）。
要让任意 .ts 文件都能一键用 Bun 运行：
- 右键文件 → Run 'xxx.ts'（不是 “Run 'xxx.ts' with Node.js”）——WebStorm 2025.2+ 会自动识别并创建临时 Bun 配置
- 若没出现该选项，说明 IDE 没识别出 Bun 环境，先检查
bun --version和bun.lock是否存在、PATH 是否透传 - 想长期复用（比如加
--watch或--hot），必须建永久配置：Run → Edit Configurations → + → Bun，填File path（如src/main.ts），别填完整命令
Bun 调试时内联变量不显示？这是正常现象
WebStorm 的内联变量（编辑器右侧实时显示变量值）目前仅对 Node.js + ts-node 调试链路完整支持；Bun 的 DAP 调试虽可用（macOS/Linux），但内联渲染能力尚未打通。你仍能看到断点停靠、调用栈、变量面板，只是不会像 Node.js 那样在代码行尾自动浮出值。
如果你依赖这个功能做快速原型验证：
- 临时方案：改用
ts-node调试（Run → Edit Configurations → + → Node.js，Runtime path 设为ts-node，Working directory 和 JavaScript file 填对应路径） - 注意：Bun 的原生 TS 支持（零配置）和
ts-node的行为不完全一致，比如装饰器、paths别名解析可能有差异 - 别指望
--hot在调试模式下生效——它只对bun run有效，bun test或调试启动不支持
Windows 下 Bun 调试根本点不动？别折腾了
截至 WebStorm 2025.2，Bun 的 DAP（Debug Adapter Protocol）调试仅支持 macOS 和 Linux；Windows 用户点击 Debug 图标会静默失败，或报 Failed to launch Bun debug session 类错误，这不是配置问题，是平台限制。
现阶段可行替代路径：
- 开发阶段用 Windows + WSL2，在 WSL 里装 Bun、开 WebStorm（通过
code .方式或 WSL GUI 启动），就能用完整调试能力 - 坚持纯 Windows 原生环境：用
console.log+bun run --watch快速反馈，或切回 Node.js +ts-node调试关键逻辑 - 别尝试手动指定
bun.exe路径来绕过——WebStorm 期望的是 Unix 风格可执行名bun，硬填bun.exe反而破坏自动探测
最易被忽略的一点：Bun 的性能优势主要在冷启动和包安装，IDE 集成度再高，也改变不了它当前在 Windows 调试链路上的缺失。别把时间花在“怎么让它在 Windows 上调试起来”，而是考虑要不要换环境或换调试方式。
