M3-markconv库找不到wkhtmltopdf问题

M3-markconv库找不到wkhtmltopdf问题

摘要

在使用 markconv 进行 PDF 转换时，你可能会遇到 OSError: No wkhtmltopdf executable found 错误。这表示系统没有安装 wkhtmltopdf 工具，只需要安装它就能解决

1. 问题描述

1.1 主要报错

当你运行 PDF 转换代码时，会看到以下关键报错：

OSError: No wkhtmltopdf executable found: "C:\Program Files\wkhtmltopdf\bin\wkhtmltopdf.exe"

这个错误的意思是：找不到 wkhtmltopdf 可执行文件

markconv 会在默认路径 C:Program Fileswkhtmltopdfbinwkhtmltopdf.exe 查找它。

1.2 错误原因

markconv 的 PDF 转换功能底层依赖 wkhtmltopdf 工具。如果系统没有安装 wkhtmltopdf，就会报这个错误。

1.3 解决方案

解决办法很简单：下载并安装 wkhtmltopdf 就可以！下面我们来看具体步骤

2. 安装 wkhtmltopdf

2.1 下载安装包

1. 访问 wkhtmltopdf 官方下载页面：wkhtmltopdf.org/downloads.h…

2. 根据你的操作系统选择对应的安装包

3. 对于 Windows 用户，推荐下载 64 位版本：github.com/wkhtmltopdf…

2.2 运行安装

1. 双击下载的 .exe 文件

2. 按照提示完成安装

3. 安装到默认路径：C:Program Fileswkhtmltopdf

2.3 验证安装

重要：不需要配置环境变量！ 只要安装到默认路径，Python 代码会自动找到

你可以直接在命令行运行验证：

"C:Program Fileswkhtmltopdfbinwkhtmltopdf.exe" --version

如果输出版本号，说明安装成功

3. 总结

遇到 No wkhtmltopdf executable found 错误不用慌，解决方案很简单：

1. 下载 wkhtmltopdf 安装包

2. 安装到默认路径

3. 重启电脑

4. 重新运行代码

搞定！

最后更新时间：2026-04-10