pdf-to-imageslisted

# PDF 转图片 ## 核心原则 - 首选系统级工具：Ghostscript (`gs`) 或 Poppler `pdftoppm`。 - `pdftoppm` 适合把 PDF 稳定渲染成页面图片，用于论文写作、LaTeX 编译检查和排版验收。 - `gs` 适合已有 Ghostscript 环境、需要 `pngalpha` 或更细控制输出设备的场景。 - 输出图片放到明确的预览目录，不要和源文件目录混在一起。 - 不要长期把输出放在 `/tmp`，避免环境清理后结果丢失。 - 按需设置页码范围，避免不必要地导出整篇 PDF。 - 如果缺依赖需要安装，先确认当前环境是否允许安装；共享环境或集群环境中不要擅自安装系统包。 ## 工具选择 - **快速论文预览。** 优先用 `pdftoppm -png -r 180`。 - **检查字体、图标、表格细节。** 使用 `pdftoppm -png -r 200` 或 `-r 300`。 - **检查图表是否溢出或页面是否截断。** `150-180` DPI 通常足够。 - **需要 alpha PNG 或 Ghostscript 已是默认工具。** 使用 `gs -sDEVICE=pngalpha`。 ## 安装与检查 Poppler / `pdftoppm`： ```bash # Ubuntu / Debian / WSL sudo apt update sudo apt install -y poppler-utils # macOS brew install poppler # conda conda install -c conda-forge poppler # Windows 推荐 conda conda install -c conda-forge poppler ``` 检查： ```bash pdftoppm -v pdfinfo -v ``` Ghostscript： Debian/Ubuntu： ```bash apt-get update DEBIAN_FRONTEND=noninteractive apt-get install -y ghostscript apt-get clean ``` 检查： ```bash gs --version ``` ## 导出单页或页码范围 创建输出目录： ```bash mkdir -p /path/to/project/pdf_pages_png ``` ### 使用 pdftoppm 导出整篇 PDF： ```bash pdftoppm -png -r 180 /path/to/project/main.pdf /path/to/project/pdf_pages_png/page ``` 输出示例： ```text page-1.png page-2.png page-3.png ``` 只导出第 1 页： ```bash pdftoppm -png -r 180 -f 1 -l 1 /path/to/project/main.pdf /path/to/project/pdf_pages_png/page ``` 只导出第 8 页： ```bash pdftoppm -png -r 180 -f 8 -l 8 /path/to/project/main.pdf /path/to/project/pdf_pages_png/page ``` 输出单个文件，不带页码后缀：