sitdraw

Как установить и использовать bun: скрипт, пакет и первый проект

По официальным шагам установить bun, запустить скрипт, добавить пакет и начать первый проект через bun init.

Чтобы локально запускать JavaScript или TypeScript через bun, закройте четыре шага: официальная установка, скрипт командой bun, bun add одного пакета, затем bun init для первого проекта.

Идите по bun.sh/docs/installation, не угадывайте пакеты. Запросы: установить bun, bun add, bun init. Установщик: bun.sh.

bunИмя команды Oven
addпишет package.json
initсоздаёт первый проект

Поставить официальный бинарник под ОС

macOS и Linux

Официальный скрипт: curl -fsSL https://bun.sh/install | bash. Или brew install oven-sh/bun/bun. Новый терминал, bun --version.

Windows

PowerShell: powershell -c "irm bun.sh/install.ps1 | iex". Новая сессия: bun должен быть в PATH.

ШагКомандаНа что смотреть
Установкаbun --versionТекущая оболочка должна видеть официальный бинарник
Скриптbun hello.ts.js / .ts сразу; компиляция заранее не нужна
Зависимостьbun add zodимя с npm; lockfile обновляется
Проектbun initдолжен появиться package.json

Установка, скрипт, пакет, проект

  1. 01
    Установить и сверить версию

    bun.sh/docs/installation — скрипт или Homebrew. bun --version должен напечатать версию. Нет команды — новый терминал и PATH. Обновление: bun upgrade.

  2. 02
    Запустить скрипт

    Напишите hello.ts (или hello.js) и выполните bun hello.ts. У bun свой runtime, tsc сначала не нужен. Скрипт из package.json: bun run <script>.

  3. 03
    Добавить один пакет

    В каталоге проекта пример bun add zod. bun разрешает зависимости и пишет lockfile. При ошибке проверьте имя и сеть; не правьте недописанный lockfile руками.

  4. 04
    Запустить первый проект

    В пустой папке bun init. Подсказки создадут package.json и входной файл. Затем bun run или bun index.ts. Существующий репозиторий: bun install.

curl -fsSL https://bun.sh/install | bash
bun --version
printf 'console.log("ok")\n' > hello.ts
bun hello.ts
mkdir myproject && cd myproject
bun init
bun add zod
# После входного файла:
bun index.ts
Обязателен ли официальный скрипт?
Нет. В документах есть Homebrew, npm, Scoop и другие каналы. Выберите один и проверьте bun --version. Не ставьте несколько копий, которые дерутся за PATH.
Нужен ли сначала Node для TypeScript?
В повседневной работе нет. У bun свой runtime, .ts выполняется напрямую. Если скрипт жёстко вызывает node, смотрите официальные заметки о совместимости.
Чем bun add отличается от npm install?
Оба добавляют зависимость. bun add использует резолвер и lockfile bun (bun.lock). Не смешивайте lockfile npm / pnpm / bun в одном каталоге.
Заменяет ли установка общую схему?
Нет. Это локальный JavaScript toolchain. Если встреча — та же схема, откройте sitdraw.

Сначала bun в PATH

Пока bun --version не работает, не считайте упавший init ошибкой шаблона. Чаще оболочка не подхватила PATH, который изменил установщик.

Начать картину