Formateurs

OpenCode formate automatiquement les fichiers après leur écriture ou leur modification à l’aide de formateurs spécifiques à la langue. Cela garantit que le code généré suit les styles de code de votre projet.

---

Intégré

OpenCode est livré avec plusieurs formateurs intégrés pour les langages et frameworks populaires. Vous trouverez ci-dessous une liste des formateurs, des extensions de fichiers prises en charge et des commandes ou options de configuration dont il a besoin.

Formateur	Rallonges	Exigences
gofmt	.go	Commande gofmt disponible
mix	.ex, .exs, .eex, .heex, .leex, .neex, .sface	Commande mix disponible
prettier	.js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml et plus	Dépendance prettier dans package.json
biome	.js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml et plus	Fichier de configuration biome.json(c)
zig	.zig, .zon	Commande zig disponible
clang-format	.c, .cpp, .h, .hpp, .ino et plus	Fichier de configuration .clang-format
ktlint	.kt, .kts	Commande ktlint disponible
ruff	.py, .pyi	Commande ruff disponible avec config
rustfmt	.rs	Commande rustfmt disponible
cargofmt	.rs	Commande cargo fmt disponible
uv	.py, .pyi	Commande uv disponible
rubocop	.rb, .rake, .gemspec, .ru	Commande rubocop disponible
standardrb	.rb, .rake, .gemspec, .ru	Commande standardrb disponible
htmlbeautifier	.erb, .html.erb	Commande htmlbeautifier disponible
air	.R	Commande air disponible
dart	.dart	Commande dart disponible
ocamlformat	.ml, .mli	Commande ocamlformat disponible et fichier de configuration .ocamlformat
terraform	.tf, .tfvars	Commande terraform disponible
gleam	.gleam	Commande gleam disponible
nixfmt	.nix	Commande nixfmt disponible
shfmt	.sh, .bash	Commande shfmt disponible
pint	.php	Dépendance laravel/pint dans composer.json
oxfmt (expérimental)	.js, .jsx, .ts, .tsx	Dépendance oxfmt dans package.json et un flag de variable d’environnement expérimental
ormolu	.hs	Commande ormolu disponible

Ainsi, si votre projet a prettier dans votre package.json, OpenCode l’utilisera automatiquement.

---

Comment ça marche

Lorsque OpenCode écrit ou modifie un fichier, il :

1. Vérifie l’extension du fichier par rapport à tous les formateurs activés.
2. Exécute la commande de formatage appropriée sur le fichier.
3. Applique automatiquement les modifications de formatage.

Ce processus se déroule en arrière-plan, garantissant que vos styles de code sont conservés sans aucune étape manuelle.

---

Configurer

Vous pouvez personnaliser les formateurs via la section formatter de votre configuration OpenCode.

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "formatter": {}
}

Chaque configuration du formateur prend en charge les éléments suivants :

Propriété	Tapez	Descriptif
disabled	booléen	Définissez ceci sur true pour désactiver le formateur
command	chaîne[]	La commande à exécuter pour le formatage
environment	objet	Variables d’environnement à définir lors de l’exécution du formateur
extensions	chaîne[]	Extensions de fichiers que ce formateur doit gérer

Regardons quelques exemples.

---

Désactivation des formateurs

Pour désactiver tous les formateurs globalement, définissez formatter sur false :

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "formatter": false
}

Pour désactiver un formateur spécifique, définissez disabled sur true :

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "formatter": {
    "prettier": {
      "disabled": true
    }
  }
}

---

Formateurs personnalisés

Vous pouvez remplacer les formateurs intégrés ou en ajouter de nouveaux en spécifiant la commande, les variables d’environnement et les extensions de fichier :

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "formatter": {
    "prettier": {
      "command": ["npx", "prettier", "--write", "$FILE"],
      "environment": {
        "NODE_ENV": "development"
      },
      "extensions": [".js", ".ts", ".jsx", ".tsx"]
    },
    "custom-markdown-formatter": {
      "command": ["deno", "fmt", "$FILE"],
      "extensions": [".md"]
    }
  }
}

L’espace réservé $FILE dans la commande sera remplacé par le chemin d’accès au fichier en cours de formatage.