雖然 iOS 上解析 XML 更常用 NSXMLParser 或第三方庫,但有時候你需要更底層、更可控的 DOM 操作能力——這時 Apple 隨系統附帶的 libxml2 就是個不錯的選擇。它免費、成熟、效能優異,缺點是 API 風格偏 C,需要多寫一點樣板程式。
本文環境:Mac OS 10.8.2、Xcode 4.5.1(後續版本的設定路徑大致相同)
開啟專案的 Build Phases,展開 Link Binary With Libraries,點擊 Add。

在搜尋框輸入 libxml,選擇 libxml2 後按下 Add。

完成後即可在專案中看到 libxml2.dylib。

切換到 Build Settings,往下找到 Search Paths 區段,定位到 Header Search Paths,雙擊開啟編輯視窗,按下 + 並填入:
${SDK_ROOT}/usr/include/libxml2
設定完成後,就能在程式碼中引入 libxml 的標頭檔:
#include <libxml2/libxml/parser.h>
#include <libxml2/libxml/tree.h>
以下範例示範如何用 DOM 介面建立文件、掛上根節點、逐一寫入鍵值對,最後存檔並釋放資源。
void CBLibXMLUtility::saveWithLibXML(map<string, string>& data, const string& fileName)
{
// 1. 建立 XML 文件
xmlDocPtr doc = xmlNewDoc(BAD_CAST "1.0");
xmlNodePtr root = xmlNewNode(NULL, BAD_CAST "CloudBoxRoot");
// 2. 設定根節點
xmlDocSetRootElement(doc, root);
// 3. 逐一寫入子節點
for (map<string, string>::iterator iter = data.begin(); iter != data.end(); iter++) {
cout << "key:" << iter->first << " value:" << iter->second << endl;
xmlNewTextChild(root, NULL,
BAD_CAST (*iter).first.c_str(),
BAD_CAST (*iter).second.c_str());
}
// 4. 存檔
int nRel = xmlSaveFile(fileName.c_str(), doc);
if (nRel != -1) {
cout << "create a xml:" << nRel << " bytes" << endl;
}
// 5. 釋放文件,避免記憶體洩漏
xmlFreeDoc(doc);
}
字串轉換巨集。libxml 使用 xmlChar(通常等同 UTF-8 的 unsigned char),因此所有傳入的字串都要用 BAD_CAST 明確轉型,否則編譯器會發出大量警告。
記得釋放。xmlFreeDoc 只還的文件結構;若你另外用 xmlNewString 配置了節點內容,也要記得對應釋放。搭配 ARC 時尤其容易忽略,因為 C 型別不受 ARC 管理。
錯誤處理。正式專案中建議改用 xmlSaveFormatFileEnc 明確指定編碼,並透過 xmlGetLastError 取得結構化錯誤資訊,而不是只看回傳值。
何時該用 libxml2?如果只是讀取小型 XML,NSXMLParser(SAX 風格)或 NSXMLDocument 更省事。libxml2 的優勢在於完整的 XPath 支援與極佳效能,適合處理大型文件或需要複雜查詢的場景。