Base64 是把二進位資料轉成純文字字串的常見手法,在 HTTP 傳輸、Basic 認証、把圖片塞進 JSON 等場景中幾乎無法迴避。在 iOS 上,你至少有兩條路可走:一是直接使用 iOS 7 之後內建的 NSData 編碼能力,二是引入開源的 GTMBase64 函式庫。
從 iOS 7 開始,Foundation 直接提供了 Base64 相關方法,不必再依賴第三方庫。核心流程是「字串 → 資料 → Base64 字串」,解碼則反向操作:
NSData *originData = [originStr dataUsingEncoding:NSASCIIStringEncoding];
NSString *encodeResult = [originData base64EncodedStringWithOptions:NSDataBase64EncodingEndLineWithLineFeed];
NSLog(@"encodeResult:%@", encodeResult);
NSData *decodeData = [[NSData alloc] initWithBase64EncodedString:encodeResult options:0];
NSString *decodeStr = [[NSString alloc] initWithData:decodeData encoding:NSASCIIStringEncoding];
這裡有兩個細節值得留意。第一,NSDataBase64EncodingEndLineWithLineFeed 會在編碼結果中插入換行,若你的後端不允許換行,改用 0 或 NSDataBase64Encoding64CharacterLineLength 會更合適。第二,編碼時的字元編碼必須與解碼時一致,否則中文等非 ASCII 內容很容易出現亂碼——實務上建議統一採用 UTF-8。
GTMBase64 出自 Google Toolbox for Mac,是 iOS 6 以前最主流的選擇。它的介面簡潔,encode 與 decode 各自對應一個類方法:
/**
* GTM 編碼
*/
- (void)GTMEncodeTest
{
NSString *originStr = @"Man";
NSString *encodeResult = nil;
NSData *originData = [originStr dataUsingEncoding:NSUTF8StringEncoding];
NSData *encodeData = [GTMBase64 encodeData:originData];
encodeResult = [[NSString alloc] initWithData:encodeData encoding:NSUTF8StringEncoding];
NSLog(@"%@", encodeResult);
}
/**
* GTM 解碼
*/
- (void)GTMDecodeTest
{
NSString *encodeStr = @"TWFu";
NSString *decodeResult = nil;
NSData *encodeData = [encodeStr dataUsingEncoding:NSUTF8StringEncoding];
NSData *decodeData = [GTMBase64 decodeData:encodeData];
decodeResult = [[NSString alloc] initWithData:decodeData encoding:NSUTF8StringEncoding];
NSLog(@"%@", decodeResult);
}
以 Man 為例,編碼結果正是 TWFu——三個位元組剛好對應四個 Base64 字元,是最經典的示例。
如果你的部署目標是 iOS 7 以上,直接用系統 API 即可,少一個第三方依賴、少一份維護成本,也少一次版本升級時的相容性風險。若專案仍需支援更舊的系統版本,GTMBase64 依然是可靠的方案。兩者在編碼結果上相容,可以安全混用。
