Installer et utiliser bun : lancer un script, ajouter un paquet, créer un projet

Installer bun selon les étapes officielles, lancer un script, ajouter un paquet et démarrer un premier projet avec bun init.

Pour exécuter JavaScript ou TypeScript en local avec bun, quatre étapes : installer par le canal officiel, lancer un script avec bun, bun add un paquet, puis bun init pour un premier projet.

Suivre bun.sh/docs/installation, ne pas inventer les paquets. Requêtes : installer bun, bun add, bun init. Installer : bun.sh.

bunNom de commande Oven
addécrit package.json
initcrée le premier projet

Installer le binaire officiel selon l’OS

macOS et Linux

Script officiel : curl -fsSL https://bun.sh/install | bash. Ou brew install oven-sh/bun/bun. Nouveau terminal, bun --version.

Windows

PowerShell : powershell -c "irm bun.sh/install.ps1 | iex". Nouvelle session, bun doit être sur le PATH.

ÉtapeCommandeÀ surveiller
Installbun --versionLe shell courant doit voir le binaire officiel
Scriptbun hello.ts.js / .ts directement ; pas de compilation d’abord
Dépendancebun add zodNom npm ; le lockfile est mis à jour
Projetbun initpackage.json doit apparaître

Installer, lancer, ajouter, créer

  1. 01
    Installer et confirmer la version

    bun.sh/docs/installation pour le script ou Homebrew. bun --version doit afficher une version. Commande absente : nouveau terminal et PATH. Mise à jour : bun upgrade.

  2. 02
    Lancer un script

    Écrire hello.ts (ou hello.js), puis bun hello.ts. bun inclut un runtime ; tsc d’abord n’est pas nécessaire. Script package.json : bun run <script>.

  3. 03
    Ajouter un paquet

    Dans le projet, exemple bun add zod. bun résout et écrit le lockfile. En cas d’échec, nom et réseau ; ne pas retoucher un lockfile à moitié écrit.

  4. 04
    Démarrer un premier projet

    Dans un dossier vide : bun init. Les invites créent package.json et un fichier d’entrée. Puis bun run ou bun index.ts. Dépôt existant : 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
# Après le fichier d’entrée :
bun index.ts
Le script officiel est-il obligatoire ?
Non. La doc cite aussi Homebrew, npm, Scoop, etc. En choisir un, vérifier avec bun --version. Ne pas empiler plusieurs copies qui se disputent le PATH.
Faut-il Node d’abord pour TypeScript ?
Pas au quotidien. bun fournit un runtime et exécute .ts directement. Si un script force node, lire les notes de compatibilité officielles.
Différence entre bun add et npm install ?
Les deux ajoutent une dépendance. bun add utilise le résolveur et le lockfile bun (bun.lock). Ne pas mélanger les lockfiles npm / pnpm / bun dans le même dossier.
L’install remplace-t-elle un schéma partagé ?
Non. Toolchain JavaScript locale. Si la réunion est le même schéma, ouvrir sitdraw.

D’abord bun sur le PATH

Tant que bun --version échoue, ne pas traiter un init raté comme un bug de modèle. Souvent le shell n’a pas chargé le PATH modifié par l’installeur.

Commencer le dessin