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 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 代码会自动找到 ✅

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

"C:\Program Files\wkhtmltopdf\bin\wkhtmltopdf.exe" --version

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

---

3. 总结 📌

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

1. 下载 wkhtmltopdf 安装包

2. 安装到默认路径

3. 重启电脑

4. 重新运行代码

搞定！🎉

---

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