如何讀懂和編輯 Plist 檔案

所謂讀懂和編輯 plist 檔案,就是在和蘋果的設定格式打交道——那些安靜地驅動著 macOS 與 iOS 的鍵值檔案。每個 App 都帶一個 Info.plist,每個定時背景任務都是一個 launchd plist,每個 provisioning profile 和每個 .mobileconfig 裝置描述檔,底下都是 plist。格式本身很簡單:字典、陣列、字串、數字、布林值、日期和二進位資料,可以任意巢狀。麻煩出在同一個格式有兩種外衣——人類可讀的 XML,和在文字編輯器裡看起來像亂碼的緊湊二進位——還出在一個錯誤的類型就能悄悄讓任務永遠不執行。你可以把任何 plist 貼進Plist 工作台,在瀏覽器裡讀取、編輯、轉換和校驗——什麼都不上傳——但本文教你自己讀這些檔案,這樣那棵樹對你來說就永遠不是黑盒。

什麼是 plist——以及它穿的四套衣服

Property list(屬性列表,簡稱 plist)是蘋果儲存結構化設定的方式:一棵由字典和陣列組成的樹,葉子是字串、整數、實數、布林值、日期和二進位資料塊。它和 JSON 物件或 YAML 檔案是同一個思路,只不過在蘋果平台上出現得更早,而且已經 baked into 作業系統——macOS 和 iOS 無時無刻不在讀 plist,從來不用問你。如果你曾經好奇某個 App 把 bundle ID、版本號或它申請的權限存在哪裡,答案就是 plist,而且它一直明擺在那裡。

同一個格式出現在四個看似無關的地方,訣竅一旦點破就很清楚。每個 App 包裡面,Info.plist 聲明 App 的身分:bundle ID、版本號、支援的文件類型、申請的權限。在 ~/Library/LaunchAgents 和 /Library/LaunchDaemons 裡,launchd 任務檔案描述背景任務——執行什麼、什麼時候執行、在什麼條件下執行。一個 .mobileprovision 描述檔是一個 plist(外面裹著一層 CMS 簽名),列出 App 可以用哪些裝置和權限。而一個 .mobileconfig 裝置描述檔也是一個 plist,描述要裝到裝置上的 Wi-Fi、VPN、憑證和限制。同一個格式,四套衣服——學會讀一種,四種都會讀。

二進位 vs XML:bplist00 魔數,以及為什麼絕不能手工編輯二進位 plist

Plist 有兩種序列化形式。XML 形式以 <?xml 和 <plist version="1.0"> 開頭,在任何文字編輯器裡都能讀:鍵在 <key> 標籤裡,值在 <string>、<integer>、<true/>、<array> 和 <dict> 裡。二進位形式是一種緊湊編碼,以 8 個魔數字節 bplist00 開頭,後面跟著物件表、偏移表和記錄所有內容位置的尾部。二進位 plist 更小、系統載入更快,所以一台真 Mac 上的大多數 plist 都是二進位的——這也是在文字編輯器裡打開它只會看到亂碼的原因。

怎麼分辨手裡的是哪一種:看檔案開頭的位元組。bplist00 是二進位;<?xml 或 <plist 是 XML。而下面這條規則能救你的檔案:永遠不要手工編輯二進位位元組。二進位 plist 是一張偏移量的網——把一個字串改長一點,它後面的所有偏移量就全錯了,尾部再也對不上表,檔案就此損壞,儘管你改的那段文字看起來沒問題。安全路徑永遠是同一條:把二進位轉成 XML、編輯 XML、再轉回二進位,然後重新解析一次結果,證明它仍然有效。在 Mac 上就是 plutil -convert xml1 和 plutil -convert binary1;在瀏覽器裡,Plist 工作台替你做同樣的往返轉換。

手工讀一個 launchd 任務:Label、ProgramArguments、RunAtLoad、KeepAlive、StartCalendarInterval

