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.
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.
| Étape | Commande | À surveiller |
|---|---|---|
| Install | bun --version | Le shell courant doit voir le binaire officiel |
| Script | bun hello.ts | .js / .ts directement ; pas de compilation d’abord |
| Dépendance | bun add zod | Nom npm ; le lockfile est mis à jour |
| Projet | bun init | package.json doit apparaître |
Installer, lancer, ajouter, créer
- 01Installer et confirmer la version
bun.sh/docs/installation pour le script ou Homebrew.
bun --versiondoit afficher une version. Commande absente : nouveau terminal et PATH. Mise à jour :bun upgrade. - 02Lancer un script
Écrire
hello.ts(ouhello.js), puisbun hello.ts. bun inclut un runtime ; tsc d’abord n’est pas nécessaire. Script package.json :bun run <script>. - 03Ajouter 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. - 04Démarrer un premier projet
Dans un dossier vide :
bun init. Les invites créentpackage.jsonet un fichier d’entrée. Puisbun runoubun 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.