VS Code LaTeX-Workshop调用外部Okular查看PDF失败求助

我尝试使用VS Code的LaTeX-Workshop插件的「View in external viewer」命令，通过Okular打开生成的PDF文件。

我的settings.json配置如下：

"latex-workshop.view.pdf.external.viewer.command": "okular",//
"latex-workshop.view.pdf.viewer": "external", //
"latex-workshop.view.pdf.external.viewer.args": [
    "--unique",
    "%PDF%"
]

执行该命令后无任何反应，日志信息如下：

[12:35:14.967][Viewer] Open external viewer for /path/to/filename.pdf
[12:35:14.967][Viewer] Execute the external PDF viewer command The command is okular:["--unique","/path/to/filename.pdf"].
[12:35:15.075][Viewer] The external PDF viewer stdout: 
[12:35:15.076][Viewer] The external PDF viewer stderr: okular: symbol lookup error: /snap/core20/current/lib/x86_64-linux-gnu/libpthread.so.0: undefined symbol: __libc_pthread_init, version GLIBC_PRIVATE

但直接在终端执行okular --unique /path/to/filename.pdf命令却可以正常打开PDF文件。

原因分析 #

这是因为VS Code若通过Snap安装，其运行环境的库路径与系统终端不一致，调用Okular时错误加载了Snap版本的libpthread.so.0库，导致符号查找失败；而终端直接执行时使用的是系统原生库路径，因此可以正常运行。

解决方案 #

• 指定Okular完整路径：

  1. 在终端执行which okular，获取Okular的系统原生路径（通常为/usr/bin/okular）。
  2. 修改settings.json中的命令为该完整路径：

  "latex-workshop.view.pdf.external.viewer.command": "/usr/bin/okular",
  "latex-workshop.view.pdf.viewer": "external",
  "latex-workshop.view.pdf.external.viewer.args": [
      "--unique",
      "%PDF%"
  ]
  

• 更换VS Code安装方式：
  如果VS Code是Snap版本，换成Debian包或Flatpak版本，避开Snap环境的隔离限制。

• 调整库路径（不推荐新手）：
  修改VS Code启动脚本，调整LD_LIBRARY_PATH让其优先加载系统原生库，但此操作可能引发兼容性问题，需谨慎使用。

内容的提问来源于stack exchange，提问作者James