Barotrauma 新手模組開發者必備：VS Code 自動格式化設定指南（支援 Lua / XML / JSON）

前言

在開發 Barotrauma 模組時，維持 Lua 腳本與 XML 配置整齊不易。特別是新手，很容易在複雜的縮排與標籤中迷失。這篇教學將教你如何設定 VS Code，在每次儲存檔案時自動整理 Lua / XML / JSON 結構，讓你專注邏輯，不再煩惱排版。

跟著做

步驟一：安裝 VS Code 及所需插件

1. 安裝 Visual Studio Code
2. 在擴充套件市集中安裝：
3. • Stylua（Lua 格式化器）
   • XML Tools（XML 格式化器）

步驟二：設定 settings.json

在 VS Code 中按下 Ctrl + Shift + P，輸入Preferences: Open User Settings (JSON)並打開後，請將以下內容加入你的 settings.json中：

//  儲存時自動格式化（所有語言通用）
"editor.formatOnSave": true,

//  Lua 格式化：使用 stylua 套件
"[lua]": {
  "editor.defaultFormatter": "JohnnyMorganz.stylua",
  "editor.formatOnSave": true
},

//  XML 格式化：使用 XML Tools 插件
"[xml]": {
  "editor.defaultFormatter": "DotJoshJohnson.xml", // 可換成你使用的 XML 插件名稱
  "editor.formatOnSave": true
},

//  JSON 格式化：使用 VS Code 內建格式化器
"[json]": {
  "editor.defaultFormatter": "vscode.json-language-features",
  "editor.insertSpaces": true
},

//  XML Tools 進階設定（可選）
"xmlTools.splitXmlnsOnFormat": true, // 每個 xmlns 換行（增加可讀性）
"xmlTools.removeCommentsOnMinify": false, // 最小化時保留註解
"xmlTools.enforcePrettySelfClosingTagOnFormat": true // 自閉標籤前加入空格（美觀）

步驟三：開始開發模組

1. 開啟專案資料夾：File > Open Folder...，選擇你的模組資料夾（範例：Barotrauma\LocalMods\MyMod）
2. 撰寫 Lua 或 XML 檔案
3. 每次儲存時，代碼會自動排版！

結語

這套設定將大幅提升你在 Barotrauma 模組開發時的代碼整潔度，避免格式混亂導致的錯誤。寫 Lua、配置 XML、調整 JSON，不再需要手動調整排版，是新手開發者必備的 VS Code 工作流利器。