做專案做久了,手上總會累積一批「到處都要用」的工具方法。以下依功能分類整理 30 個實用片段,涵蓋檔案系統、字串處理、時間格式化、圖片處理、網路資訊與資料序列化,建議整理進自己的 Utilities 類別中反覆複用。
一、磁碟空間
// 磁碟總空間
+ (CGFloat)diskOfAllSizeMBytes {
CGFloat size = 0.0;
NSError *error;
NSDictionary *dic = [[NSFileManager defaultManager] attributesOfFileSystemForPath:NSHomeDirectory() error:&error];
if (error) {
#ifdef DEBUG
NSLog(@"error: %@", error.localizedDescription);
#endif
} else {
NSNumber *number = [dic objectForKey:NSFileSystemSize];
size = [number floatValue] / 1024 / 1024;
}
return size;
}
// 磁碟可用空間
+ (CGFloat)diskOfFreeSizeMBytes {
CGFloat size = 0.0;
NSError *error;
NSDictionary *dic = [[NSFileManager defaultManager] attributesOfFileSystemForPath:NSHomeDirectory() error:&error];
if (error) {
#ifdef DEBUG
NSLog(@"error: %@", error.localizedDescription);
#endif
} else {
NSNumber *number = [dic objectForKey:NSFileSystemFreeSize];
size = [number floatValue] / 1024 / 1024;
}
return size;
}
二、檔案與資料夾大小
// 單一檔案大小
+ (long long)fileSizeAtPath:(NSString *)filePath {
NSFileManager *fileManager = [NSFileManager defaultManager];
if (![fileManager fileExistsAtPath:filePath]) return 0;
return [[fileManager attributesOfItemAtPath:filePath error:nil] fileSize];
}
// 資料夾底下所有檔案的總大小
+ (long long)folderSizeAtPath:(NSString *)folderPath {
NSFileManager *fileManager = [NSFileManager defaultManager];
if (![fileManager fileExistsAtPath:folderPath]) return 0;
NSEnumerator *filesEnumerator = [[fileManager subpathsAtPath:folderPath] objectEnumerator];
NSString *fileName;
long long folerSize = 0;
while ((fileName = [filesEnumerator nextObject]) != nil) {
NSString *filePath = [folderPath stringByAppendingPathComponent:fileName];
folerSize += [self fileSizeAtPath:filePath];
}
return folerSize;
}
三、取字串首字母(含中文轉拼音)
+ (NSString *)firstCharacterWithString:(NSString *)string {
NSMutableString *str = [NSMutableString stringWithString:string];
CFStringTransform((CFMutableStringRef)str, NULL, kCFStringTransformMandarinLatin, NO);
CFStringTransform((CFMutableStringRef)str, NULL, kCFStringTransformStripDiacritics, NO);
NSString *pingyin = [str.capitalizedString copy];
return [pingyin substringToIndex:1];
}
四、按首字母分組排序
這是做通訊錄或城市列表時的標準做法,靠 UILocalizedIndexedCollation 完成分區:
+ (NSDictionary *)dictionaryOrderByCharacterWithOriginalArray:(NSArray *)array {
if (array.count == 0) {
return nil;
}
for (id obj in array) {
if (![obj isKindOfClass:[NSString class]]) {
return nil;
}
}
UILocalizedIndexedCollation *indexedCollation = [UILocalizedIndexedCollation currentCollation];
NSMutableArray *objects = [NSMutableArray arrayWithCapacity:indexedCollation.sectionTitles.count];
// 建立 27 個分組(A~Z 加上符號區)
for (int i = 0; i < indexedCollation.sectionTitles.count; i++) {
[objects addObject:[NSMutableArray array]];
}
NSMutableArray *keys = [NSMutableArray arrayWithCapacity:objects.count];
for (int i = 0; i < array.count; i++) {
NSInteger index = [indexedCollation sectionForObject:array[i] collationStringSelector:@selector(uppercaseString)];
[[objects objectAtIndex:index] addObject:array[i]];
}
// 移除空分組
for (int i = 0; i < objects.count; i++) {
NSMutableArray *obj = objects[i];
if (obj.count == 0) {
[objects removeObject:obj];
i--;
}
}
for (NSMutableArray *obj in objects) {
NSString *key = [self firstCharacterWithString:obj[0]];
[keys addObject:key];
}
NSMutableDictionary *dic = [NSMutableDictionary dictionary];
[dic setObject:objects forKey:keys];
return dic;
}
使用方式:
NSArray *arr = @[@"guangzhou", @"shanghai", @"北京", @"henan", @"hainan"]; NSDictionary *dic = [Utilities dictionaryOrderByCharacterWithOriginalArray:arr]; NSLog(@"\n\ndic: %@", dic);