一個 launchd 任務就是一個詞彙量很小的 plist,認得那幾個鍵,一分鐘就能讀完。Label 是任務的唯一名字,按慣例是反向網域名稱,比如 com.example.backup——launchd 靠它識別任務,兩個同名任務會衝突。ProgramArguments 是一個字串陣列:要執行的程式,後面跟它的參數,所以 ["/usr/local/bin/backup.sh"] 就是不帶參數執行那個腳本。RunAtLoad 是布林值:true 表示任務一載入就執行一次。KeepAlive 同樣是布林值:表示它一退出就重啟。這四個鍵描述了你會遇到的大多數任務。

排程用的鍵是 StartCalendarInterval,一個由日曆欄位組成的字典——Minute、Hour、Day、Weekday、Month,哪個都可以省略,所以 {Hour: 3, Minute: 30} 就是每天 03:30 執行。它的簡單版 StartInterval 是一個整數:每 N 秒執行一次。下面程式碼區塊裡的範例就是一個這種形態的完整可用任務——Label、ProgramArguments、RunAtLoad、StartCalendarInterval——值得逐行讀一遍,因為你遇到的每個 launchd 任務都是它的變體:同樣的鍵,不同的值,偶爾多個 WorkingDirectory 或 StandardOutPath 之類的附加項,說明輸出寫到哪裡。

弄壞東西的鍵:類型錯誤、容器用錯、數字越界

大多數壞掉的 launchd 任務不是被拼寫錯誤弄壞的,而是被類型弄壞的。launchd 要求 ProgramArguments 是一個字串陣列;給它一個單獨的字串,任務就載入失敗,而報錯訊息少得可憐。KeepAlive、RunAtLoad 和 Disabled 必須是布林值,而不是拼成 "true" 和 "false" 的字串——一個拼出 "true" 的字串不是 true,launchd 會把它當作類型錯誤。StartInterval 必須是正整數;0 或負數毫無意義,會被拒絕。這些錯誤文字編輯器永遠發現不了,因為 XML 本身格式完美——錯的只是含義。

第二類損壞是數字超出範圍。在 StartCalendarInterval 裡,Minute 必須是 0–59,Hour 0–23,Weekday 0–7,Day 1–31,Month 1–12——Hour 寫成 25 不是「明天凌晨 1 點」,而是這個任務永遠不執行,而且 launchd 未必告訴你為什麼。第三類是不能同時出現的成對鍵:Program 和 ProgramArguments 是兩種說法說同一件事,同時給就是含糊不清——選一個,優先用蘋果文件裡的 ProgramArguments。一個能檢查類型、範圍和這類衝突的校驗器,能在任務到達 launchd 之前就抓住這三類錯誤,而這正是工作台的 launchd 檢查所做的事。

安全編輯:備份、轉換、編輯、轉回去、驗證

安全的 plist 編輯是一套五步儀式,而且順序很重要。第一步,備份原始檔案——動手之前先把它複製到別處,因為 launchd 任務或裝置描述檔沒有復原按鈕。第二步,如果檔案是二進位的,把它轉成 XML;絕不要直接編輯二進位位元組,原因見上文。第三步,在 XML 裡做編輯:改一個值、重新命名一個鍵、加一個陣列項——並且保持類型正確,字串待在字串的位置,陣列待在陣列的位置。第四步,如果原來是二進位的,再轉回二進位,讓檔案以系統期望的形態回去。

第五步,也是最常被跳過的一步:重新解析驗證。對結果跑一遍 plutil -lint,或者貼進工作台看它乾淨地解析出來——如果檔案能重新解析,而且解析出來的值就是你想要的值,編輯就成功了。如果解析失敗,第一步的備份還在,而且磁碟上的檔案從一開始就沒被編輯器碰過:工作台在記憶體裡的副本上編輯,只有當你明確匯出時才會寫檔案。最後這一點正是瀏覽器內編輯的全部意義——在你確認新版本沒問題之前,原始檔案保持完好。

Plist 工作台能做什麼——以及不能做什麼

