【LaTeX Workshop】VS Code 与 SumatraPDF 双向链接配置方法

• TeX Live 2021
• Sumatra PDF: v3.4.6 64-bit
• VS Code: v1.62.3 (system setup)
• LaTeX Workshop: v8.22.0

SumatraPDF 配置

1. 安装 SumatraPDF。假设给所有用户安装，并安装于默认位置 C:/Program Files/SumatraPDF

2. 打开 SumatraPDF，选择菜单中的 设置 -> 选项，在方框内输入以下内容后点 确定

   "C:\Program Files\Microsoft VS Code\Code.exe" "C:\Program Files\Microsoft VS Code\resources\app\out\cli.js" --ms-enable-electron-run-as-node -r -g "%f:%l"
   

   

VS Code 配置

1. 安装 LaTeX Workshop 插件

2. Ctrl+Shift+P 打开命令面板，输入 JSON，如果打算全局设置就选择 Preferences: Open Settings (JSON)，如果打算只设置工作空间就选择 Preferences: Open Workspace Settings (JSON)

   

3. 在花括号内插入以下内容并保存

   /* LaTeX Workshop */
   "latex-workshop.latex.autoBuild.run": "never",
   // "latex-workshop.message.error.show": false,
   // "latex-workshop.message.warning.show": false,
   /* 配置编译工具 */
   "latex-workshop.latex.tools": [
       {
           "name": "xelatex",
           "command": "xelatex",
           "args": [
               "-synctex=1",
               "-interaction=nonstopmode",
               "-file-line-error",
               "%DOCFILE%"
           ]
       },
       {
           "name": "pdflatex",
           "command": "pdflatex",
           "args": [
               "-synctex=1",
               "-interaction=nonstopmode",
               "-file-line-error",
               "%DOCFILE%"
           ]
       },
       {
           "name": "bibtex",
           "command": "bibtex",
           "args": [
               "%DOCFILE%"
           ]
       }
   ],
   /* 配置编译方法 */
   "latex-workshop.latex.recipes": [
       {
           "name": "xelatex",
           "tools": [
               "xelatex"
           ],
       },
       {
           "name": "pdflatex",
           "tools": [
               "pdflatex"
           ]
       },
       {
           "name": "xe->bib->xe->xe",
           "tools": [
               "xelatex",
               "bibtex",
               "xelatex",
               "xelatex"
           ]
       },
       {
           "name": "pdf->bib->pdf->pdf",
           "tools": [
               "pdflatex",
               "bibtex",
               "pdflatex",
               "pdflatex"
           ]
       }
   ],
   /* 配置默认用外部 PDF 阅读器 */
   "latex-workshop.view.pdf.viewer": "external",
   
   /* 配置 View LaTeX PDF file (Ctrl+Alt+V) 功能*/
   "latex-workshop.view.pdf.external.viewer.command": "C:/Program Files/SumatraPDF/SumatraPDF.exe",
   "latex-workshop.view.pdf.external.viewer.args": [
       "%PDF%"
   ],
   
   /* 配置双向搜索功能 */
   // 前向搜索: 在 VS Code 中 Ctrl+Alt+J 跳转到 .pdf 文件对应行
   // 逆向搜索: 在 SumatraPDF 中双击跳转到 .tex 文件对应行
   "latex-workshop.view.pdf.external.synctex.command": "C:/Program Files/SumatraPDF/SumatraPDF.exe",
   "latex-workshop.view.pdf.external.synctex.args": [
       "-forward-search",
       "%TEX%",
       "%LINE%",
       "-reuse-instance",
       "-inverse-search",
       "\"C:\\Program Files\\Microsoft VS Code\\Code.exe\" \"C:\\Program Files\\Microsoft VS Code\\resources\\app\\out\\cli.js\" --ms-enable-electron-run-as-node -r -g \"%f:%l\"",
       "%PDF%"
   ],
   

参考

• View · James-Yu/LaTeX-Workshop Wiki (github.com)