gscan2pdf.sourceforge.net

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 阅读器打开确认页数、顺序和清晰度。

常用命令与排查

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

常见卡点

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

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，就完成了从扫描到成稿的基本流程。

gscan2pdf 的命令行选项主要用于指定扫描设备、导入已有文件、控制日志输出和查看版本信息；日常偏好设置则应通过图形界面的 Edit/Preferences 修改，程序会自动把配置写入 ~/.config/gscan2pdfrc。如果你需要连接一台不主动广播的远程扫描仪，或想把已有 PDF、DjVu、图片导入后统一处理，下面的选项和配置位置就是关键。

命令行选项一览

几个使用要点：

• 远程扫描：当扫描仪所在电脑不广播设备时，先用 --device 明确指定设备名，避免程序因拿不到设备列表而找不到扫描仪。
• 导入的定位：官方文档明确说明，导入 PDF 的设计目的是让 gscan2pdf 自己生成的文件能够往返编辑，而不是作为通用 PDF 编辑器使用。导入其他来源的 PDF 可能遇到兼容问题。
• 多页选择：--import 遇到多页文档会弹窗选页，--import-all 则跳过这一步直接全导入。

配置文件的读写规则

gscan2pdf 会在 ~/.config/gscan2pdfrc 创建一个文本资源文件。如果希望配置放在别处，可以设置 $XDG_CONFIG_HOME 环境变量来改变目录。

但官方建议：偏好设置一般应通过 Edit/Preferences 菜单修改，或者在正常使用过程中由程序自动记录。直接手改配置文件不是首选路径，除非你有明确理由需要批量或脚本化处理。

排查故障时的组合用法

遇到扫描或运行异常，从命令行带日志启动：

gscan2pdf --log=file.log

然后检查 file.log。由于指定了日志文件，日志级别默认是 --debug，信息最全；如果只想看错误，可以再加 --error 收窄输出。

安装来源提示

下载入口在 Sourceforge 的项目文件区。Debian 的 sid 已打包最新版本；Ubuntu 系可通过 ppa:jeffreyratcliffe/ppa 保持更新，命令行安装为：

sudo apt update
sudo apt install gscan2pdf

源码则托管在项目的 files 区域。选择哪种方式取决于你的发行版和是否需要最新版本：sid 用户直接用仓库包，Ubuntu 用户加 PPA，其他情况考虑源码。

gscan2pdf 是一个图形界面的扫描工具，用来把纸质文档扫描后直接生成 PDF 或 DjVu 文件。它适合需要批量扫描多页文档、并在保存前挑选页面、调整顺序的桌面用户。核心流程只有两步：先用 File/Scan 扫描一页或多页，再用 File/Save 把选中的页面保存为 PDF。

它解决什么问题

普通扫描仪自带的软件往往只能一页页导出图片，后期还要另找工具合并成 PDF。gscan2pdf 把“扫描—选页—导出”放在同一个界面里完成，扫描多页后可以只保留需要的页面再保存，省去二次处理。

工作原理

• 扫描：通过 SANE 接口调用 scanimage 完成，因此能使用系统已识别的扫描仪。
• PDF 转换：由 PDF::Builder 负责生成 PDF。
• TIFF 导出：由 libtiff 处理，官方说明其对多页 TIFF 更快、内存占用更小。

安装方式

常用命令行选项

除了图形界面，gscan2pdf 也支持从命令行启动并指定行为：

• --device=设备名：直接指定扫描设备，适合扫描仪在远程电脑上、未通过 SANE 广播的情况。
• --import=PDF|DjVu|images：导入指定文件；多页文档会弹窗让你选择需要的页面。
• --import-all=...：导入文件的全部页面，不弹选择窗口。
• --log=文件名 配合 --debug/--info/--warn/--error/--fatal：指定日志文件和级别。未指定日志文件时默认级别为 --error，指定后默认 --debug。
• --help、--version：查看帮助或版本号。

出问题时怎么排查

官方建议从命令行带日志启动：

gscan2pdf --log=file.log

然后查看 file.log 定位错误。配置文件默认位于 ~/.config/gscan2pdfrc，可通过 $XDG_CONFIG_HOME 改变目录；不过一般应通过 Edit/Preferences 菜单修改偏好，正常使用中程序也会自动记录设置。

需要注意的限制

官方明确说明：虽然可以导入 PDF，但这一功能的本意是让 gscan2pdf 自己生成的文件能够往返编辑，并不适合当作通用 PDF 处理工具使用。如果你需要导入外部 PDF 做复杂编辑，它可能不是合适的选择。

当 gscan2pdf 扫描失败、导入异常或启动报错时，最直接的排查方式是从命令行带日志参数启动：gscan2pdf --log=file.log，然后查看生成的 file.log。这条命令适用于 Linux 桌面环境（Debian/Ubuntu 等），前提是程序已安装且能在终端中调用。指定日志文件后，日志级别默认是 --debug，会记录最详细的信息；不指定日志文件时默认只输出 --error 及以上级别。

操作步骤

1. 打开终端，确认程序可调用：

gscan2pdf --version

预期结果是输出版本号（如 2.13.3）并退出。如果提示找不到命令，说明程序未安装或不在 PATH 中，需要先解决安装问题。

2. 带日志文件启动：

gscan2pdf --log=file.log

程序正常启动后，复现你遇到的问题（例如执行 File/Scan 扫描、用 File/Save 保存 PDF、或用 --import 导入文件）。日志会持续写入 file.log。

3. 关闭程序后查看日志：

less file.log

重点看报错前后的上下文，尤其是与 SANE、scanimage、PDF::Builder、libtiff 相关的行，这些是扫描、PDF 转换和 TIFF 导出的实际处理组件。

调整日志级别

日志级别通过独立选项控制，可与 --log 组合使用：

例如只想看警告和错误、避免日志过大：

gscan2pdf --log=file.log --warn

需要排查扫描设备识别问题时，保持默认 --debug 更合适。

常见卡点

• 日志文件为空或不存在：确认启动命令中 --log= 后确实跟了文件名，且当前目录可写；也可写绝对路径如 --log=/tmp/gscan2pdf.log。
• 扫描仪未被发现：如果扫描仪在远程电脑上且不广播自身，可用 --device=device 直接指定设备，绕过 SANE API 的设备列表。日志中会反映设备连接情况。
• 导入 PDF 出错：官方说明导入 PDF 主要用于让 gscan2pdf 自己生成的文件往返编辑，导入其他来源的 PDF 可能出问题，这类情况在日志中通常能看到解析错误。
• 配置相关异常：程序会在 ~/.config/gscan2pdfrc 创建文本资源文件，目录可用 $XDG_CONFIG_HOME 改变。日常偏好应通过 Edit/Preferences 修改，而不是手改该文件；若怀疑配置损坏，可结合日志判断。

拿到日志后，先定位第一条错误出现的位置，再对照当时执行的操作（扫描、保存、导入），通常就能判断问题出在设备连接、文件格式还是导出环节。