如何在Mac上使用OC或Swift实现壁纸更换？技术方案咨询

嘿，我刚好在 macOS 上做过壁纸更换的需求，给你整理了 Objective-C 和 Swift 两种语言的具体实现步骤，亲测在 macOS 10.14+ 版本上有效：

首先需要导入 AppKit 框架（桌面相关的系统 API 都封装在这里），然后通过 NSWorkspace 单例提供的方法来完成壁纸设置：

#import <AppKit/AppKit.h>

@implementation WallpaperTool

+ (void)setDesktopWallpaperWithLocalPath:(NSString *)imageLocalPath {
    // 将本地图片路径转为 URL 格式
    NSURL *imageURL = [NSURL fileURLWithPath:imageLocalPath];
    // 获取主屏幕，传 nil 会给所有屏幕设置同一张壁纸
    NSScreen *targetScreen = [NSScreen mainScreen];
    
    NSError *error = nil;
    // 调用系统核心方法设置壁纸
    BOOL isSuccess = [[NSWorkspace sharedWorkspace] setDesktopImageURL:imageURL
                                                              forScreen:targetScreen
                                                                options:@{}
                                                                  error:&error];
    
    if (isSuccess) {
        NSLog(@"壁纸设置成功！");
    } else {
        NSLog(@"设置失败：%@", error.localizedDescription);
    }
}

@end

关键细节说明： #

• NSWorkspace.sharedWorkspace 是 macOS 负责系统级操作的核心单例，壁纸更换是它的标准功能之一
• forScreen 参数可以指定特定屏幕，传 nil 会批量给所有连接的屏幕设置壁纸
• options 参数支持配置壁纸缩放方式（比如拉伸、平铺、按比例适配），不需要特殊效果传空字典即可

必做权限配置： #

从 macOS 10.14 开始，App 需要获得桌面文件夹访问权限才能修改壁纸，你必须在 Info.plist 中添加以下键值对：

<key>NSDesktopFolderUsageDescription</key>
<string>需要访问桌面文件夹来设置自定义壁纸</string>

这个描述会在用户首次打开 App 时弹出权限请求，一定要写清楚用途，否则用户大概率会拒绝授权。

Swift 版本的实现逻辑和 Objective-C 完全一致，同样依赖 AppKit 框架，代码更简洁：

import AppKit

class WallpaperTool {
    static func setDesktopWallpaper(imagePath: String) {
        // 兼容 URL 字符串和本地路径两种格式
        guard let imageURL = URL(string: imagePath) ?? URL(fileURLWithPath: imagePath) else {
            print("无效的图片路径，请检查路径格式")
            return
        }
        
        // 传 nil 表示给所有屏幕设置壁纸
        let targetScreen = NSScreen.main
        var error: NSError?
        
        let isSuccess = NSWorkspace.shared.setDesktopImageURL(imageURL,
                                                              for: targetScreen,
                                                              options: [:],
                                                              error: &error)
        
        if isSuccess {
            print("壁纸设置成功！")
        } else {
            print("设置失败：\(error?.localizedDescription ?? "未知错误")")
        }
    }
}

额外实用提示： #

• 如果图片是 App 包内的资源，可以直接用 Bundle 获取 URL，不用手动拼接路径：

  guard let imageURL = Bundle.main.url(forResource: "myWallpaper", withExtension: "png") else {
      print("包内找不到目标图片")
      return
  }
  

• 自定义壁纸缩放方式可以通过 options 参数配置，比如设置按比例适配：

  let scaleOptions: [NSWorkspace.DesktopImageOptionKey: Any] = [
      .imageScaling: NSImageScaling.scaleProportionallyUpOrDown.rawValue
  ]
  

  可选的缩放值还有 .scaleAxesIndependently（拉伸填充屏幕）、.scaleNone（不缩放，超出部分裁剪）等。

通用注意事项： #

不管用哪种语言，都要确保图片路径有效，且图片格式是 macOS 支持的（JPG、PNG、HEIC 等常见格式都没问题）。如果遇到权限拒绝的情况，用户需要手动前往「系统偏好设置 > 安全性与隐私 > 文件和文件夹」给你的 App 开启权限。

内容的提问来源于stack exchange，提问作者Bingrui