用vscode写latex-1

news2025/1/13 6:53:29

一般大伙使用 LaTeX 大体有两种方案，

一种是在本地配置环境或使用本地的软件，如 vscode + LaTeX，texlive，lyx 等等；

另一种是线上 LaTeX 平台，其中用的最多的是 Overleaf，还有一部分高校也有自己的 Overleaf 平台，比如北大以前有一个 latex.pku。

各种方案各有各的优势和劣势，本地配置往往要求用户对 LaTeX 各种配置了如指掌，如果用户本身是个 LaTeX 相关技术爱好者，本地编译就是最完美的；而不太擅长此道的朋友要么就下个软件（经常是破解版），要么就得求助于线上平台。

众所周知，年纪越大了越喜欢各种事情、任务执行时all in one，

参考我之前的博客，coding+debug+LLM QA+AI editing最好是all in one，所以我选了vscode+cline+copilot；

同样的，平时写科研周报、提交小论文，写小报告等展示成果上，无非是markdown以及latex两种格式：
本文主要讲latex：
一，overleaf等线上latex编辑平台：
https://www.overleaf.com/project/

优点是模板多多，比如说我随便找一个中文的：

只需要在规定latex格式下，变换填充内容字符即可，简便省力；

缺点就是保存不方便，编译麻烦，以及不是all in one，平台等非常受限；

类似的网页在线latex编辑平台有很多，基本上都和overleaf差不多

二，vscode本地部署

本教程将介绍如何在 VSCode 中配置 LaTeX 环境，以便于在 VSCode 中进行 LaTeX 的编写和预览，打造一个舒适便捷的 LaTeX 编写环境

1，TeX Live 安装

使用清华源：

https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/Images/

curl -O -s https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/Images/texlive.iso

静默模式+直接用下载文件名命名输出文件名字（省去传递参数麻烦）

当然iso盘需要GUI操作，在linux上，

个人还是偏向于使用apt install

sudo apt install texlive-full

sudo apt install texlive

https://tex.stackexchange.com/questions/134365/installation-of-texlive-full-on-ubuntu-12-04

至于是否要安装full等全部的package，看自己需求定

最终决定：如果麻烦各种依赖的包，可以full

2，LaTeX Workshop 配置

（1）vscode中latex插件安装：

等插件；

然后就是配置vscode本地的settings：

"latex-workshop.hover.preview.mathjax.extensions": [
    "boldsymbol"
],
"latex-workshop.intellisense.package.enabled": true,
"latex-workshop.latex.outDir": "./tmp",
"latex-workshop.latex.recipe.default": "lastUsed",
"latex-workshop.mathpreviewpanel.cursor.enabled": true,
"latex-workshop.message.error.show": false,
"latex-workshop.message.warning.show": false,
"latex-workshop.view.pdf.invert": 1,
"latex-workshop.view.pdf.invertMode.enabled": "auto",

实际上就是

// 鼠标悬停，预览公式时，支持 boldsymbol 宏
"latex-workshop.hover.preview.mathjax.extensions": [
    "boldsymbol"
],
// 是否启用 IntelliSense，自动补全引用的包中的环境和命令
"latex-workshop.intellisense.package.enabled": true,
// 编译后的文件输出目录
"latex-workshop.latex.outDir": "./tmp",
// 默认编译引擎为上次使用的
"latex-workshop.latex.recipe.default": "lastUsed",
// 预览复杂公式，使用时需要通过 command palette (命令面板) 打开
"latex-workshop.mathpreviewpanel.cursor.enabled": true,
// 不允许弹窗显示错误信息
"latex-workshop.message.error.show": false,
// 不允许弹窗显示警告信息
"latex-workshop.message.warning.show": false,
// 预览 PDF 时，反转颜色
"latex-workshop.view.pdf.invert": 1,
// 预览 PDF 时，自动检测是否需要反转颜色
"latex-workshop.view.pdf.invertMode.enabled": "auto",

或：

注意在前面head头部复制粘贴进去，不要在tail尾部

参考部分这里需要修改，否则我其他coding部分的pdf文件都是灰色的！
在这里插入图片描述

如果比较熟悉 VSCode，可以点击左下角的齿轮按钮，选择 Command Palette (命令面板)，在命令面板中搜索 settings，打开 settings.json 文件，直接复制粘贴上面的代码，从而快速修改配置。

（2）编译工具链配置：

"latex-workshop.latex.recipes": [
    {
        "name": "XeLaTeX",
        "tools": [
            "xelatexmk"
        ]
    },
    {
        "name": "PdfLaTeX",
        "tools": [
            "pdflatexmk"
        ]
    }
],
"latex-workshop.latex.tools": [
    {
        "args": [
            "-synctex=1",
            "-pdfxe",
            "-interaction=nonstopmode",
            "-file-line-error",
            "-outdir=%OUTDIR%",
            "%DOC%"
        ],
        "command": "latexmk",
        "env": {},
        "name": "xelatexmk"
    },
    {
        "args": [
            "-synctex=1",
            "-pdf",
            "-interaction=nonstopmode",
            "-file-line-error",
            "-outdir=%OUTDIR%",
            "%DOC%"
        ],
        "command": "latexmk",
        "env": {},
        "name": "pdflatexmk"
    }
],

3，实际编写latex：
从overleaf上随便找一个latex模板