Installer l’outillage

  • installer Node.js, npm et TypeScript
  • vérifier que la chaîne d’outils fonctionne
  • savoir faire la même chose sans droits administrateur sur les machines de l’école

Ce qu’il faut installer

Outil Rôle Lien
Node.js (avec npm) exécuter du JavaScript hors du navigateur, installer des paquets nodejs.org
TypeScript le compilateur tsc, qui traduit TypeScript en JavaScript typescriptlang.org
VS Code l’éditeur code.visualstudio.com

Astro ne s’installe pas globalement : il s’initialise projet par projet avec npm create astro@latest (on le fera au chapitre 1.2).

AvertissementVersion de Node.js

Astro exige Node.js 22.12 ou plus récent, et refuse les versions impaires (23, 25…). Vérifiez avec node --version : si vous êtes en dessous, installez la version LTS depuis nodejs.org.

Installer TypeScript

Deux façons de faire, et le choix dépend d’où vous êtes.

Sur votre machine personnelle

Installation globale : la commande tsc devient disponible partout.

npm install -g typescript

Sur macOS et Linux, il faut parfois préfixer par sudo.

Sur les machines de l’école

Vous n’avez pas le droit d’installer globalement. On installe donc TypeScript localement, dans le dossier du projet, et on préfixe les commandes par npx :

mkdir tp-test
cd tp-test
npm install typescript --save-dev
npx tsc -v

npx en une phrase : il exécute un outil installé dans le dossier node_modules du projet courant, au lieu de le chercher dans le système.

Dans tout le reste du cours, quand vous lisez tsc, comprenez npx tsc si vous êtes sur une machine de l’école.

Vérifier l’installation

node --version
npm --version
tsc --version

Vous devez obtenir quelque chose comme :

v20.11.0
10.2.4
Version 5.9.3

Les numéros exacts importent peu. Ce qui compte, c’est qu’aucune des trois commandes ne réponde command not found.

tsc: command not found alors que l’installation semble avoir réussi ?

  • Machine perso : l’installation globale s’est probablement faite sans les droits suffisants, ou le dossier des binaires npm n’est pas dans votre PATH. Testez npm root -g puis relancez un nouveau terminal.
  • Machine de l’école : vous avez oublié le préfixe npx, ou vous n’êtes pas dans le dossier du projet contenant node_modules.

Les extensions VS Code

Ouvrez VS Code, cliquez sur l’icône Extensions dans la barre latérale gauche (ou Ctrl+Shift+X / Cmd+Shift+X), puis installez :

Extension À quoi elle sert
Astro coloration et autocomplétion des fichiers .astro (chapitre 1.2)
Prettier reformater le code automatiquement
GitHub Copilot Chat l’assistant IA (voir la page dédiée)

Et ensuite

Passez à la configuration des outils, puis attaquez le chapitre 1.1.