輸出結果
五、時間處理
// 取得當前時間,format 例如 @"yyyy-MM-dd HH:mm:ss"
+ (NSString *)currentDateWithFormat:(NSString *)format {
NSDateFormatter *dateFormatter = [[NSDateFormatter alloc] init];
[dateFormatter setDateFormat:format];
return [dateFormatter stringFromDate:[NSDate date]];
}
計算兩個時間相隔多久,輸出「幾分鐘前/幾小時前/幾天前」:
+ (NSString *)timeIntervalFromLastTime:(NSString *)lastTime lastTimeFormat:(NSString *)format1
ToCurrentTime:(NSString *)currentTime currentTimeFormat:(NSString *)format2 {
NSDateFormatter *dateFormatter1 = [[NSDateFormatter alloc] init];
dateFormatter1.dateFormat = format1;
NSDate *lastDate = [dateFormatter1 dateFromString:lastTime];
NSDateFormatter *dateFormatter2 = [[NSDateFormatter alloc] init];
dateFormatter2.dateFormat = format2;
NSDate *currentDate = [dateFormatter2 dateFromString:currentTime];
return [Utilities timeIntervalFromLastTime:lastDate ToCurrentTime:currentDate];
}
+ (NSString *)timeIntervalFromLastTime:(NSDate *)lastTime ToCurrentTime:(NSDate *)currentTime {
NSTimeZone *timeZone = [NSTimeZone systemTimeZone];
NSDate *lastDate = [lastTime dateByAddingTimeInterval:[timeZone secondsFromGMTForDate:lastTime]];
NSDate *currentDate = [currentTime dateByAddingTimeInterval:[timeZone secondsFromGMTForDate:currentTime]];
NSInteger intevalTime = [currentDate timeIntervalSinceReferenceDate] - [lastDate timeIntervalSinceReferenceDate];
NSInteger minutes = intevalTime / 60;
NSInteger hours = intevalTime / 60 / 60;
NSInteger day = intevalTime / 60 / 60 / 24;
NSInteger month = intevalTime / 60 / 60 / 24 / 30;
NSInteger yers = intevalTime / 60 / 60 / 24 / 365;
if (minutes <= 10) {
return @"剛剛";
} else if (minutes < 60) {
return [NSString stringWithFormat:@"%ld分鐘前", (long)minutes];
} else if (hours < 24) {
return [NSString stringWithFormat:@"%ld小時前", (long)hours];
} else if (day < 30) {
return [NSString stringWithFormat:@"%ld天前", (long)day];
} else if (month < 12) {
NSDateFormatter *df = [[NSDateFormatter alloc] init];
df.dateFormat = @"M月d日";
return [df stringFromDate:lastDate];
} else if (yers >= 1) {
NSDateFormatter *df = [[NSDateFormatter alloc] init];
df.dateFormat = @"yyyy年M月d日";
return [df stringFromDate:lastDate];
}
return @"";
}
NSLog(@"\n\nresult: %@", [Utilities timeIntervalFromLastTime:@"2015年12月8日 15:50"
lastTimeFormat:@"yyyy年MM月dd日 HH:mm"
ToCurrentTime:@"2015/12/08 16:12"
currentTimeFormat:@"yyyy/MM/dd HH:mm"]);