工作台能解析兩種形態的 plist——二進位 bplist00 和 XML——解析成一棵可以展開的樹,你可以按路徑搜尋(比如 StartCalendarInterval.Hour),還可以就地編輯:改一個純量、重新命名鍵、增刪鍵和陣列項,以及在含義明確時改一個值的類型。每種匯出——XML plist、二進位 plist、JSON,或展平後的路徑表 CSV——反映的都是編輯後的模型,而不是原始檔案。當 plist 看起來像個 launchd 任務時,它會跑上一節說的語義檢查:Label 在不在、Program 和 ProgramArguments 是不是恰好出現一個、日曆欄位在不在範圍內、布林值是不是真的布林值。全部工作就是這些,而且全在你的瀏覽器裡發生:檔案永遠不離開你的裝置。

它不能做什麼,同樣重要。它不安裝任何東西——不會把你的任務載入進 launchd,不會在裝置上安裝 .mobileconfig,也不會給 App 做 provisioning;那些是系統動作,一個網頁不該替你執行。它不對照蘋果校驗程式碼簽名或 provisioning 權限,所以一個編輯過的 .mobileprovision 可能解析得完美無缺,卻因為簽名對不上而被系統拒絕——能解析不等於可信任。它也不執行 plist 裡的任何東西:一個指向腳本的 launchd 任務,在 launchd 執行它之前只是資料,工作台也只把它當作資料對待。安卓的對應物——APK 裡的清單——請用APK 分析器;launchd 在 Linux 上的表親 systemd unit,請用systemd 單元稽核器。

自己試試:一個可以讀、可以轉換、可以驗證的 launchd 任務

# A minimal launchd job, as XML — the form you can read and edit safely
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>com.example.backup</string>
    <key>ProgramArguments</key>
    <array>
        <string>/usr/local/bin/backup.sh</string>
    </array>
    <key>RunAtLoad</key>
    <true/>
    <key>StartCalendarInterval</key>
    <dict>
        <key>Hour</key>
        <integer>3</integer>
        <key>Minute</key>
        <integer>30</integer>
    </dict>
</dict>
</plist>

# Convert between the two forms on a Mac — never edit the binary bytes:
$ plutil -convert xml1 job.plist     # binary -> readable XML
$ plutil -convert binary1 job.plist  # XML -> compact binary, for shipping
$ plutil -lint job.plist             # re-parse to verify it is still valid

來源

常見問題

我在文字編輯器裡打開一個 .plist,看到的全是亂碼——檔案壞了嗎?

幾乎肯定沒有:它是一個二進位 plist。打開檔案看開頭的位元組——如果讀出來是 bplist00,這個檔案就是蘋果的緊湊二進位格式,是給機器讀的,不是給人看的。先把它轉成 XML(Mac 上用 plutil -convert xml1,或者貼進 Plist 工作台,它會偵測魔數並替你轉換),你就會看到同樣的鍵和值以可讀形式出現。只有當檔案既不是 bplist00 開頭、也不是

.mobileprovision 或 .mobileconfig 也能這樣編輯嗎?

格式是一樣的——兩者底下都是 plist——但後果不同。.mobileconfig 就是一個 plain plist,編輯起來很乾淨。.mobileprovision 是一個包在 CMS 簽名裡的 plist,所以改動裡面的任何一個值都會破壞簽名,蘋果的工具會拒絕編輯過的描述檔,儘管它仍然能解析。工作台能解析和編輯兩者,但它不對照蘋果校驗簽名,所以一個解析出來的 .mobileprovision 只能算「可讀」,不能算「仍然有效」。拿不準的時候,從蘋果入口網站重新產生描述檔,別去編輯它。

為什麼 launchd 不理我的任務,或者拒絕載入它?

按這個順序排查常見嫌疑。第一,Label 在不在、是不是字串、是不是唯一?第二,ProgramArguments 是不是字串陣列——那裡放一個單獨的字串是最常見的失敗原因。第三,StartCalendarInterval 的欄位在不在範圍內——Hour 寫成 25 意味著任務永遠不執行。第四,對檔案跑 plutil -lint 排查畸形 XML,並確認檔案放在正確的目錄裡(你自己的使用者用 ~/Library/LaunchAgents,系統用 /Library/LaunchDaemons),擁有者正確。如果還是載入不了,貼進 Plist 工作台——它的 launchd 檢查會把這些問題逐個標出來,並給出 plain English 的修復方法。