Guide Terminal - Windows vs macOS

Pourquoi ce guide ?

Le terminal peut sembler intimidant, mais c’est un outil essentiel pour le développement web. Ce guide vous aide à comprendre les différences entre Windows et macOS/Linux.

---

Les bases : qu’est-ce qu’un terminal ?

Un terminal (ou invite de commandes) est une interface texte pour donner des instructions à votre ordinateur. Au lieu de cliquer, vous tapez des commandes.

Sur macOS/Linux :

• Application : Terminal (ou iTerm2)
• Shell par défaut : zsh ou bash

Sur Windows :

• Applications : PowerShell, CMD, ou Windows Terminal
• Shell par défaut : PowerShell (recommandé)

---

Différences fondamentales

1. Navigation dans les dossiers

Action	macOS/Linux	Windows (PowerShell)
Afficher le dossier actuel	pwd	pwd ou Get-Location
Lister les fichiers	ls	ls ou dir
Changer de dossier	cd nom-dossier	cd nom-dossier
Remonter d’un dossier	cd ..	cd ..
Aller au dossier personnel	cd ~	cd ~

Exemples :

# macOS/Linux
cd Documents
cd ~/Desktop
pwd

# Windows PowerShell
cd Documents
cd ~\Desktop
pwd

---

2. Chemins de fichiers

macOS/Linux : utilise le slash /

/Users/julien/code/mon-projet
~/Desktop/fichier.txt

Windows : utilise le backslash \ (mais PowerShell accepte aussi /)

C:\Users\Julien\code\mon-projet
~\Desktop\fichier.txt

Conseil : Dans les commandes npm/node, utilisez toujours / (compatible partout).

---

3. Créer et supprimer des fichiers/dossiers

Action	macOS/Linux	Windows (PowerShell)
Créer un dossier	mkdir nom-dossier	mkdir nom-dossier
Créer un fichier vide	touch fichier.txt	New-Item fichier.txt
Supprimer un fichier	rm fichier.txt	rm fichier.txt ou del fichier.txt
Supprimer un dossier	rm -rf dossier	rm -r -Force dossier

Exemples :

# macOS/Linux
mkdir src/lib
touch src/lib/Composant.svelte

# Windows PowerShell
mkdir src\lib
New-Item src\lib\Composant.svelte

---

4. Permissions et sudo

macOS/Linux : utilise sudo pour les droits administrateur

sudo npm install -g vite

Windows : exécuter PowerShell en tant qu’Administrateur (clic droit > “Exécuter en tant qu’administrateur”)

npm install -g vite

Note : Évitez sudo npm install dans vos projets (jamais dans le dossier projet).

---

5. Variables d’environnement

Action	macOS/Linux	Windows (PowerShell)
Afficher une variable	echo $PATH	echo $env:PATH
Définir une variable	export VAR=valeur	$env:VAR="valeur"

---

6. Commandes utiles pour le développement

Action	macOS/Linux	Windows	Notes
Lancer un serveur	npm run dev	npm run dev	✅ Identique
Installer des dépendances	npm install	npm install	✅ Identique
Vérifier la version Node	node --version	node --version	✅ Identique
Ouvrir un fichier	open fichier.html	start fichier.html	⚠️ Différent
Effacer l’écran	clear	cls ou clear	⚠️ Différent
Copier un fichier	cp source.txt dest.txt	copy source.txt dest.txt	⚠️ Différent

---

Problèmes courants et solutions

Problème 1 : “npm n’est pas reconnu”

Cause : Node.js n’est pas installé ou pas dans le PATH

Solution :

1. Télécharger et installer Node.js depuis nodejs.org
2. Redémarrer le terminal
3. Vérifier avec node --version

---

Problème 2 : “permission denied” (macOS/Linux)

Cause : Droits insuffisants

Solution :

# NE PAS utiliser sudo pour npm install dans un projet
# À la place, réparer les permissions npm globales :
sudo chown -R $(whoami) ~/.npm

---

Problème 3 : “execution policy” (Windows PowerShell)

Erreur :

npm : Impossible de charger le fichier... car l'exécution de scripts est désactivée sur ce système

Solution :

# Exécuter PowerShell en tant qu'administrateur, puis :
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

---

Problème 4 : Caractères bizarres dans le terminal Windows

Cause : Encodage incorrect

Solution :

chcp 65001

Ou utiliser Windows Terminal (plus moderne que PowerShell classique).

---

Raccourcis clavier utiles

macOS/Linux

Raccourci	Action
Ctrl + C	Arrêter un processus en cours
Ctrl + L ou clear	Effacer l’écran
Tab	Auto-complétion
↑ / ↓	Naviguer dans l’historique
Ctrl + A	Aller au début de la ligne
Ctrl + E	Aller à la fin de la ligne

Windows PowerShell

Raccourci	Action
Ctrl + C	Arrêter un processus en cours
cls ou clear	Effacer l’écran
Tab	Auto-complétion
↑ / ↓	Naviguer dans l’historique
Home	Aller au début de la ligne
End	Aller à la fin de la ligne

---

Commandes spécifiques au cours

Installation du projet Svelte

Identique sur macOS et Windows :

npm create vite@latest mon-projet-rtmf -- --template svelte
cd mon-projet-rtmf
npm install
npm run dev

Créer un composant

macOS/Linux :

mkdir -p src/lib
touch src/lib/MonComposant.svelte

Windows PowerShell :

mkdir src\lib -Force
New-Item src\lib\MonComposant.svelte

Alternative (marche partout) : Créer le fichier directement dans votre éditeur de code.

---

Git : commandes identiques

Bonne nouvelle : Les commandes Git sont identiques sur tous les systèmes.

git init
git add .
git commit -m "Message"
git status
git log

---

Conseils pour débutants

1. Ne pas avoir peur de se tromper : Au pire, vous fermez le terminal et recommencez
2. Utiliser l’auto-complétion : Tapez les premières lettres puis Tab
3. Copier-coller : Clic droit dans le terminal (ou Ctrl+Shift+V)
4. Lire les erreurs : Souvent, elles indiquent la solution
5. Demander de l’aide : Si bloqué, montrez l’erreur à l’enseignant

---

Tableau de référence rapide

Tâche	macOS/Linux	Windows
Lister fichiers	ls	ls ou dir
Changer de dossier	cd dossier	cd dossier
Créer un dossier	mkdir dossier	mkdir dossier
Créer un fichier	touch fichier	New-Item fichier
Supprimer fichier	rm fichier	rm fichier
Ouvrir fichier	open fichier	start fichier
Effacer l’écran	clear	cls
Chemin	/ (slash)	\ (backslash, mais / accepté)
Droits admin	sudo	Exécuter en admin

---

Ressources pour aller plus loin

Tutoriels terminal :

• Terminal macOS pour débutants
• PowerShell pour débutants

Outils modernes :

• Windows Terminal - Terminal moderne pour Windows
• iTerm2 - Alternative au Terminal macOS
• Oh My Zsh - Personnalisation du terminal macOS/Linux

---

En cas de blocage

Si vous rencontrez un problème terminal pendant le cours :

1. Notez l’erreur exacte (screenshot ou copier-coller)
2. Demandez moi
3. Vérifiez les problèmes courants ci-dessus
4. Redémarrez le terminal (souvent, ça suffit)

Le terminal devient familier avec la pratique. Vous n’avez pas besoin de tout mémoriser, juste de savoir où chercher.