輸出結果
六、手機號與信箱格式驗證
+ (BOOL)valiMobile:(NSString *)mobile {
mobile = [mobile stringByReplacingOccurrencesOfString:@" " withString:@""];
if (mobile.length != 11) {
return NO;
}
NSString *CM_NUM = @"^((13[4-9])|(147)|(15[0-2,7-9])|(178)|(18[2-4,7-8]))\\d{8}|(1705)\\d{7}$";
NSString *CU_NUM = @"^((13[0-2])|(145)|(15[5-6])|(176)|(18[5,6]))\\d{8}|(1709)\\d{7}$";
NSString *CT_NUM = @"^((133)|(153)|(177)|(18[0,1,9]))\\d{8}$";
NSPredicate *pred1 = [NSPredicate predicateWithFormat:@"SELF MATCHES %@", CM_NUM];
NSPredicate *pred2 = [NSPredicate predicateWithFormat:@"SELF MATCHES %@", CU_NUM];
NSPredicate *pred3 = [NSPredicate predicateWithFormat:@"SELF MATCHES %@", CT_NUM];
return [pred1 evaluateWithObject:mobile] || [pred2 evaluateWithObject:mobile] || [pred3 evaluateWithObject:mobile];
}
+ (BOOL)isAvailableEmail:(NSString *)email {
NSString *emailRegex = @"[A-Z0-9a-z._%+-]+@[A-Za-z0-9.-]+\\.[A-Za-z]{2,4}";
NSPredicate *emailTest = [NSPredicate predicateWithFormat:@"SELF MATCHES %@", emailRegex];
return [emailTest evaluateWithObject:email];
}
提醒:號段規則會隨時間變動,這段正則只適合當作格式檢查的第一道關卡,正式驗證仍應交由服務端處理。
七、十六進位顏色轉 UIColor
+ (UIColor *)colorWithHexString:(NSString *)color {
NSString *cString = [[color stringByTrimmingCharactersInSet:[NSCharacterSet whitespaceAndNewlineCharacterSet]] uppercaseString];
if ([cString length] < 6) {
return [UIColor clearColor];
}
if ([cString hasPrefix:@"0X"]) cString = [cString substringFromIndex:2];
if ([cString hasPrefix:@"#"]) cString = [cString substringFromIndex:1];
if ([cString length] != 6) return [UIColor clearColor];
NSRange range;
range.location = 0;
range.length = 2;
NSString *rString = [cString substringWithRange:range];
range.location = 2;
NSString *gString = [cString substringWithRange:range];
range.location = 4;
NSString *bString = [cString substringWithRange:range];
unsigned int r, g, b;
[[NSScanner scannerWithString:rString] scanHexInt:&r];
[[NSScanner scannerWithString:gString] scanHexInt:&g];
[[NSScanner scannerWithString:bString] scanHexInt:&b];
return [UIColor colorWithRed:((float)r / 255.0f) green:((float)g / 255.0f) blue:((float)b / 255.0f) alpha:1.0f];
}
八、圖片濾鏡
// CIPhotoEffectInstant 懷舊 / CIPhotoEffectMono 單色 / CIPhotoEffectNoir 黑白
// CIPhotoEffectFade 褪色 / CIPhotoEffectTonal 色調 / CIPhotoEffectProcess 沖印
// CIPhotoEffectTransfer 歲月 / CIPhotoEffectChrome 鉻黃
// 也可搭配 CISepiaTone、CIGaussianBlur、CIBoxBlur、CIDiscBlur、CIDepthOfField
+ (UIImage *)filterWithOriginalImage:(UIImage *)image filterName:(NSString *)name {
CIContext *context = [CIContext contextWithOptions:nil];
CIImage *inputImage = [[CIImage alloc] initWithImage:image];
CIFilter *filter = [CIFilter filterWithName:name];
[filter setValue:inputImage forKey:kCIInputImageKey];
CIImage *result = [filter valueForKey:kCIOutputImageKey];
CGImageRef cgImage = [context createCGImage:result fromRect:[result extent]];
UIImage *resultImage = [UIImage imageWithCGImage:cgImage];
CGImageRelease(cgImage);
return resultImage;
}
九、圖片模糊
// CIGaussianBlur 高斯模糊 / CIBoxBlur 均值模糊(iOS 9+)
// CIDiscBlur 環形模糊(iOS 9+) / CIMedianFilter 中值去噪,無需 radius(iOS 9+)
// CIMotionBlur 運動模糊(iOS 9+)
+ (UIImage *)blurWithOriginalImage:(UIImage *)image blurName:(NSString *)name radius:(NSInteger)radius {
if (name.length == 0) {
return nil;
}
CIContext *context = [CIContext contextWithOptions:nil];
CIImage *inputImage = [[CIImage alloc] initWithImage:image];
CIFilter *filter = [CIFilter filterWithName:name];
[filter setValue:inputImage forKey:kCIInputImageKey];
if (![name isEqualToString:@"CIMedianFilter"]) {
[filter setValue:@(radius) forKey:@"inputRadius"];
}
CIImage *result = [filter valueForKey:kCIOutputImageKey];
CGImageRef cgImage = [context createCGImage:result fromRect:[result extent]];
UIImage *resultImage = [UIImage imageWithCGImage:cgImage];
CGImageRelease(cgImage);
return resultImage;
}
十、調整飽和度、亮度、對比度
+ (UIImage *)colorControlsWithOriginalImage:(UIImage *)image saturation:(CGFloat)saturation
brightness:(CGFloat)brightness contrast:(CGFloat)contrast {
CIContext *context = [CIContext contextWithOptions:nil];
CIImage *inputImage = [[CIImage alloc] initWithImage:image];
CIFilter *filter = [CIFilter filterWithName:@"CIColorControls"];
[filter setValue:inputImage forKey:kCIInputImageKey];
[filter setValue:@(saturation) forKey:@"inputSaturation"];
[filter setValue:@(brightness) forKey:@"inputBrightness"];
[filter setValue:@(contrast) forKey:@"inputContrast"];
CIImage *result = [filter valueForKey:kCIOutputImageKey];
CGImageRef cgImage = [context createCGImage:result fromRect:[result extent]];
UIImage *resultImage = [UIImage imageWithCGImage:cgImage];
CGImageRelease(cgImage);
return resultImage;
}
十一、毛玻璃效果視圖(iOS 8+)
+ (UIVisualEffectView *)effectViewWithFrame:(CGRect)frame {
UIBlurEffect *effect = [UIBlurEffect effectWithStyle:UIBlurEffectStyleLight];
UIVisualEffectView *effectView = [[UIVisualEffectView alloc] initWithEffect:effect];
effectView.frame = frame;
return effectView;
}
十二、截圖相關
// 全螢幕截圖
+ (UIImage *)shotScreen {
UIWindow *window = [UIApplication sharedApplication].keyWindow;
UIGraphicsBeginImageContext(window.bounds.size);
[window.layer renderInContext:UIGraphicsGetCurrentContext()];
UIImage *image = UIGraphicsGetImageFromCurrentImageContext();
UIGraphicsEndImageContext();
return image;
}
// 截取指定 view
+ (UIImage *)shotWithView:(UIView *)view {
UIGraphicsBeginImageContext(view.bounds.size);
[view.layer renderInContext:UIGraphicsGetCurrentContext()];
UIImage *image = UIGraphicsGetImageFromCurrentImageContext();
UIGraphicsEndImageContext();
return image;
}
// 截取 view 中的某個區域
+ (UIImage *)shotWithView:(UIView *)view scope:(CGRect)scope {
CGImageRef imageRef = CGImageCreateWithImageInRect([self shotWithView:view].CGImage, scope);
UIGraphicsBeginImageContext(scope.size);
CGContextRef context = UIGraphicsGetCurrentContext();
CGRect rect = CGRectMake(0, 0, scope.size.width, scope.size.height);
CGContextTranslateCTM(context, 0, rect.size.height);
CGContextScaleCTM(context, 1.0f, -1.0f);
CGContextDrawImage(context, rect, imageRef);
UIImage *image = UIGraphicsGetImageFromCurrentImageContext();
UIGraphicsEndImageContext();
CGImageRelease(imageRef);
return image;
}
十三、圖片壓縮
// 壓縮到指定尺寸
+ (UIImage *)compressOriginalImage:(UIImage *)image toSize:(CGSize)size {
UIGraphicsBeginImageContext(size);
[image drawInRect:CGRectMake(0, 0, size.width, size.height)];
UIImage *resultImage = UIGraphicsGetImageFromCurrentImageContext();
UIGraphicsEndImageContext();
return resultImage;
}
// 壓縮到指定檔案大小(KB)
+ (NSData *)compressOriginalImage:(UIImage *)image toMaxDataSizeKBytes:(CGFloat)size {
NSData *data = UIImageJPEGRepresentation(image, 1.0);
CGFloat dataKBytes = data.length / 1000.0;
CGFloat maxQuality = 0.9f;
CGFloat lastData = dataKBytes;
while (dataKBytes > size && maxQuality > 0.01f) {
maxQuality = maxQuality - 0.01f;
data = UIImageJPEGRepresentation(image, maxQuality);
dataKBytes = data.length / 1000.0;
if (lastData == dataKBytes) {
break;
}
lastData = dataKBytes;
}
return data;
}
十四、取得設備 IP
需先匯入:
#import <ifaddrs.h> #import <arpa/inet.h>
+ (NSString *)getIPAddress {
NSString *address = @"error";
struct ifaddrs *interfaces = NULL;
struct ifaddrs *temp_addr = NULL;
int success = getifaddrs(&interfaces);
if (success == 0) {
temp_addr = interfaces;
while (temp_addr != NULL) {
if (temp_addr->ifa_addr->sa_family == AF_INET) {
if ([[NSString stringWithUTF8String:temp_addr->ifa_name] isEqualToString:@"en0"]) {
address = [NSString stringWithUTF8String:inet_ntoa(((struct sockaddr_in *)temp_addr->ifa_addr)->sin_addr)];
}
}
temp_addr = temp_addr->ifa_next;
}
}
freeifaddrs(interfaces);
return address;
}
十五、字串判斷系列
// 是否含空格
+ (BOOL)isHaveSpaceInString:(NSString *)string {
return [string rangeOfString:@" "].location != NSNotFound;
}
// 是否包含指定子字串
+ (BOOL)isHaveString:(NSString *)string1 InString:(NSString *)string2 {
return [string2 rangeOfString:string1].location != NSNotFound;
}
// 是否含中文
+ (BOOL)isHaveChineseInString:(NSString *)string {
for (NSInteger i = 0; i < [string length]; i++) {
int a = [string characterAtIndex:i];
if (a > 0x4e00 && a < 0x9fff) {
return YES;
}
}
return NO;
}
// 是否全為數字
+ (BOOL)isAllNum:(NSString *)string {
unichar c;
for (int i = 0; i < string.length; i++) {
c = [string characterAtIndex:i];
if (!isdigit(c)) {
return NO;
}
}
return YES;
}
十六、繪製虛線
/*
lineFrame:虛線 frame
length:短線寬度
spacing:短線間距
color:顏色
*/
+ (UIView *)createDashedLineWithFrame:(CGRect)lineFrame lineLength:(int)length
lineSpacing:(int)spacing lineColor:(UIColor *)color {
UIView *dashedLine = [[UIView alloc] initWithFrame:lineFrame];
dashedLine.backgroundColor = [UIColor clearColor];
CAShapeLayer *shapeLayer = [CAShapeLayer layer];
[shapeLayer setBounds:dashedLine.bounds];
[shapeLayer setPosition:CGPointMake(CGRectGetWidth(dashedLine.frame) / 2, CGRectGetHeight(dashedLine.frame))];
[shapeLayer setFillColor:[UIColor clearColor].CGColor];
[shapeLayer setStrokeColor:color.CGColor];
[shapeLayer setLineWidth:CGRectGetHeight(dashedLine.frame)];
[shapeLayer setLineJoin:kCALineJoinRound];
[shapeLayer setLineDashPattern:[NSArray arrayWithObjects:[NSNumber numberWithInt:length], [NSNumber numberWithInt:spacing], nil]];
CGMutablePathRef path = CGPathCreateMutable();
CGPathMoveToPoint(path, NULL, 0, 0);
CGPathAddLineToPoint(path, NULL, CGRectGetWidth(dashedLine.frame), 0);
[shapeLayer setPath:path];
CGPathRelease(path);
[dashedLine.layer addSublayer:shapeLayer];
return dashedLine;
}
十七、序列化為 JSON 字串
// 字典
+ (NSString *)jsonPrettyStringEncoded:(NSDictionary *)dictionary {
if ([NSJSONSerialization isValidJSONObject:dictionary]) {
NSError *error;
NSData *jsonData = [NSJSONSerialization dataWithJSONObject:dictionary options:NSJSONWritingPrettyPrinted error:&error];
if (!error) {
return [[NSString alloc] initWithData:jsonData encoding:NSUTF8StringEncoding];
}
}
return nil;
}
// 陣列
+ (NSString *)jsonPrettyStringEncoded:(NSArray *)array {
if ([NSJSONSerialization isValidJSONObject:array]) {
NSError *error;
NSData *jsonData = [NSJSONSerialization dataWithJSONObject:array options:NSJSONWritingPrettyPrinted error:&error];
if (!error) {
return [[NSString alloc] initWithData:jsonData encoding:NSUTF8StringEncoding];
}
}
return nil;
}
十八、取得 WiFi 資訊
#import <SystemConfiguration/CaptiveNetwork.h>
- (NSDictionary *)fetchSSIDInfo {
NSArray *ifs = (__bridge_transfer NSArray *)CNCopySupportedInterfaces();
if (!ifs) {
return nil;
}
for (NSString *ifnam in ifs) {
NSDictionary *info = (__bridge_transfer NSDictionary *)CNCopyCurrentNetworkInfo((__bridge CFStringRef)ifnam);
if (info && [info count]) {
return info;
}
}
return nil;
}
十九、廣播位址、本機 IP、子網遮罩
#import <ifaddrs.h>
#import <arpa/inet.h>
- (NSMutableDictionary *)getLocalInfoForCurrentWiFi {
NSMutableDictionary *dict = [NSMutableDictionary dictionary];
struct ifaddrs *interfaces = NULL;
struct ifaddrs *temp_addr = NULL;
if (getifaddrs(&interfaces) == 0) {
temp_addr = interfaces;
while (temp_addr != NULL) {
if (temp_addr->ifa_addr->sa_family == AF_INET) {
if ([[NSString stringWithUTF8String:temp_addr->ifa_name] isEqualToString:@"en0"]) {
NSString *broadcast = [NSString stringWithUTF8String:inet_ntoa(((struct sockaddr_in *)temp_addr->ifa_dstaddr)->sin_addr)];
if (broadcast) [dict setObject:broadcast forKey:@"broadcast"];
NSString *localIp = [NSString stringWithUTF8String:inet_ntoa(((struct sockaddr_in *)temp_addr->ifa_addr)->sin_addr)];
if (localIp) [dict setObject:localIp forKey:@"localIp"];
NSString *netmask = [NSString stringWithUTF8String:inet_ntoa(((struct sockaddr_in *)temp_addr->ifa_netmask)->sin_addr)];
if (netmask) [dict setObject:netmask forKey:@"netmask"];
NSString *interface = [NSString stringWithUTF8String:temp_addr->ifa_name];
if (interface) [dict setObject:interface forKey:@"interface"];
return dict;
}
}
temp_addr = temp_addr->ifa_next;
}
}
freeifaddrs(interfaces);
return dict;
}
最後兩點使用提醒:一是 CNCopyCurrentNetworkInfo 在 iOS 13 之後需要額外的定位權限與 entitlement 才能取到 SSID,直接複用到新專案會拿到 nil;二是所有 Core Graphics / Core Image 相關方法都要注意 CGImageRelease、CGContextRelease、CGColorSpaceRelease 的配對釋放,這類工具方法往往被高頻呼叫,記憶體洩漏不容易察覺。