Config File（設定檔）

你會在什麼時候遇到它

你第一次幫 AI 工具做設定，改的幾乎都是某個設定檔而不是圖形介面：settings.json、放金鑰的 .env、MCP 服務的登記檔。教學說「把這段貼進設定檔」，你不知道那個檔案在哪、長什麼格式、改壞了怎麼辦，就會卡在這句話。看懂設定檔，也等於學會「把設定寫一次就永遠生效」，不必每次重打旗標。

最小範例

# 每個設定都是從某個檔案讀來的 —— 這個指令把來源標在每一條前面：
git config --list --show-origin

輸出的每一行開頭就是那條設定來自哪個檔案 —— 改設定本質上就是改那些檔案。幾乎每支程式都有一個這樣的位置，文件會告訴你它在哪。

最常搞錯的地方

• 程式還開著就改設定檔，然後奇怪為什麼沒生效。很多程式只在啟動時讀設定，有些甚至會在結束時把檔案寫回去、蓋掉你的修改。改完照文件重啟。
• 改完 JSON／YAML 設定不驗證格式。少一個逗號、混進一個 Tab，錯誤常常只有一句「設定載入失敗」，不告訴你第幾行。JSON 先丟給 python3 -m json.tool，YAML 先檢查縮排。