M3-markconv库找不到wkhtmltopdf问题

M3-markconv库找不到wkhtmltopdf问题

📝 摘要

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

1. 问题描述 📚

1.1 主要报错

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

1
2OSError: No wkhtmltopdf executable found: "C:\\Program Files\\wkhtmltopdf\\bin\\wkhtmltopdf.exe"
3
4

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

markconv 会在默认路径 C:\Program Files\wkhtmltopdf\bin\wkhtmltopdf.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 Files\wkhtmltopdf\

2.3 验证安装

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

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

1
2"C:\Program Files\wkhtmltopdf\bin\wkhtmltopdf.exe" --version
3
4

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

3. 总结 📌

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

1. 下载 wkhtmltopdf 安装包
2. 安装到默认路径
3. 重启电脑
4. 重新运行代码

搞定！🎉

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

《M3-markconv库找不到wkhtmltopdf问题》 是转载文章，点击查看原文。