Oxlint est un linter pour JavaScript et TypeScript écrit en Rust, qui fait partie du projet Oxc. La version 1.79.0 a été publiée le 18 août 2026 sous licence MIT. Sur le répertoire src de ce dépôt, soit 643 fichiers, une exécution avec la configuration par défaut prend environ 0,04 seconde sur mon portable à huit cœurs.
Oxc est une suite d'outils, oxlint en est un
Les noms Oxc et oxlint sont utilisés indifféremment, et c'est la première source d'erreurs d'installation. Oxc, l'Oxidation Compiler, est une enveloppe qui regroupe plusieurs programmes indépendants : un parser, un transformateur, un minifieur, un résolveur de modules, un formateur et le linter. Ils vivent tous dans le dépôt unique oxc-project/oxc, mais ils arrivent dans le registre npm sous forme de paquets séparés avec leurs propres numéros de version.
L'état au moment de la rédaction ressemble à ceci. Le linter est le paquet oxlint en version 1.79.0. Le formateur est oxfmt en version 0.64.0, publié pour la première fois le 10 septembre 2025, donc encore loin d'un un. Le parser, le transformateur et le minifieur sont oxc-parser, oxc-transform et oxc-minify, tous en version 0.146.0. Le résolveur est oxc-resolver en version 11.24.2. S'y ajoutent @oxc-project/types avec les définitions des nœuds de l'arbre syntaxique et @oxc-project/runtime avec des helpers pour le transformateur, tous deux en version 0.146.0. Il n'y a pas de version unique pour toute la suite, donc la question « quelle version d'Oxc as-tu » n'a pas de réponse sensée.
Le piège de nommage le plus vicieux se trouve dans le registre npm lui-même. Un paquet appelé oxc existe, porte la version 1.0.1, date du 5 mai 2016 et pointe vers le dépôt jasonmccreary/oxc. C'est un outil en ligne de commande pour ouvrir des projets dans Xcode et il n'a rien à voir avec l'Oxidation Compiler. Taper npm install oxc installe quelque chose de tout à fait différent de ce que tu attends, et tu n'as aucun avertissement.
Le binaire du linter lui-même n'est pas non plus là où on pourrait le supposer. Le paquet oxlint ne contient que du code JavaScript, et le binaire arrive via dix-neuf dépendances optionnelles nommées @oxlint/binding-darwin-arm64, @oxlint/binding-linux-x64-gnu, @oxlint/binding-win32-x64-msvc et ainsi de suite. Une installation qui ignore les dépendances optionnelles produit un paquet qui ne s'exécutera pas du tout.
Version, licence et distribution
J'ai vérifié la licence à trois endroits, car les paquets de cette collection se sont déjà révélés en désaccord avec eux-mêmes.
La première source est le fichier LICENSE de la branche principale du dépôt. Il contient le texte MIT avec deux mentions : « Copyright (c) 2024-present VoidZero Inc. & Contributors » et « Copyright (c) 2023 Boshen ». La seconde mention est une trace de la période où un seul auteur dirigeait le projet, avant l'existence de l'entreprise.
La deuxième source est le champ license du registre npm pour le paquet oxlint, qui indique MIT. La troisième et la plus importante est le contenu de l'archive publiée. Le fichier oxlint-1.79.0.tgz pèse 371 kilooctets compressé et environ 2,38 mégaoctets décompressé, contient dix-sept fichiers dont un LICENSE avec le texte MIT, un répertoire dist avec du vrai code, le point d'entrée bin/oxlint et un configuration_schema.json d'environ 758 kilooctets. Ce n'est ni un stub ni un métapaquet vide : le code est là et le fichier de licence aussi. J'ai aussi vérifié par sondage un paquet binaire, @oxlint/binding-linux-x64-gnu en version 1.79.0, et il déclare lui aussi MIT. Les trois sources disent la même chose, ce qui dans cette collection relève plus de l'exception que de la règle.
Le rythme des releases est dense. Le paquet existe dans le registre depuis le 27 juin 2023, a atteint la version 1.0.0 le 10 juin 2025, et 206 versions ont été publiées à ce jour. Les cinq dernières releases datent des 21 juillet, 27 juillet, 3 août, 10 août et 18 août 2026, environ une par semaine. Le numéro du milieu augmente à chaque release, donc une dépendance écrite ^1.79.0 acceptera des centaines de nouvelles règles sans rien demander.
Le champ engines exige Node en ^20.19.0 || >=22.12.0. C'est une vraie contrainte et pas une formalité, et elle fera échouer les installations sur les anciennes images de conteneurs qui circulent encore sur les serveurs de build.
Les dépendances de pair déclarées méritent aussi un coup d'œil, car elles disent quelque chose de la direction du projet. Il y en a deux, toutes deux marquées comme optionnelles : oxlint-tsgolint en version 7.0.2001 ou plus récente, et vite-plus sans borne de version. La première est le composant derrière les règles qui utilisent l'information de types. La seconde est vite-plus, un paquet en version 0.2.9 décrit comme une chaîne d'outils unifiée, un produit de VoidZero, la même entreprise derrière Vite et Vitest. La documentation de migration oriente ouvertement certains lecteurs dans cette direction : oxlint pour un linting dédié, Vite+ pour un flux de travail intégré. Le linter est sous MIT et personne ne peut te le retirer, mais la direction du développement est fixée par une entreprise qui vend un produit plus large, et c'est un risque qui mérite d'être nommé quand tu choisis un outil.
Installation et premier lancement
Oxlint n'a besoin d'aucune configuration pour faire quelque chose d'utile. Lancé sans fichier de réglages, il active la catégorie correctness et trois plugins par défaut.
npm install --save-dev oxlint@1.79.0
npx oxlint src
npx oxlint --init
npx oxlint --print-config
npx oxlint src --fix
npx oxlint src --format=github --deny-warningsLa commande --init crée un .oxlintrc.json avec les valeurs par défaut. La commande --print-config affiche la configuration complète et développée en JSON et c'est le meilleur moyen de vérifier ce qui est réellement activé plutôt que de deviner à partir de la documentation.
Il y a trois options de correction et elles diffèrent par le risque. --fix applique les changements considérés comme sûrs, --fix-suggestions ajoute des suggestions qui peuvent modifier le comportement du programme, et --fix-dangerously couvre aussi celles marquées comme dangereuses. Sur un serveur de build, on n'utilise normalement que la première, ou aucune.
Les formats de sortie sont checkstyle, default, agent, github, gitlab, json, junit, sarif, stylish et unix. Le format agent vise les assistants de code, github vise les annotations sur une demande de modification.
Configuration et champs qui existent réellement
Un .oxlintrc.json accepte exactement douze champs de premier niveau : $schema, categories, env, extends, globals, ignorePatterns, jsPlugins, options, overrides, plugins, rules et settings. Tout ce qui sort de cette liste est rejeté.
{
"$schema": "./node_modules/oxlint/configuration_schema.json",
"plugins": ["eslint", "typescript", "unicorn", "oxc", "import", "react", "vitest"],
"categories": {
"correctness": "error",
"suspicious": "warn",
"pedantic": "off"
},
"env": { "browser": true, "es2024": true },
"globals": { "__DEV__": "readonly" },
"ignorePatterns": ["dist", "coverage", "**/*.generated.ts"],
"options": {
"denyWarnings": false,
"maxWarnings": 50,
"reportUnusedDisableDirectives": true,
"respectEslintDisableDirectives": true,
"typeAware": false,
"typeCheck": false
},
"rules": {
"eslint/no-unused-vars": ["error", { "argsIgnorePattern": "^_" }],
"typescript/no-explicit-any": "warn",
"import/no-cycle": "error"
},
"overrides": [
{
"files": ["**/*.test.ts", "**/*.test.tsx"],
"excludeFiles": ["**/fixtures/**"],
"plugins": ["vitest"],
"rules": { "vitest/expect-expect": "error" }
}
]
}Il y a sept catégories et chacune prend la valeur allow, off, warn, error ou deny : correctness, suspicious, pedantic, perf, style, restriction et nursery. Le raccourci all disponible en ligne de commande les couvre toutes sauf nursery.
Le champ plugins prend des valeurs d'une liste fermée de quinze noms : eslint, react, unicorn, typescript, oxc, import, jsdoc, jest, vitest, jsx-a11y, nextjs, react-perf, promise, node, vue. Définir ce champ écrase l'ensemble par défaut, qui est unicorn, typescript et oxc, au lieu de s'y ajouter. C'est la cause la plus fréquente d'une situation où l'ajout d'un seul plugin fait que tout un lot de règles cesse silencieusement de signaler quoi que ce soit.
Une entrée d'overrides accepte les champs files, excludeFiles, env, globals, jsPlugins, plugins et rules. Les champs typeAware et typeCheck de la section options ne fonctionnent que dans la configuration racine et sont ignorés dans les configurations imbriquées.
L'alternative est un fichier oxlint.config.ts, marqué comme expérimental dans la documentation et qui nécessite un runtime Node.
import { defineConfig } from "oxlint";
export default defineConfig({
plugins: ["typescript", "unicorn", "oxc"],
options: {
typeAware: true,
typeCheck: true
},
rules: {
"typescript/no-floating-promises": ["error", { ignoreVoid: true }],
"typescript/no-unsafe-assignment": "warn"
}
});Le champ extends diffère aussi entre les deux. Dans .oxlintrc.json, c'est une liste de chaînes de chemins résolues par rapport au fichier qui les contient. Dans oxlint.config.ts, c'est une liste d'objets de configuration importés. Copier l'un directement dans l'autre ne fonctionnera pas.
Combien de règles oxlint a vraiment
Plutôt que de répéter un chiffre tiré des documents du projet, je l'ai compté avec --print-config sur la version 1.79.0.
npx oxlint --print-config | node -e "
let s=''; process.stdin.on('data', d => s += d).on('end', () => {
console.log(Object.keys(JSON.parse(s).rules).length)
})"
npx oxlint --print-config -D all -D nursery \
--import-plugin --react-plugin --jsdoc-plugin --jest-plugin \
--vitest-plugin --jsx-a11y-plugin --nextjs-plugin --react-perf-plugin \
--promise-plugin --node-plugin --vue-plugin > full.jsonSans configuration, 111 règles sont activées. Avec toutes les catégories, nursery comprise, et tous les plugins activés, le décompte est de 870 règles, réparties ainsi.
| Espace de noms | Nombre de règles | Équivalent dans le monde ESLint |
|---|---|---|
| eslint | 187 | Règles du cœur d'ESLint |
| unicorn | 138 | eslint-plugin-unicorn |
| typescript | 110 | typescript-eslint |
| react | 85 | react, react-hooks, react-refresh, React Compiler |
| vitest | 73 | @vitest/eslint-plugin |
| jest | 60 | eslint-plugin-jest |
| vue | 46 | eslint-plugin-vue, section script uniquement |
| jsx_a11y | 36 | eslint-plugin-jsx-a11y |
| import | 33 | eslint-plugin-import |
| oxc | 27 | Règles propres à Oxc et ports de deepscan |
| jsdoc | 23 | eslint-plugin-jsdoc |
| nextjs | 21 | @next/eslint-plugin-next |
| promise | 16 | eslint-plugin-promise |
| node | 11 | eslint-plugin-n |
| react_perf | 4 | eslint-plugin-react-perf |
Le tableau montre à la fois la portée et ses limites. Quatorze plugins intégrés couvrent les ensembles de règles que l'on rencontre le plus souvent, et en dehors d'eux rien n'est natif. Il y a 110 règles pour TypeScript et elles ne couvrent pas tout typescript-eslint, tandis que le plugin Vue ne gère que les règles qui opèrent sur la section script, donc l'analyse des templates est exclue.
Les règles qui ont besoin de l'information de types sont une autre histoire. Elles sont gérées par le composant oxlint-tsgolint, version 7.0.2001 du 21 juillet 2026, sous licence MIT, écrit en Go et construit sur typescript-go. La documentation annonce une couverture de 59 règles sur 61 des règles type-aware de typescript-eslint. Le prix est concret : TypeScript 7.0 ou plus récent est requis, certaines anciennes options de tsconfig.json ne fonctionnent pas, dont baseUrl, et pour de très gros dépôts la documentation elle-même met en garde contre une forte utilisation de la mémoire.
npm install --save-dev oxlint-tsgolint@7.0.2001
npx oxlint --type-aware
npx oxlint --type-aware --type-check
npx oxlint --type-aware --debug timings
OXC_LOG=debug npx oxlint --type-awareLe mode --type-check signale les erreurs de types avec les résultats du lint et peut remplacer une étape séparée tsc --noEmit sur un serveur de build. C'est une différence discrète mais importante avec Biome, qui ne fait aucune vérification de types.
Pour les plugins qui n'ont pas de portage natif, il existe le mécanisme jsPlugins, compatible avec l'API d'ESLint version neuf. Il est marqué alpha et a deux lacunes nettes : pas de prise en charge des parsers personnalisés, c'est-à-dire des fichiers Svelte, Vue et Angular, et pas de prise en charge des règles qui utilisent les types. Les règles de tels plugins s'exécutent plus lentement, car elles passent par une couche JavaScript, ce qui est exactement ce qu'oxlint voulait éviter.
Cohabiter avec ESLint
Oxlint n'est pas un remplaçant d'ESLint au sens « retirer l'un, mettre l'autre ». La documentation du projet le dit clairement et recommande un montage en deux étapes.
npx @oxlint/migrate
npx @oxlint/migrate --type-aware
npx @oxlint/migrate --js-plugins=false
npm install --save-dev eslint-plugin-oxlint@1.79.0
npx oxlint && npx eslint .L'outil @oxlint/migrate en version 1.79.0 lit une configuration plate d'ESLint version neuf ou dix et génère un .oxlintrc.json, en préservant les niveaux de sévérité, les options des règles, les overrides par chemin et les variables globales. Les anciens fichiers .eslintrc.js ne passeront pas directement, ils doivent d'abord passer par @eslint/migrate-config. Les plugins locaux de ton propre dépôt ne sont pas repris automatiquement et doivent être ajoutés à la main au champ jsPlugins.
Le paquet eslint-plugin-oxlint, lui aussi en version 1.79.0, fait l'inverse : il désactive les règles ESLint qu'oxlint vérifie déjà. Sans lui, chaque problème est signalé deux fois, et le temps d'exécution total ne baisse pas du tout.
L'ordre compte. Oxlint exécuté en premier rejette un changement en quelques dizaines de millisecondes, donc ESLint ne démarre que sur du code qui a déjà passé l'étape peu coûteuse. L'ordre inverse ne rapporte rien. Si tu construis avec Turborepo, il vaut la peine de garder les deux exécutions comme tâches séparées pour que le cache les traite indépendamment.
Oxlint face à Biome
Biome est le concurrent le plus proche et le choix entre eux revient à une décision : veux-tu un seul outil pour le formatage et le linting, ou deux séparés.
| Caractéristique | Oxlint 1.79.0 | Biome 2.5.9 |
|---|---|---|
| Périmètre | linting uniquement | formatage, linting, actions sur le source |
| Formatage | paquet séparé oxfmt 0.64.0 | intégré, mature |
| Licence | MIT | MIT ou Apache 2.0, au choix |
| Règles personnalisées | plugins JavaScript sur l'API ESLint v9, alpha | GritQL dans des fichiers .grit uniquement |
| Règles type-aware | 59 sur 61 via oxlint-tsgolint, nécessite TypeScript 7 | inférence propre, sans tsc |
| Vérification de types | --type-check remplace tsc --noEmit | aucune, tsc reste dans le pipeline |
| Langages au-delà de JS et TS | aucun | CSS, GraphQL, JSON, Vue et Svelte à un stade précoce |
| Fichier de configuration | .oxlintrc.json ou oxlint.config.ts | biome.json |
La conclusion pratique est la suivante. Si tu as déjà Prettier et que tu en es content, et que tu veux seulement réduire le temps de linting, oxlint convient mieux car il n'essaie pas de réécrire tout ton dépôt au passage. Si tu veux abandonner le couple ESLint plus Prettier d'un seul coup, Biome le fait plus complètement aujourd'hui, car son formateur a dépassé la version deux alors qu'oxfmt vient à peine de dépasser zéro. Si les règles qui utilisent l'information de types comptent pour toi, oxlint en mode --type-aware est plus proche du but, à condition de pouvoir monter TypeScript à la version sept.
Les deux outils partagent un domaine qu'aucun ne touche : ils ne construisent pas d'applications, c'est le rôle de esbuild ou de Vite, et ils n'ont rien à voir avec la couche de données, gérée par quelque chose comme Prisma.
Deux catégories voisines méritent d'être séparées, car la frontière se brouille. Un linter surveille le style et les erreurs courantes, tandis que Semgrep confronte des motifs à l'arbre syntaxique et chasse les vulnérabilités, donc une règle survit à un changement de formatage ou de nom de variable. Avant de l'adopter, vérifie cependant où passe la frontière payante : l'analyse inter-fichiers et inter-fonctions ne se trouve pas dans l'open source mais dans un binaire fermé téléchargé après connexion, et l'ensemble de règles de la communauté porte une licence sur mesure qui interdit la redistribution. Gratuit et ouvert sont deux choses différentes là-bas.
Erreurs courantes lors de l'adoption
La première est d'installer le paquet oxc au lieu d'oxlint. Tu obtiens un programme sans rapport datant de 2016 et aucun avertissement.
La deuxième est de définir le champ plugins en s'attendant à ce qu'il s'ajoute aux valeurs par défaut. Il les écrase. La liste doit nommer chaque plugin que tu veux, y compris unicorn, typescript et oxc s'ils doivent rester.
La troisième est de reprendre une règle qu'oxlint n'implémente pas. La configuration ne prévient pas dans ce cas, elle refuse de se charger : le message indique « Failed to parse oxlint configuration file » et nomme la règle inconnue dans ce plugin. Réécrire une configuration à la main, ligne par ligne, finit par une série de telles surprises, c'est pourquoi il vaut mieux lancer @oxlint/migrate, qui abandonne simplement les règles non prises en charge.
La quatrième est d'installer avec l'option qui ignore les dépendances optionnelles. Sans le paquet @oxlint/binding-* correspondant à ton système, il n'y a rien à exécuter.
La cinquième est un Node plus ancien que 20.19. Le champ engines est ici une vraie contrainte, pas une note d'intention.
La sixième est de définir typeAware ou typeCheck dans une configuration imbriquée. Les deux champs ne fonctionnent que dans le fichier racine et seront ignorés dans un sous-répertoire sans un mot d'explication.
La septième est de lancer --type-aware sur un dépôt dont le tsconfig.json racine définit include à **/*. Cela produit un énorme programme unique qui couvre aussi les sorties de build, et l'exécution s'étire en minutes. Le diagnostic est simple : avec OXC_LOG=debug, le log montre une ligne avec le nombre de fichiers source du programme.
La huitième est d'attendre d'oxlint qu'il formate le code. Il ne le fera pas, car c'est le travail d'oxfmt, un paquet séparé et une décision séparée.
La neuvième est d'activer la catégorie nursery sans figer une version exacte. Les règles de ce groupe changent de nom et de comportement entre les releases, et les releases arrivent chaque semaine.
FAQ
Oxlint remplacera-t-il ESLint dans mon projet ?
Cela dépend de la configuration. Si elle repose sur les règles du cœur, typescript-eslint, unicorn, import, react ou jsx-a11y, la couverture est élevée et oxlint seul suffit. Si tu utilises des plugins en dehors des quatorze intégrés, il reste le mécanisme alpha jsPlugins ou la cohabitation des deux outils.
Combien de règles oxlint 1.79.0 a-t-il ?
Avec toutes les catégories et tous les plugins activés, --print-config affiche 870 règles. Sans aucune configuration, 111 sont actives, car la catégorie correctness et les plugins unicorn, typescript et oxc s'exécutent par défaut.
Les règles qui nécessitent l'information de types fonctionnent-elles ?
Oui, après avoir installé oxlint-tsgolint et lancé avec l'option --type-aware. La couverture est de 59 règles sur 61 des règles type-aware de typescript-eslint. TypeScript 7.0 ou plus récent est requis, et baseUrl dans tsconfig.json n'est pas pris en charge.
Quelle est la différence entre oxlint et oxfmt ?
Oxlint inspecte le code et signale des problèmes, oxfmt le réécrit selon des règles de formatage. Ce sont deux paquets npm distincts avec des numéros de version distincts : 1.79.0 pour le linter, 0.64.0 pour le formateur. Installer l'un ne donne pas l'autre.
Oxlint est-il payant ?
Non. Le paquet, tous les binaires et le composant oxlint-tsgolint sont sous licence MIT, sans niveau payant ni restriction commerciale. VoidZero vend un produit séparé appelé Vite+, vers lequel la documentation de migration oriente les lecteurs qui cherchent une chaîne d'outils intégrée.
La documentation se trouve sur le site d'Oxc, le guide de migration dans la section ESLint, et le code source dans le dépôt GitHub.