Formattatori
OpenCode formatta automaticamente i file dopo che vengono scritti o modificati usando formattatori specifici per linguaggio. Questo assicura che il codice generato segua lo stile del tuo progetto.
OpenCode include diversi formattatori integrati per linguaggi e framework popolari. Qui sotto trovi la lista dei formattatori, delle estensioni supportate e dei comandi o opzioni di config richiesti.
| Formattatore | Estensioni | Requisiti |
|---|---|---|
| air | .R | comando air disponibile |
| biome | .js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml, and more | file di configurazione biome.json(c) |
| cargofmt | .rs | comando cargo fmt disponibile |
| clang-format | .c, .cpp, .h, .hpp, .ino, and more | file di configurazione .clang-format |
| cljfmt | .clj, .cljs, .cljc, .edn | comando cljfmt disponibile |
| dart | .dart | comando dart disponibile |
| dfmt | .d | comando dfmt disponibile |
| gleam | .gleam | comando gleam disponibile |
| gofmt | .go | comando gofmt disponibile |
| htmlbeautifier | .erb, .html.erb | comando htmlbeautifier disponibile |
| ktlint | .kt, .kts | comando ktlint disponibile |
| mix | .ex, .exs, .eex, .heex, .leex, .neex, .sface | comando mix disponibile |
| nixfmt | .nix | comando nixfmt disponibile |
| ocamlformat | .ml, .mli | comando ocamlformat disponibile e file di configurazione .ocamlformat |
| ormolu | .hs | comando ormolu disponibile |
| oxfmt (Experimental) | .js, .jsx, .ts, .tsx | dipendenza oxfmt in package.json e una flag variabile d’ambiente sperimentale |
| pint | .php | dipendenza laravel/pint in composer.json |
| prettier | .js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml, and more | dipendenza prettier in package.json |
| rubocop | .rb, .rake, .gemspec, .ru | comando rubocop disponibile |
| ruff | .py, .pyi | comando ruff disponibile con config |
| rustfmt | .rs | comando rustfmt disponibile |
| shfmt | .sh, .bash | comando shfmt disponibile |
| standardrb | .rb, .rake, .gemspec, .ru | comando standardrb disponibile |
| terraform | .tf, .tfvars | comando terraform disponibile |
| uv | .py, .pyi | comando uv disponibile |
| zig | .zig, .zon | comando zig disponibile |
Quindi, se il progetto ha prettier in package.json, OpenCode lo usera automaticamente.
Quando OpenCode scrive o modifica un file:
- Controlla l’estensione del file rispetto a tutti i formattatori abilitati.
- Esegue il comando del formattatore appropriato sul file.
- Applica automaticamente le modifiche di formattazione.
Questo processo avviene in background, mantenendo lo stile del codice senza passaggi manuali.
Puoi personalizzare i formattatori nella sezione formatter della config di OpenCode.
{
"$schema": "https://opencode.ai/config.json",
"formatter": {}
}Ogni configurazione di formattatore supporta:
| Proprieta | Tipo | Descrizione |
|---|---|---|
disabled | boolean | Impostalo a true per disabilitare il formattatore |
command | string[] | Il comando da eseguire per la formattazione |
environment | object | Variabili d’ambiente da impostare quando si esegue |
extensions | string[] | Estensioni file gestite da questo formattatore |
Vediamo alcuni esempi.
Per disabilitare tutti i formattatori globalmente, imposta formatter a false:
{
"$schema": "https://opencode.ai/config.json",
"formatter": false
}Per disabilitare un formattatore specifico, imposta disabled a true:
{
"$schema": "https://opencode.ai/config.json",
"formatter": {
"prettier": {
"disabled": true
}
}
}Puoi sovrascrivere i formattatori integrati o aggiungerne di nuovi specificando comando, variabili d’ambiente ed estensioni file:
{
"$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"]
}
}
}Il placeholder $FILE nel comando viene sostituito con il percorso del file in fase di formattazione.