做過數據相關功能的人大概都遇過這種情況:後台或運維給了一份 CSV 格式的導出數據,需要 App 把它讀進來展示,或者導入本地數據庫。相比 Excel,CSV 體積小、解析依賴少,是很實用的交換格式。

CSV 是 Comma-Separated Values(逗號分隔值)的縮寫,有時也稱字符分隔值——分隔符不一定是逗號,也可以是分號、製表符等。它以純文本形式存儲表格數據,不同記錄各占一行,同一行中的字段用分隔符隔開。因為格式簡單、通用性強,它常被用作不同程序之間交換數據的中間格式。
在 Xcode 中,CSV 文件屬於體積很小的文本資源,寫入時需要遵守以下約定:
(1)開頭不留空行,以行為單位。
(2)每條記錄占一行,以逗號作為分隔符;列為空也要保留其位置。
(3)可含或不含列名,若含列名則位於文件第一行。
(4)一行數據不跨行,且無空行。
(5)字段中包含逗號時,該字段必須用雙引號括起來。
(6)字段中包含換行符時,該字段必須用雙引號括起來。
(7)字段前後包含空格時,該字段必須用雙引號括起來(a b c ==> "a b c")。
(8)字段中的雙引號用兩個雙引號表示(我說:"abc"。 ==> 我說:""abc""。)
(9)字段中若含雙引號,該字段必須用雙引號括起來
(我說:"abc"。 ==> "我說:"""abc"""。)理解這些規則很重要:如果數據里存在帶逗號的內容(比如地址、金額格式),沒有正確加引號,解析時字段就會錯位。
iOS 中沒有現成的 CSV 解析器,但用 C 標準庫逐行讀取,再按分隔符切分,已經足夠應對大多數場景:
+ (NSArray *)readCSVData {
NSMutableArray *_InfoArray = [[NSMutableArray alloc] init];
NSString *filepath = [[NSBundle mainBundle] pathForResource:@"員工表" ofType:@"csv"];
FILE *fp = fopen([filepath UTF8String], "r");
if (fp == NULL) {
NSLog(@"CSV 文件打開失敗");
return nil;
}
char buf[BUFSIZ];
// 跳過首行列名
fgets(buf, BUFSIZ, fp);
while (!feof(fp)) {
memset(buf, 0, sizeof(buf));
if (fgets(buf, BUFSIZ, fp) == NULL) {
break;
}
// C 字符串轉 NSString
NSString *s = [[NSString alloc] initWithUTF8String:(const char *)buf];
// 去掉行尾的回車與換行
NSString *ss = [s stringByReplacingOccurrencesOfString:@"\r" withString:@""];
ss = [ss stringByReplacingOccurrencesOfString:@"\n" withString:@""];
if (ss.length == 0) {
continue;
}
// 按逗號切分成一行字段
NSArray *a = [ss componentsSeparatedByString:@","];
[_InfoArray addObject:a];
}
fclose(fp);
NSLog(@"%@", _InfoArray);
return _InfoArray;
}幾個實現細節值得注意:
記得 fclose。原樣的示例代碼漏了這一步,長時間運行會造成文件描述符泄漏。
緩存區要清零。fgets 讀到文件末尾時,緩存區中可能殘留上一行的內容,用 memset 或判斷返回值可以避免解析出重複數據。
編碼問題。如果 CSV 是 GBK 編碼(國內 Excel 導出很常見),initWithUTF8String: 會返回 nil,此時需要改用:
NSString *s = [[NSString alloc] initWithData:[NSData dataWithBytes:buf length:strlen(buf)]
encoding:NSCFStringEncoding];上面這段代碼在字段簡單時可用,但一旦遇到「字段內含逗號並用雙引號包裹」的情況就會出錯。如果數據格式不可控,建議按狀態機思路解析:遍歷字符,遇到雙引號切換「是否在引號內」狀態,只有不在引號內的逗號才作為分隔符。或者直接引入成熟的第三方庫(如 CHCSVParser),它們對轉義、多行字段、自定義分隔符都有完整支持。
另外,如果解析後的數據需要頻繁查詢,與其每次讀文件建數組,不如一次性導入 SQLite 或 Core Data,後續按條件檢索會高效得多。
CSV 解析本身不難,難的是把格式約定和邊界情況處理清楚:跳過列名、清理換行符、處理編碼、正確關閉文件、防範帶引號的字段。把這幾點照顧到,一個幾十行的解析方法就能穩定服務於大多數業務場景。