VS Code中Markdown转PDF失败问题求助

阿华AIGC实验室

2026-5-9

解决Markdown PDF扩展转换PDF失败（缺少libXcursor.so.1）的问题

我之前碰到过一模一样的情况——明明用的是Windows系统，转PDF时却报Linux库缺失的错，后来才发现是VS Code背后连接了Linux环境（要么是WSL，要么是远程服务器），扩展里的Chromium在那边运行时缺了依赖。给你几个实用的解决思路：

1. 安装Linux环境下的Chromium依赖库

从报错信息看，缺失的libXcursor.so.1是Linux X11图形系统的库，直接在Linux终端运行下面的命令就能一次性安装Chromium需要的所有常用依赖：

sudo apt-get update && sudo apt-get install -y libx11-xcb1 libxcb-dri3-0 libdrm2 libxcomposite1 libxdamage1 libxfixes3 libxrandr2 libxcursor1 libxss1 libxtst6 libasound2 libpangocairo-1.0-0 libatk1.0-0 libatk-bridge2.0-0 libgtk-3-0

执行完之后重新尝试转换PDF，大概率就能成功了。如果还有其他库缺失的报错，直接根据提示安装对应的包就行。

2. （WSL环境专属）指定Windows端的浏览器路径

如果你是在WSL里用VS Code，也可以让扩展调用Windows本地的Chrome或Edge来生成PDF，这样就不用管Linux的依赖了：

打开VS Code设置（快捷键Ctrl+,）
搜索markdown-pdf.executablePath
把路径设置为Windows浏览器的可执行文件，比如Chrome的路径：
```
/mnt/c/Program Files/Google/Chrome/Application/chrome.exe
```
或者用Windows风格的路径（注意转义反斜杠）：
```
C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe
```
保存设置后再试转换，应该就能正常生成PDF了。