Bun Runtime & Toolkit

Ускорьте разработку с помощью Bun. Научитесь использовать Bun как среду выполнения, менеджер пакетов и сборщик в Claude Code для более быстрых рабочих процессов JavaScript и TypeScript.

Инструменты разработчика ★ 172,007 GitHub (172,007 ★)

Этот навык снабжает Claude специализированными знаниями экосистемы Bun, предоставляя рекомендации по использованию Bun как молниеносно быстрой альтернативы Node.js. Он охватывает основные рабочие процессы, включая управление пакетами с помощью bun install, нативное выполнение TypeScript, высокопроизводительную сборку и встроенное тестирование через bun test. Также предлагает важные рекомендации по миграции существующих проектов Node.js на Bun и настройке оптимизированных развертываний на платформах типа Vercel для максимальной производительности приложений и продуктивности разработчиков.

Ключевые возможности

01Оптимизация облачного развертывания для Vercel и CI/CD пайплайнов

02Бесшовные стратегии миграции с Node.js и рекомендации по совместимости

03Нативное выполнение TypeScript и JSX без внешних транспиляторов

04172,007 звезд на GitHub

05Молниеносно быстрое управление пакетами и установка зависимостей

06Высокопроизводительный встроенный тестовый раннер с API, совместимыми с Jest

Сценарии использования

01Миграция существующих проектов Node.js на Bun для повышения производительности

02Настройка высокоскоростных сред тестирования и автоматических развертываний на Vercel

03Настройка единого инструментария JavaScript для нового проекта на TypeScript

name	bun-runtime
description	Bun 作为运行时、包管理器、打包器和测试运行器。何时选择 Bun 而非 Node、迁移注意事项以及 Vercel 支持。
origin	ECC

Bun 运行时

Bun 是一个快速的全能 JavaScript 运行时和工具集：运行时、包管理器、打包器和测试运行器。

何时使用

优先选择 Bun 用于：新的 JS/TS 项目、安装/运行速度很重要的脚本、使用 Bun 运行时的 Vercel 部署，以及当您想要单一工具链（运行 + 安装 + 测试 + 构建）时。
优先选择 Node 用于：最大的生态系统兼容性、假定使用 Node 的遗留工具，或者当某个依赖项存在已知的 Bun 问题时。

在以下情况下使用：采用 Bun、从 Node 迁移、编写或调试 Bun 脚本/测试，或在 Vercel 或其他平台上配置 Bun。

工作原理

运行时：开箱即用的 Node 兼容运行时（基于 JavaScriptCore，用 Zig 实现）。
包管理器：bun install 比 npm/yarn 快得多。在当前 Bun 中，锁文件默认为 bun.lock（文本）；旧版本使用 bun.lockb（二进制）。
打包器：用于应用程序和库的内置打包器和转译器。
测试运行器：内置的 bun test，具有类似 Jest 的 API。

从 Node 迁移：将 node script.js 替换为 bun run script.js 或 bun script.js。运行 bun install 代替 npm install；大多数包都能工作。使用 bun run 来执行 npm 脚本；使用 bun x 进行 npx 风格的临时运行。支持 Node 内置模块；在存在 Bun API 的地方优先使用它们以获得更好的性能。

Vercel：在项目设置中将运行时设置为 Bun。构建命令：bun run build 或 bun build ./src/index.ts --outdir=dist。安装命令：bun install --frozen-lockfile 用于可重复的部署。

示例

运行和安装

# Install dependencies (creates/updates bun.lock or bun.lockb)
bun install

# Run a script or file
bun run dev
bun run src/index.ts
bun src/index.ts

脚本和环境变量

bun run --env-file=.env dev
FOO=bar bun run script.ts

测试

bun test
bun test --watch

// test/example.test.ts
import { expect, test } from "bun:test";

test("add", () => {
  expect(1 + 2).toBe(3);
});

运行时 API

const file = Bun.file("package.json");
const json = await file.json();

Bun.serve({
  port: 3000,
  fetch(req) {
    return new Response("Hello");
  },
});

