如何用 gscan2pdf 把扫描件保存成 PDF?

更新时间

gscan2pdf 把“扫描”和“生成 PDF”拆成两步：先用 File/Scan 扫描一页或多页，再在缩略图界面选中要导出的页面，用 File/Save 保存为 PDF。它适合已经装好 SANE 扫描驱动、希望把纸质文档批量转成 PDF 或 DjVu 的桌面用户；如果扫描仪无法被 SANE 识别，或只需要单张图片，这个流程并不合适。

前提条件

  • 系统已安装 gscan2pdf，并且扫描仪能被 SANE 识别。gscan2pdf 通过 scanimage 调用 SANE 完成扫描。
  • 扫描仪已连接并开机；网络扫描仪需在同一网络内，或能通过 --device 指定设备。
  • 有可写入的目标目录，用于保存 PDF 文件。

Debian/Ubuntu 系可先安装：

sudo apt update
sudo apt install gscan2pdf

Ubuntu 用户如需跟进较新版本，可按官方说明添加 ppa:jeffreyratcliffe/ppa 后安装。

操作步骤

1. 扫描页面

打开 gscan2pdf，选择 File/Scan。程序会通过 SANE 获取设备列表并开始扫描。需要多页时，重复扫描或使用送稿器连续进纸，每页会作为一页进入当前文档。

如果扫描仪在远程电脑上、没有广播自己的存在，可以在启动时直接指定设备：

gscan2pdf --device=设备名

设备名可用 scanimage -L 查看。这一步的预期结果是主界面出现已扫描页面的缩略图列表。

2. 选择要导出的页面

在缩略图区域点选需要的页面。多页文档中只导出部分页面时，先确认选中状态再保存；未选中的页面不会进入输出文件。

3. 保存为 PDF

选择 File/Save，在保存对话框中指定文件名和位置，输出格式选 PDF。gscan2pdf 的 PDF 转换由 PDF::Builder 完成。保存完成后，用任意 PDF 阅读器打开确认页数、顺序和清晰度。

常用命令与排查

场景 做法 预期结果
查看可用选项 gscan2pdf --help 输出命令行帮助并退出
查看版本 gscan2pdf --version 显示程序版本并退出
扫描出错需诊断 gscan2pdf --log=file.log 日志写入 file.log，便于定位问题
调整日志级别 --debug、--info、--warn、--error、--fatal 指定日志详细程度；指定日志文件时默认 --debug，否则默认 --error
导入已有文件 --import=PDF|DjVu|images 多页文件会弹出选页窗口
导入全部页面 --import-all=PDF|DjVu|images 直接导入所有页面

配置文件默认位于 ~/.config/gscan2pdfrc，可通过 $XDG_CONFIG_HOME 改变目录。日常偏好建议在 Edit/Preferences 中修改，程序也会在正常使用中自动记录部分设置。

常见卡点

  • 扫描仪列表为空：先确认 SANE 本身能识别设备，再考虑用 --device 手动指定。
  • 保存后页数不对：多半是缩略图里选中的页面与预期不一致，重新选中后再执行 File/Save。
  • 导入 PDF 后效果异常：官方说明导入 PDF 主要用于让 gscan2pdf 自己生成的文件往返编辑，并不适合作为通用 PDF 编辑器使用。
  • 需要排查失败原因：从终端带 --log 启动，复现操作后查看日志文件，比在图形界面里反复重试更容易定位问题。