Skip to main content

Rustfmt | Rust

  • Rustfmt | Rust

rustfmt e o formatador oficial da linguagem Rust. Ele ajusta automaticamente a formatacao do codigo para seguir o padrao recomendado pela comunidade Rust.

Ele e parecido com ferramentas como:

  • prettier, no JavaScript/TypeScript
  • black, no Python
  • gofmt, no Go

Para que serve​

O objetivo do rustfmt e evitar discussoes manuais sobre estilo de codigo. Ele padroniza itens como:

  • indentacao
  • quebras de linha
  • ordem e formato de imports
  • espacamento
  • layout de structs, enums e funcoes

Com isso, o codigo fica mais consistente e os diffs ficam menores em revisoes.

Como usar neste projeto​

Este projeto usa Rust edition 2024, definida no Cargo.toml.

Para formatar todo o projeto:

cargo fmt

Para verificar se o projeto esta formatado sem alterar arquivos:

cargo fmt --check

Para formatar apenas um arquivo especifico:

rustfmt --edition 2024 src\main.rs

Para verificar apenas um arquivo especifico:

rustfmt --edition 2024 --check src\main.rs

Quando rodar​

Rode o rustfmt antes de abrir um pull request ou antes de commitar alteracoes. Isso ajuda a manter o padrao do projeto e evita alteracoes de formatacao misturadas com alteracoes de comportamento.

Observacao importante​

rustfmt nao corrige problemas de logica, erros de compilacao ou bugs. Ele cuida apenas da formatacao do codigo.

Para validar compilacao, use:

cargo check