使用C++开发macOS Launch Daemon：如何实现文件变更通知？

macOS 提供了两种原生机制来监听文件/目录的变更事件，完全可以替代轮询方案，以下是具体说明：

1. FSEvents 框架 #

这是 macOS 系统级的文件系统变更通知 API，专门用于追踪文件系统的各类操作，适合监听单个文件、目录甚至整个磁盘的变更：

• 提供 C 语言接口，可直接在 C++ 代码中调用
• 通过 FSEventStreamCreate 创建事件流并注册回调函数，当目标文件发生修改、删除、重命名、创建等操作时，系统会主动触发回调逻辑
• 优势：高效低耗，支持批量事件处理，还可配置跨系统重启的变更追踪（如需）
• 注意：若监听的单个文件被删除后重建，需重新注册监听——因为 FSEvents 基于 inode 追踪，重建后的文件 inode 会发生变化

2. kqueue 机制 #

这是 BSD 层级的通用事件通知机制，macOS 完全兼容，适合精确监听单个文件的细粒度变更：

• 通过 kqueue() 创建事件队列，kevent() 注册文件描述符的 EVFILT_VNODE 事件，可指定监听的具体事件类型（如 NOTE_WRITE 内容修改、NOTE_DELETE 文件删除、NOTE_RENAME 文件重命名等）
• 代码更底层，适合对单个文件做精准监控，需注意管理文件描述符的生命周期

简单代码示例（C++ 兼容） #

#include <sys/event.h>
#include <sys/time.h>
#include <fcntl.h>
#include <unistd.h>
#include <iostream>

int main() {
    const char* targetFile = "/path/to/your/target/file";
    int kq = kqueue();
    if (kq == -1) {
        perror("Failed to create kqueue");
        return 1;
    }

    int fd = open(targetFile, O_RDONLY);
    if (fd == -1) {
        perror("Failed to open target file");
        close(kq);
        return 1;
    }

    struct kevent event;
    // 注册监听事件：内容修改、删除、重命名
    EV_SET(&event, fd, EVFILT_VNODE, EV_ADD | EV_ENABLE, NOTE_WRITE | NOTE_DELETE | NOTE_RENAME, 0, NULL);

    struct kevent eventList[1];
    while (true) {
        int numEvents = kevent(kq, NULL, 0, eventList, 1, NULL);
        if (numEvents == -1) {
            perror("kevent error");
            break;
        } else if (numEvents > 0) {
            if (eventList[0].fflags & NOTE_WRITE) {
                std::cout << "File content modified" << std::endl;
            }
            if (eventList[0].fflags & NOTE_DELETE) {
                std::cout << "File deleted" << std::endl;
                break;
            }
            if (eventList[0].fflags & NOTE_RENAME) {
                std::cout << "File renamed" << std::endl;
                break;
            }
        }
    }

    close(fd);
    close(kq);
    return 0;
}

Launch Daemon 适配注意事项 #

• Launch Daemon 以 root 权限运行，需确保目标文件路径的权限配置正确，避免无法打开文件或监听事件
• 若运行在较新版本的 macOS 上，需注意相关隐私权限的申请（如文件系统访问权限）
• 两种机制均支持后台长期运行，不会阻塞主线程，符合 Daemon 的运行需求

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