設定檔
圖形介面與命令列版共用同一份 RustZ.ini，以及自訂詞典 UserDict.txt。圖形介面會自動存檔，一般不需要手動編輯。
位置
依下列順序決定，先找到的優先：
- 環境變數
RUSTZ_CONFIG_DIR指定的資料夾。 - 執行檔所在的資料夾——只要那裡有
RustZ.ini（可攜模式，跟 ConvertZ 一樣整個資料夾帶著走）。macOS／Linux 上，若該資料夾、設定檔或詞典可被其他使用者寫入就不採用，免得別人放進設定或詞條改變轉換結果。啟用可攜模式時，設定頁與rustz-cli /?會標示出來。 - 系統的使用者設定資料夾：
| 平台 | 位置 |
|---|---|
| macOS | ~/Library/Application Support/RustZ/ |
| Windows | %APPDATA%\RustZ\ |
| Linux | $XDG_CONFIG_HOME/rustz/，預設 ~/.config/rustz/ |
rustz-cli /? 的最後一行會印出目前使用的設定檔路徑。
格式
一般的 INI 格式：[區段]、鍵=值，; 或 # 開頭是註解。布林值用 1／0（也接受 true／false）。缺少的鍵或無法解讀的值使用預設值。
[Data] 區段
與 ConvertZ 的 ConCmd.ini 相同的鍵：
| 鍵 | 預設 | 說明 |
|---|---|---|
Ignore | 見下方 | 加入資料夾或萬用字元展開時略過的檔案類型，逗號分隔 |
HtmlType | *.htm*,*.shtm*,*.xhtm*,*.asp,*.aspx,*.jsp,*.php*,*.pl,*.cgi,*.js | 網頁類型：缺字以 &#NNNN; 表示，並修正 charset 宣告 |
FixHtmlCharset | 1 | 是否修正網頁的 charset 宣告 |
AddBOMtoUTF8 | 0 | UTF-8 輸出是否加 BOM |
ConvertNCR | 0 | 是否把 &#NNNN; 轉成文字（命令列的 /cu） |
Ignore 的預設值：
text
*.exe,*.dll,*.ocx,*.com,*.sys,*.vxd,*.drv,*.so,*.dylib,*.o,*.a,*.lib,*.obj,*.class,*.jar,*.pyc,
*.zip,*.z[0-9][0-9],*.rar,*.r[0-9][0-9],*.7z,*.lha,*.lzh,*.ar?,*.cab,*.tar,*.gz,*.tgz,*.bz2,*.xz,*.zst,*.bin,*.img,*.iso,*.dmg,
*.bmp,*.gif,*.jp*g,*.tif*,*.png,*.webp,*.heic,*.pcx,*.psd,*.ico,*.icns,*.svgz,
*.hlp,*.chm,*.pdf,*.doc,*.doc?,*.xl?,*.xl??,*.pp?,*.pp??,*.od?,*.md?,*.db,*.sqlite,
*.au,*.mid,*.wav,*.mp*,*.m4?,*.aac,*.flac,*.ape,*.og?,*.r*m,*.ra,*.avi,*.asf,*.wm*,*.mov,*.mkv,*.webm,*.swf,
*.ttf,*.otf,*.ttc,*.woff*,*.lnk,*.torrent,*.bak,*.ds_store（實際上是同一行，這裡為了閱讀分行。）萬用字元支援 *、? 與 [abc]、[0-9]、[!a] 字元集，不分大小寫。
[Chinese] 區段
| 鍵 | 預設 | 值 |
|---|---|---|
Engine | opencc | opencc、convertz |
Variant | tw | tw、hk、std |
RegionalPhrases | 1 | 是否轉換臺灣慣用詞 |
ConvertZFix | 1 | ConvertZ 引擎是否套用詞彙修正表 |
UserDict | 1 | 是否套用自訂詞典 |
[GUI] 區段
圖形介面的狀態，命令列版不使用：
| 鍵 | 預設 | 說明 |
|---|---|---|
Theme | system | system、light、dark |
UiScale | 1 | 介面縮放，0.6～2.0 |
KeepRunning | 1 | 關閉視窗後繼續在背景執行 |
Source | auto | 檔案轉換的來源編碼，auto 或編碼代號 |
Target | utf8 | 檔案轉換的目標編碼 |
Face | auto | auto、t、s、d |
OutputToDir | 0 | 1 是另存到資料夾，0 是覆寫原檔 |
OutputDir | （空） | 另存的資料夾 |
Backup | 1 | 覆寫前是否備份成 .bak（已存在就用 .1.bak…） |
Recursive | 1 | 加入資料夾時是否包含子資料夾 |
PreviewKB | 16 | 預覽長度（KB），1～1024 |
LastDir | （空） | 上次選檔案的資料夾 |
範例
ini
[Data]
Ignore=*.exe,*.dll,*.zip,*.png,*.jpg
HtmlType=*.htm*,*.php*
FixHtmlCharset=1
AddBOMtoUTF8=0
ConvertNCR=0
[Chinese]
Engine=opencc
Variant=tw
RegionalPhrases=1
ConvertZFix=1
UserDict=1自訂詞典
UserDict.txt 與 RustZ.ini 放在同一個資料夾。格式見自訂詞典。