简体中文
Englishgscan2pdf 命令行选项与配置要点
更新时间
gscan2pdf 的命令行选项主要用于指定扫描设备、导入已有文件、控制日志输出和查看版本信息；日常偏好设置则应通过图形界面的 Edit/Preferences 修改，程序会自动把配置写入 ~/.config/gscan2pdfrc。如果你需要连接一台不主动广播的远程扫描仪，或想把已有 PDF、DjVu、图片导入后统一处理，下面的选项和配置位置就是关键。
命令行选项一览
| 选项 | 作用 | 适用场景 |
|---|---|---|
--device=设备名 |
直接指定扫描设备，不再通过 SANE API 获取设备列表 | 扫描仪在远程电脑上且未广播其存在 |
--import=PDF|DjVu|images |
导入指定文件；多页文档会弹出窗口让你选择需要的页面 | 只取多页 PDF 中的部分页 |
--import-all=PDF|DjVu|images |
导入指定文件的全部页面 | 整份文档都要处理 |
--log=日志文件 |
把日志消息写入指定文件 | 排查扫描或运行故障 |
--debug / --info / --warn / --error / --fatal |
设定日志级别；指定了日志文件时默认 --debug，否则默认 --error |
需要更详细或更精简的日志 |
--help |
显示帮助页并退出 | 快速查选项 |
--version |
显示程序版本并退出 | 确认版本 |
几个使用要点：
- 远程扫描：当扫描仪所在电脑不广播设备时，先用
--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，其他情况考虑源码。