Skip to content
Learni
View all tutorials
Outils de développement

Comment configurer ESLint dans un projet JS en 2026

12 minBEGINNER
JavaScriptESLintQualité de code

Introduction

ESLint est l'outil de référence pour analyser statiquement votre code JavaScript et TypeScript. Il détecte les erreurs courantes, applique un style cohérent et prévient les bugs avant même l'exécution. En 2026, son intégration est devenue indispensable dans tout projet professionnel. Ce tutoriel vous montre comment configurer ESLint de A à Z dans un projet Node.js ou frontend simple. Vous apprendrez à créer une configuration personnalisée, à ajouter des scripts npm et à l'intégrer dans votre éditeur. À la fin, vous disposerez d'un environnement de développement plus fiable et productif.

Prérequis

  • Node.js 18 ou supérieur
  • Un projet JavaScript existant (ou vide)
  • Connaissances de base de la ligne de commande
  • Un éditeur de code (VS Code recommandé)

Installation d'ESLint

terminal
npm install --save-dev eslint

Cette commande installe ESLint en tant que dépendance de développement. Elle ajoute le binaire eslint dans node_modules et met à jour votre package.json.

Initialisation de la configuration

terminal
npx eslint --init

L'outil interactif vous pose quelques questions (style, framework, TypeScript). Il génère automatiquement le fichier de configuration adapté à votre projet.

Fichier de configuration .eslintrc.json

.eslintrc.json
{
  "env": {
    "browser": true,
    "es2021": true,
    "node": true
  },
  "extends": ["eslint:recommended"],
  "parserOptions": {
    "ecmaVersion": "latest",
    "sourceType": "module"
  },
  "rules": {
    "semi": ["error", "always"],
    "quotes": ["error", "single"],
    "no-unused-vars": "warn"
  }
}

Ce fichier définit l'environnement, les règles de base et les règles personnalisées. Chaque règle peut être définie en error, warn ou off.

Ajout du script lint dans package.json

package.json
{
  "scripts": {
    "lint": "eslint .",
    "lint:fix": "eslint . --fix"
  }
}

Les scripts permettent d'exécuter ESLint facilement via npm run lint. L'option --fix corrige automatiquement les problèmes simples.

Fichier .eslintignore

.eslintignore
node_modules
build
dist
coverage
*.min.js

Ce fichier indique à ESLint quels dossiers et fichiers ignorer. Il évite les analyses inutiles sur les dépendances et les fichiers générés.

Bonnes pratiques

  • Commencez toujours par les règles recommandées puis ajoutez-en progressivement
  • Utilisez l'option --fix dans vos hooks de pré-commit
  • Partagez la configuration via un package ESLint partagé dans les équipes
  • Activez les règles de TypeScript uniquement si vous utilisez TypeScript
  • Vérifiez régulièrement les mises à jour des plugins

Erreurs courantes à éviter

  • Oublier d'ignorer le dossier node_modules (ralentit énormément)
  • Définir trop de règles strictes dès le début (frustration de l'équipe)
  • Ne pas installer les plugins correspondant à votre framework
  • Exécuter ESLint sur des fichiers déjà formatés par Prettier sans coordination

Pour aller plus loin

Intégrez ESLint avec Prettier, configurez des hooks Husky ou explorez les règles TypeScript avancées. Découvrez nos formations Learni pour maîtriser les outils modernes de qualité de code.