在程式碼的浩瀚海洋中，風格統一就如同海面上指引方向的燈塔，讓開發者們在協作開發時不再迷失。對於崇尚 "表達力" 與 "安全性" 的 Rust 語言來說，程式碼風格更像是一種儀式感，讓每一行程式碼都散發著優雅的氣息。而 Rustfmt，正是幫助我們實作這一目標的魔法棒。
Rustfmt：程式碼格式化之鑰
Rustfmt 是 Rust 官方提供的程式碼格式化工具，它可以自動將你的程式碼調整為符合社群規範的風格。想象一下，你正在與其他開發者共同開發一個計畫，每個人都有著自己獨特的程式碼風格，這無疑會增加程式碼閱讀和理解的成本。而 Rustfmt 的出現，就像是一位無形的管家，默默地將所有程式碼都整理成統一的風格，讓團隊協作變得更加輕松高效。
安裝 Rustfmt
在開始使用 Rustfmt 之前，我們需要先安裝它。Rustfmt 已經包含在 Rust 工具鏈中，如果你已經安裝了 Rust，那麽你就可以直接使用 Rustfmt。你可以透過以下命令來檢查 Rustfmt 是否已經安裝：
rustfmt --version
如果你的系統中沒有安裝 Rustfmt，你可以透過以下命令來安裝：
rustup component add rustfmt
使用 Rustfmt
使用 Rustfmt 格式化程式碼非常簡單，你只需要在終端中輸入以下命令：
rustfmt <檔名>
例如，我們想要格式化
src/main.rs
檔，就可以使用以下命令：
rustfmt src/main.rs
Rustfmt 會自動讀取檔內容，並將其格式化為符合規範的程式碼。
配置 Rustfmt
Rustfmt 預設使用社群推薦的程式碼風格，但你也可以根據自己的喜好對它進行自訂配置。你可以在計畫根目錄下建立一個名為
rustfmt.toml
的檔，並在其中添加配置項來修改 Rustfmt 的行為。
例如，我們可以透過以下配置來修改縮排的空格數：
indent_ style = "Space"
tab_spaces = 4
Rustfmt 進階技巧
除了基本的使用方法之外，Rustfmt 還提供了一些進階技巧，可以幫助我們更好地管理程式碼風格。
格式化整個計畫
如果你想要格式化整個計畫中的所有 Rust 檔，可以使用以下命令：
cargo fmt
該命令會自動尋找計畫中的所有 Rust 檔，並對其進行格式化。
檢查程式碼風格
除了格式化程式碼之外，Rustfmt 還可以幫助我們檢查程式碼是否符合規範。你可以使用以下命令來檢查程式碼風格：
cargo fmt -- --check
如果程式碼不符合規範，Rustfmt 會輸出錯誤資訊，並提示你需要修改的地方。
與 Git 整合
為了確保程式碼庫中所有程式碼都符合規範，我們可以將 Rustfmt 整合到 Git 送出勾點中，在每次送出程式碼之前自動執行 Rustfmt。
處理沖突
在多人協作開發中，可能會出現程式碼沖突的情況。Rustfmt 可以幫助我們自動解決一些程式碼風格導致的沖突。
範例
假設我們有以下一段未經格式化的 Rust 程式碼：
fnmain(){
println!("Hello, world!"); let a=10;
}
使用 Rustfmt 格式化後，程式碼會變成：
fnmain() {
println!("Hello, world!");
let a = 10;
}
可以看到，Rustfmt 幫助我們調整了程式碼的縮排、空格和換行，使程式碼變得更加規範易讀。
總結
Rustfmt 是一個強大且易用的程式碼格式化工具，它可以幫助我們輕松地維護程式碼風格，提高程式碼品質。熟練掌握 Rustfmt 的使用方法，可以讓你的 Rust 程式碼更加優雅，更具可讀性，為你的程式碼增添一份專業與嚴謹。
文章精選
點 擊 關 註 並 掃 碼 添 加 進 交 流 群
領
取
「Rust
語
言
」
學
習
資
料
