在 Debian 或 Ubuntu 上安装 gscan2pdf

更新时间

gscan2pdf 是一个把扫描件制作成 PDF 或 DjVu 的图形界面工具，扫描通过 SANE（scanimage）完成，PDF 转换由 PDF::Builder 处理。在 Debian 系系统上安装它，最直接的方式是用 apt 从软件源安装；Ubuntu 用户如果希望跟上最新版本，可以添加官方 PPA。以下步骤适用于 Debian 和 Ubuntu 桌面环境，需要具备 sudo 权限并能访问网络。

方式一：Debian 直接用软件源安装

Debian 的 sid 仓库已经打包了较新的 gscan2pdf 版本，可以直接安装。打开终端执行：

sudo apt update
sudo apt install gscan2pdf

apt update 刷新软件包索引，apt install 完成安装。安装结束后，在应用菜单中搜索 gscan2pdf，或在终端输入 gscan2pdf 启动。

方式二：Ubuntu 通过 PPA 保持更新

Ubuntu 用户如果希望自动跟进最新版本，可以添加项目维护者的 PPA：

sudo apt-add-repository ppa:jeffreyratcliffe/ppa
sudo apt update
sudo apt install gscan2pdf

添加 PPA 后，后续的系统更新会一并带来 gscan2pdf 的新版本。

方式三：用 Synaptic 图形界面安装

不习惯命令行的用户可以在 Synaptic 中操作：先通过菜单 Edit/Reload Package Information 重新加载软件包信息，然后在软件包列表中搜索 gscan2pdf，选中并安装即可。

验证安装与排查问题

安装完成后，用版本参数确认程序可用：

gscan2pdf --version

如果启动或扫描时出现异常，可以从命令行带日志启动，把日志写入文件后查看：

gscan2pdf --log=file.log

日志级别可用 --debug、--info、--warn、--error、--fatal 指定；指定了日志文件时默认使用 --debug，否则默认 --error。

安装后的常见卡点

  • 扫描仪未被识别：gscan2pdf 通过 SANE 获取设备列表。如果扫描仪在另一台未广播存在的远程电脑上，可以用 --device 参数直接指定设备。
  • 配置文件位置：程序会在 ~/.config/gscan2pdfrc 生成文本资源文件，可通过 $XDG_CONFIG_HOME 改变目录；但日常偏好设置建议在 Edit/Preferences 菜单中修改，正常使用过程中也会自动记录。
  • 导入 PDF 的用途有限：虽然支持导入 PDF，但官方说明这一功能主要用于对 gscan2pdf 自己生成的文件做往返处理，不适合当作通用 PDF 编辑器使用。

安装完成后，扫描多页用 File/Scan，再把选中页面通过 File/Save 保存为 PDF，就完成了从扫描到成稿的基本流程。