bun-runtime

用途：介绍 Bun 运行时的用法，涵盖运行文件与脚本、watch/hot 模式、环境变量、CLI 参数、预加载、工作区与模块解析等。\n\n主要能力：Bun 是基于 JavaScriptCore 的一体化 JavaScript 运行时，Linux 上启动速度约为 Node.js 的 4 倍。可直接运行并即时转译 TypeScript、JSX：bun run index.ts（简写 bun index.ts）。常用参数包括 --watch（文件变更重启）、--hot（热模块替换并保留状态）、--smol（降低内存）、--inspect（调试）、--preload（预加载模块）、--env-file（指定 .env 文件）、-e/--eval（执行代码字符串）。执行带 Bun 参数的脚本时，参数需紧跟在 bun 之后，例如 bun --watch run dev；写成 bun run dev --watch 会把参数传给脚本。\n\n环境与全局：Bun 自动加载 .env、.env.local、.env.development 等，可用 bun --env-file .env.production run index.ts 指定，或在 bunfig.toml 中设 env = false 关闭自动加载；代码中可用 process.env 或 Bun.env 读取。全局对象包含 Bun、Buffer、process、fetch、Request/Response、WebSocket、crypto、console、__dirname、__filename 等。预加载可写为 bun --preload ./setup.ts run index.ts，或在 bunfig.toml 中配置 preload。\n\n脚本与工作区：bun run dev 运行 package.json 脚本（可简写 bun dev），bun run 列出脚本，bun run --bun vite 用 Bun 替代 Node 运行，并支持 preclean、postclean 等生命周期钩子。工作区可用 bun run --filter 'pkg-' build 或 bun run --filter '' test。还支持标准输入执行，如 echo "console.log('Hello')" | bun run -。调试可用 --inspect、--inspect-wait、--inspect-brk 连接 Chrome DevTools 或 VS Code。\n\n常见问题与限制：找不到模块时运行 bun install；顶层 await 报错需改为异步函数或使用 .mts；watch 不生效多为参数位置错误。更多配置、完整 CLI 参数与模块解析细节可按需查阅资料中的 references/bunfig.md、references/cli-flags.md、references/module-resolution.md。资料未提供收费、价格与平台支持等细节。