SuperAPI AI 工具集

bun-first

编程与开发

查看项目

更新于 10-15 09:50

技能介绍

Bun-First 开发约定

本约定将 Bun 作为默认的 JavaScript 运行时、包管理器与任务运行器。除非明确说明不适用,否则默认假设 Bun 已可用。

总体原则

优先选择 Bun,而不是 Node.js、npm、pnpm 或 yarn。

当 Bun 提供内置能力时,优先使用内置能力而非第三方工具。

优先使用 Bun 的原生 API(例如用于文件访问、SQL、S3 等),而不是 Node.js API。

包管理

使用 bun install、bun add、bun remove。

避免使用 npm、yarn、pnpm。

优先采用 Bun 原生的 lockfile 与依赖解析行为。

保持依赖最小且有意引入。

脚本与工具

脚本优先使用 bun run。

不使用 Bun 的内置测试运行器(bun test)——测试使用 Vitest。

不使用 Bun 的构建工具(bun build)——构建使用 Vite。

除非确有必要,避免引入额外的任务运行器。

运行时与 API

优先使用 Bun 的原生 API(fetch、fs、path、环境变量处理)。

在编写代码时,假设运行时可用现代 Web API。

除非明确需要,否则避免使用 Node 专属 API。

性能与开发体验

优先使用简单、显式的脚本,而不是复杂的工具链。

避免不必要的抽象。