Build sur Windows — Dépannage

Le client utilise Vite, qui s’appuie sur esbuild (binaire natif fourni pour Windows : @esbuild/win32-x64/esbuild.exe). Aucune compilation C++ n’est nécessaire : ce sont des exécutables précompilés.

Vous avez désinstallé « Windows Development » / « Windows Developer » (~2 Go)

Le logiciel d’environ 2 Go dont le nom contient Windows Development ou Windows Developer est en général :

Visual Studio Build Tools (outils de génération Visual Studio), ou
Windows SDK (Software Development Kit), ou
un composant « Développement Windows » de Visual Studio.

Pour ce projet (Vite + esbuild), vous n’avez pas besoin de réinstaller tout ça. Il suffit d’installer le runtime qui va avec, beaucoup plus léger.

1. Réinstaller uniquement le Visual C++ Redistributable (souvent suffisant)

Après la désinstallation du gros paquet « Windows Development », il peut manquer le Visual C++ Redistributable (quelques dizaines de Mo). C’est lui qui permet d’exécuter des .exe natifs comme esbuild.exe.

Télécharger : Microsoft Visual C++ Redistributable (dernière version)
Installer la version x64 (et éventuellement x86 si vous utilisez du 32 bits).
Redémarrer le terminal, puis dans client/ : npm run build.

Pas besoin de réinstaller les 2 Go de « Windows Development » pour faire tourner le build.

2. Réinstaller les dépendances du client

cd client
Remove-Item -Recurse -Force node_modules
Remove-Item -Force package-lock.json
npm install
npm run build

3. Antivirus / Windows Defender

Parfois l’antivirus ou Windows Defender bloque l’exécution de esbuild.exe.

Ajouter une exclusion pour le dossier du projet (ou au minimum client\node_modules) dans Windows Defender / antivirus.
Relancer npm run build.

4. Droits / exécution

Lancer PowerShell ou CMD en tant qu’administrateur une fois, aller dans client/ et lancer npm run build pour vérifier si le problème vient des droits.
Vérifier que le disque n’est pas en lecture seule et que le dossier n’est pas synchronisé par OneDrive/Dropbox au moment du build.

5. Node et npm à jour

node -v   # 18+ recommandé
npm -v

Si besoin, réinstaller Node depuis nodejs.org (version LTS).

En résumé : après avoir désinstallé des outils de dev Windows, réinstaller le Visual C++ Redistributable et refaire un npm install dans client/ règle souvent le problème.

2.6 KiB Raw Permalink Blame History Unescape Escape