RWTS-PDFwriter 上手手册：让 macOS 虚拟打印机把“打印“变成“保存 PDF“

RWTS-PDFwriter 上手手册：让 macOS 虚拟打印机把"打印"变成"保存 PDF"

【免费下载链接】RWTS-PDFwriterAn OSX print to pdf-file printer driver项目地址: https://gitcode.com/gh_mirrors/rw/RWTS-PDFwriter

天天要把网页、报表、合同存成 PDF 的朋友，多半都经历过这样的场景：挨个打开"打印"对话框，手动改文件名、选保存位置，几十个文件处理完手腕都酸了。RWTS-PDFwriter 就是来解决这个问题的——它是一台开源的macOS 虚拟打印机，装上之后，任何应用里按 ⌘P、选它、点打印，PDF 就会自动按规则命名、自动落进你指定的文件夹，批量归档从此变成一条安静运转的流水线。它兼容 macOS 11.0 及以上系统，同时支持 Intel 与 Apple Silicon 芯片，安装包是通用二进制，装完即用。

开场：被"另存为 PDF"磨过耐心的人，都懂这条流水线的价值

先别急着装，想清楚它和系统自带导出有什么区别。自带的"存储为 PDF"是一次性的手动操作，每次都要点对话框；而虚拟打印机的思路是"选打印机 → 打印 → 收工"。一次配置，之后所有应用共用同一套规则，配合命令行还能批量处理。对每天要归档几十份文档的人来说，省下的不只是几秒钟，而是一整套重复劳动。

先搞懂原理：一个叫 pdfwriter 的 CUPS 后端在做什么

这台打印机没有实体，它其实是一个标准 CUPS 后端程序，核心代码集中在 pdfwriter/main.swift 这一个文件里，全部逻辑加起来不过百余行。收到打印任务后，它做三件事：

1. 验货：先读数据流前 4 个字节，确认是%PDF开头，否则直接报错取消任务；
2. 落盘：把数据流完整写入.pdf文件；
3. 善后：用O_CREAT|O_EXCL原子方式创建文件，从根上杜绝两个并发任务互相覆盖。

它的血统可以追溯到 CUPS-PDF 和 Lisanet PDFWriter，作者 Rod Yager 用 Swift 重写了后端，才让它能在现代 macOS 上跑得又快又稳。这段代码值得所有想了解"打印系统到底怎么工作"的人读一遍，注释写得很清楚。

安装只要三步：装包、选目录、打出第一份 PDF

第一步，从 release 页面下载RWTS-PDFwriter.pkg安装包，像装普通软件一样双击安装，期间会要求输入管理员密码。

第二步，安装器会自动打开PDFWriter Utility小工具。点击Create PDF Destination Folder按钮，在弹出面板里选一个文件夹作为 PDF 的默认归宿。工具会在后台把/private/var/spool/pdfwriter/你的用户名这个目录做成符号链接，指向你选的位置——打印产生的文件就会全部出现在这里。

第三步，创建完目标文件夹后退出 Utility，安装即告完成。之后打开"系统设置 > 打印机与扫描仪"，就能看到名为PDFwriter的虚拟打印机静静躺在列表里。

小提示：如果 Utility 提示需要"先打印一次文档来完成系统初始化"，别慌。随便找一份文档用 PDFwriter 打印一次，让 CUPS 把用户目录建好，再回来点按钮即可。

日常用法：从 ⌘P 到命令行，把归档变成习惯

配置好之后，用法朴素得惊人：任何应用里 ⌘P，选择 PDFwriter，点打印，完事。文件会自动出现在你选的文件夹里，标题就是打印任务的文档名。

真正拉开差距的是命令行。批量把一堆文本转成 PDF，一行循环搞定：

for file in *.txt; do # 用 -T 参数指定输出文件名，否则会存成 Untitled cat "$file" | lpr -P PDFwriter -T "$(basename "$file" .txt)" done

想把打印队列集成进自动化流程也一样顺手，lpr -P PDFwriter 文件路径可以被任何脚本调用。配合定时任务或文件夹监控，一个"扔进去就自动出 PDF"的文件夹就搭起来了。

输出目录与命名规则：文件到底去了哪里

所有输出默认落在/var/spool/pdfwriter/你的用户名/下，命名遵循一套清晰规则：

这套命名策略看着简单，实际把"文件满天飞、同名互相覆盖"两个老大难问题都按住了。

多用户与权限隔离：为什么大家的 PDF 不会互相串门

macOS 是典型的多用户系统，打印驱动也得考虑多人共用的情况。RWTS-PDFwriter 的做法是给每个用户建独立目录，并做严格的权限区分：

目录归属对应用户的 UID，后端进程还会把组切换到_lp，保证打印服务能正常读写。其他用户想设置自己的输出位置，可以从打印机设置里的Options & Supplies打开 Utility 标签页，各自创建目标文件夹，互不干扰。

进阶：自己编译安装包，甚至改两行 Swift

项目以 GPL v2 协议开源，想改点行为、加个水印，完全可以从源码构建自己的版本。先克隆仓库：

git clone https://gitcode.com/gh_mirrors/rw/RWTS-PDFwriter

然后进入项目目录，确认已安装 Xcode 命令行工具，执行：

./build/buildscript.sh

脚本会依次完成xcodebuild编译、用ppdc从 build/PDFWriter.drv 生成 PPD 驱动描述文件，再打包成RWTS-PDFwriter.pkg。如果想让安装包通过 Apple 签名和公证，需要 Developer ID Installer 证书，并在脚本后追加-n "你的钥匙串配置文件"参数。源码里的 pdfwriter/main.swift 是核心后端，PDFWriter Utility/ContentView.swift 是那个小工具，改动都能直接生效。

卸载与避坑速查：给折腾过的人一份清单

想彻底移除也很简单：打开 PDFWriter Utility，点Reveal Uninstall script，运行显示的脚本并输入管理员密码。脚本会删掉驱动目录、CUPS 后端注册和 PPD 文件，但你打印生成的 PDF 一个都不会动。

最后附上三个常见翻车点的排查方向：

1. 打印机列表里看不到 PDFwriter——检查/Library/Printers/RWTS/PDFwriter/目录是否完整，必要时重启 CUPS 服务；
2. Utility 报错说"无法完成保存"——多数情况是目标位置已存在符号链接，工具明确不支持替换已有位置，换一个全新文件夹即可；
3. 输出的是Untitled.pdf——使用命令行管道打印时忘了加-T指定标题，补上就好。

从"手动保存"到"打印即归档"，RWTS-PDFwriter 用一套简洁到极致的机制，把 macOS 上最频繁的文档操作变成了一键动作。它是开源软件，也欢迎任何人继续改进它——说不定下一个顺手的功能，就出自你的手笔。

【免费下载链接】RWTS-PDFwriterAn OSX print to pdf-file printer driver项目地址: https://gitcode.com/gh_mirrors/rw/RWTS-PDFwriter