如何使用Bun运行时运行React.js与Node.js服务脚本？

问题复现 #

• 执行命令：bun App.js
• 抛出错误：

error: Cannot find module "./util.inspect" from "/Users/rehan/taptechinc/server/node_modules/object-inspect/index.js"

报错根因 #

1. 启动方式错误：React项目（含CRA、Vite、Next.js等各类脚手架创建的项目）不支持直接运行入口js文件启动，必须通过项目package.json中定义的脚本命令拉起编译、开发服务流程。
2. 依赖兼容问题：旧版本Bun对Node.js内置util.inspect模块的适配存在缺陷，或当前项目的node_modules是由npm/yarn等其他包管理器安装，存在模块解析规则冲突。

正确运行命令 #

场景1：从零创建Bun管理的React新项目 #

依次执行以下命令即可：

• 拉取官方React项目模板：bun create react 你的项目名
• 进入项目目录：cd 你的项目名
• 安装依赖（模板创建时会自动执行，依赖缺失时手动跑即可）：bun install
• 启动本地开发服务：bun run dev
• 生产环境打包：bun run build
• 本地预览生产包：bun run preview

场景2：已有其他包管理器管理的React项目 #

• 先删除项目根目录下原有的node_modules文件夹、package-lock.json/yarn.lock/pnpm-lock.yaml锁文件，避免依赖版本冲突
• 执行bun install重新安装全量依赖，Bun会自动适配React生态绝大多数依赖包
• 根据项目原有脚本启动：
  • 若为Create React App创建的项目，执行bun run start启动开发服务
  • 若为Vite创建的项目，执行bun run dev启动开发服务
  • 生产构建统一执行bun run build即可

当前报错快速修复 #

如果重新安装依赖后仍提示util.inspect模块找不到，执行bun add util-inspect安装对应兼容包，Bun会自动补全模块解析映射，无需额外配置。

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