| --- |
| title: Formattatori |
| description: OpenCode usa formattatori specifici per linguaggio. |
| --- |
| |
| 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](https://biomejs.dev/) | file di configurazione `biome.json(c)` | |
| | cargofmt | .rs | comando `cargo fmt` disponibile | |
| | clang-format | .c, .cpp, .h, .hpp, .ino, and [more](https://clang.llvm.org/docs/ClangFormat.html) | 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](/docs/cli/#experimental) | |
| | pint | .php | dipendenza `laravel/pint` in `composer.json` | |
| | prettier | .js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml, and [more](https://prettier.io/docs/en/index.html) | 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: |
|
|
| 1. Controlla l'estensione del file rispetto a tutti i formattatori abilitati. |
| 2. Esegue il comando del formattatore appropriato sul file. |
| 3. 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. |
|
|
| ```json title="opencode.json" |
| { |
| "$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`: |
|
|
| ```json title="opencode.json" {3} |
| { |
| "$schema": "https://opencode.ai/config.json", |
| "formatter": false |
| } |
| ``` |
|
|
| Per disabilitare un formattatore **specifico**, imposta `disabled` a `true`: |
|
|
| ```json title="opencode.json" {5} |
| { |
| "$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: |
|
|
| ```json title="opencode.json" {4-14} |
| { |
| "$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. |
|
|