最佳实践

提交锁文件（bun.lock 或 bun.lockb）以实现可重复的安装。
在脚本中优先使用 bun run。对于 TypeScript，Bun 原生运行 .ts。
保持依赖项最新；Bun 和生态系统发展迅速��

🧰 Что это

Bun Runtime & Toolkit — это универсальная замена Node.js, которая объединяет в себе четыре инструмента: быстрый JavaScript/TypeScript-рантайм, пакетный менеджер (bun install), сборщик (bun build) и тест-раннер (bun test). Написан на Zig, использует JavaScriptCore (движок Safari) вместо V8, что даёт заметный прирост скорости при установке зависимостей и запуске скриптов. Skill помогает разобраться, когда выбирать Bun вместо Node, как мигрировать существующий проект и как настроить Bun на Vercel.

⚙️ Как работает

🏃 Рантайм

Bun запускает .js и .ts файлы напрямую, без дополнительной конфигурации TypeScript. Он поддерживает большинство Node.js API (fs, path, http), но также предоставляет собственные, более производительные аналоги — например, Bun.file() для работы с файлами и Bun.serve() для создания HTTP-сервера.

📦 Пакетный менеджер

Команда bun install скачивает зависимости в разы быстрее npm install или yarn. Lock-файл по умолчанию — bun.lock (текстовый формат), в старых версиях использовался бинарный bun.lockb. Оба файла рекомендуется коммитить в репозиторий для воспроизводимых установок.

🧪 Тест-раннер

bun test — встроенный аналог Jest с похожим API. Тесты пишутся с импортом из bun:test:

bun test
bun test --watch

// test/example.test.ts
import { expect, test } from "bun:test";
test("add", () => {
  expect(1 + 2).toBe(3);
});

🏗️ Сборщик

bun build может собирать как приложения, так и библиотеки. Поддерживает TypeScript, JSX, CSS-модули. Пример для продакшена:

bun build ./src/index.ts --outdir=dist

🔄 Миграция с Node

Основные замены команд:

node script.js → bun run script.js или просто bun script.js
npm install → bun install
npx package → `bun x `package
npm run script → `bun run `script

Большинство npm-пакетов работают без изменений. Если есть специфичные для Node API, Bun их эмулирует, но для максимальной производительности стоит использовать нативные Bun-функции там, где это возможно.

☁️ Vercel

В проекте на Vercel нужно в настройках указать Bun как рантайм. Команды для vercel.json или панели управления:

Build: bun run build или bun build ./src/index.ts --outdir=dist
Install: bun install --frozen-lockfile (для повторяемых сборок)

🎯 Когда использовать

Новые проекты — если не требуется максимальная совместимость с экосистемой Node, Bun даёт значительный прирост скорости разработки.
Скрипты и утилиты — быстрый запуск, встроенная поддержка TypeScript, .env-файлы через флаг --env-file.
Vercel-деплои — официальная поддержка Bun как рантайма.
Моноинструментальные проекты — когда хочется один инструмент для установки, сборки, тестов и запуска.

Когда лучше остаться на Node:

Если проект использует инструменты, которые предполагают Node (например, некоторые плагины Webpack, старые версии ESLint).
Если есть зависимость с известными проблемами под Bun (проверяйте совместимость на bun.sh/guides/ecosystem).
Для максимальной совместимости с экосистемой — Node остаётся стандартом де-факто.

💡 Важно знать

Lock-файл обязателен — коммитьте bun.lock (или bun.lockb) для воспроизводимости.
TypeScript работает нативно — не нужен ts-node или tsc для разработки.
Bun развивается быстро — следите за changelog, так как API может меняться.
Не все npm-пакеты совместимы — перед миграцией проверьте критические зависимости.
Переменные окружения можно передавать как FOO=bar bun run script.ts или через файл: bun run --env-file=.env dev.

Установка одной командой.

npx skillfish add affaan-m/everything-claude-code bun-runtime

Источник: https://mcpmarket.com/tools/skills/bun-runtime-toolkit-3