libvips 安装指南

libvips 是识文君处理PDF和图像的核心依赖库。本指南将详细介绍在不同操作系统上的安装方法。

🖥️ Windows 安装

方式一：自动安装脚本（推荐）

如果您不熟悉Windows环境变量配置，强烈推荐使用自动安装脚本：

下载文件

  1. libvips库: vips-dev-w64-all-8.12.2.zip
  2. 安装脚本: 立即下载 install_libvips.bat | GitHub备用

安装步骤

  1. 准备文件: 将 vips-dev-w64-all-8.12.2.zip 和 install_libvips.bat 放在同一个文件夹中
  2. 运行脚本: 右键点击 install_libvips.bat → "以管理员身份运行"
  3. 等待完成: 脚本会显示详细的安装进度

脚本功能说明

自动安装脚本会执行以下操作：

  • ✅ 自动检测: 查找同目录下的vips zip文件
  • ✅ 智能解压: 自动解压到D盘并重命名文件夹
  • ✅ 环境变量: 自动配置系统PATH环境变量
  • ✅ 安装验证: 测试vips命令是否可用
  • ✅ 错误处理: 提供详细的错误信息和解决建议

安装日志示例

================================
     libvips 自动安装工具
================================

[1/5] 查找 vips-dev-w64-all-*.zip 文件...
✅ 找到文件: vips-dev-w64-all-8.12.2.zip

[2/5] 删除已存在的目录...
[3/5] 创建临时解压目录...
[4/5] 正在解压文件...
✅ 解压完成！

[5/5] 正在移动文件到目标位置...
    实际解压的文件夹名: vips-dev-8.12
    移动到: D:\vips-dev-8.12

[6/6] 正在配置环境变量...
✅ 环境变量配置完成！

================================
验证安装...
✅ 安装成功！
    安装路径: D:\vips-dev-8.12
    可执行文件: D:\vips-dev-8.12\bin\vips.exe

🔧 测试安装：
✅ 命令行测试成功！

安装完成！按任意键退出...

方式二：手动安装

如果您熟悉Windows系统配置，可以选择手动安装：

步骤1：下载和解压

  1. 下载 vips-dev-w64-all-8.12.2.zip
  2. 解压到D盘根目录，确保路径为 D:\vips-dev-8.12\

步骤2：配置环境变量

  1. 打开系统属性:

    • 右键"此电脑" → "属性"
    • 点击"高级系统设置"

  2. 编辑环境变量:

    • 点击"环境变量"按钮
    • 在"系统变量"区域找到"Path"
    • 点击"编辑"

  3. 添加路径:

    • 点击"新建"
    • 输入: D:\vips-dev-8.12\bin
    • 点击"确定"保存

  4. 应用设置:

    • 依次点击"确定"关闭所有对话框

步骤3：验证安装

  1. 重启命令提示符
  2. 测试命令:
    vips --version
  3. 预期输出:
    vips-8.12.2-Mon Jan 10 15:16:28 UTC 2022

🍎 macOS 安装

macOS用户可以使用Homebrew轻松安装：

# 安装Homebrew（如果尚未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装libvips
brew install vips

# 验证安装
vips --version

🐧 Linux 安装

Ubuntu/Debian

sudo apt-get update
sudo apt-get install libvips-dev

# 验证安装
vips --version

CentOS/RHEL/Fedora

# CentOS/RHEL
sudo yum install vips-devel

# Fedora
sudo dnf install vips-devel

# 验证安装
vips --version

🔧 故障排除

Windows常见问题

问题1：脚本运行失败

症状: 双击脚本无反应或闪退 解决: 必须"以管理员身份运行"脚本

问题2：环境变量未生效

症状: 命令提示符中输入vips --version提示"不是内部或外部命令" 解决:

  1. 重新打开命令提示符
  2. 检查PATH中是否包含 D:\vips-dev-8.12\bin
  3. 重新运行安装脚本

问题3：权限不足

症状: 脚本提示"需要管理员权限" 解决: 右键脚本选择"以管理员身份运行"

通用问题

验证安装是否成功

在任意终端/命令提示符中运行：

vips --version

如果显示版本信息，说明安装成功。

识文君仍提示依赖缺失

  1. 确认vips命令可用
  2. 重启识文君应用
  3. 检查应用日志中的具体错误信息

📞 获取帮助

如果遇到安装问题，可以：

  1. 查看日志: 安装脚本会显示详细的错误信息
  2. 检查路径: 确认文件解压到正确位置
  3. 重新安装: 删除旧文件后重新运行脚本
  4. 联系支持: 发送邮件至 hzruo@outlook.com

提示

建议使用自动安装脚本，它会处理大部分常见问题并提供详细的安装反馈。