LaTeX 本地安装
#LaTeX 本体安装
首先需要下载 LaTeX 本体，可以直接去清华源https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/Images/官网下载最新版的 MacTeX，安装包大概 6GB 左右，下载好以后默认安装即可。
安装，以管理员身份运行
解压缩iso
安装过程可能有点久
最后可能卡在这里，但可以在安装目录下的install-tl.log看到
说明已经安装完成，关闭即可
测试是否安装成功
win+R→cmd，分别输入输入latex -v ,xelatex -v, pdflatex -v验证是否安装成功
如果出现提示'latex' 不是内部或外部命令，也不是可运行的程序 或批处理文件，那就是安装过程中环境变量没配好，重新配置环境变量再打开命令提示符重新测试就好了
配置环境变量（如测试不成功
找到texlive/2025/bin/win文件夹，复制材料地址
右键此电脑打开高级体系设置，找到环境变量，找到框架变量里面的Path
如果原来这里的texlive地址不全，那就点编辑重新补全地址，如果该没有，就点新建添加一条，然后每一个窗口都点击确定，最终重新打开命令提示符再测试是否安装成功
VScode配置
之后来到 Vscode，安装 LaTeX Workshop 插件，这个插件可以提供 LaTeX 的编译、预览等功能。我们如果只想在本地运行 LaTeX 的话，这个插件就足够了。
Ctrl + Shift + P
输入：
Preferences: Open User Settings (JSON)
回车，直接打开 settings.json 文件
在里面添加下面内容：
"editor.wordWrap": "on",
"latex-workshop.latex.autoBuild.run": "never",
"latex-workshop.showContextMenu": true,
"latex-workshop.intellisense.package.enabled": true,
"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": "latexmk",
"command": "latexmk",
"args": [
"-synctex=1",
"-interaction=nonstopmode",
"-file-line-error",
"-pdf",
"-outdir=%OUTDIR%",
"%DOCFILE%"
]
},
{
"name": "bibtex",
"command": "bibtex",
"args": [
"%DOCFILE%"
]
}
],
"latex-workshop.latex.recipes": [
{
"name": "XeLaTeX",
"tools": [
"xelatex"
]
},
{
"name": "PDFLaTeX",
"tools": [
"pdflatex"
]
},
{
"name": "BibTeX",
"tools": [
"bibtex"
]
},
{
"name": "LaTeXmk",
"tools": [
"latexmk"
]
},
{
"name": "xelatex -> bibtex -> xelatex*2",
"tools": [
"xelatex",
"bibtex",
"xelatex",
"xelatex"
]
},
{
"name": "pdflatex -> bibtex -> pdflatex*2",
"tools": [
"pdflatex",
"bibtex",
"pdflatex",
"pdflatex"
]
},
],
"latex-workshop.latex.clean.fileTypes": [
"*.aux", "*.bbl", "*.blg", "*.idx", "*.ind", "*.lof", "*.lot", "*.out", "*.toc", "*.acn", "*.acr", "*.alg", "*.glg", "*.glo", "*.gls", "*.ist", "*.fls", "*.log", "*.fdb_latexmk", "*.synctex.gz", "*.bcf", "*.run.xml", "*.nav", "*.snm", "*.vrb"
],
"latex-workshop.latex.autoBuild.run": "onSave",
"latex-workshop.latex.autoClean.run": "onFailed",
"latex-workshop.latex.recipe.default": "lastUsed",
"latex-workshop.view.pdf.internal.synctex.keybinding": "double-click",
"editor.unicodeHighlight.allowedLocales": {
"zh-hans": true,
"zh-hant": true
},
"[latex]": {
"editor.defaultFormatter": "James-Yu.latex-workshop"
},
大括号中，先加逗号后添加，根据提示不报错即可。
之后安装 Ultra Math Preview 插件，这个插件可以提供 LaTeX 的数学公式预览功能。（可选）
到这一步其实我们本地 LaTeX 的配置基本上就大功告成了，只需要打开.tex 文件，右上点击运行按钮，或者按下 Ctrl + Alt + B（Windows/Linux）就可以编译预览了。
不过我设定了保存时自动编译，只要保存就会自动编译预览，基本上可以做到实时预览，非常流畅的体验。
Overleaf 同步
Overleaf Workshop 插件安装
接下来我们将本地的 LaTeX 文件与 Overleaf 进行同步，需要下载插件 Overleaf Workshop
现在完成后在左侧打开 overleaf 图标，点击左上角 + 号，进行配置，提示输入 overleaf 的网址 https://www.overleaf.com 这里直接回车
出现 overleaf 的网址后点击右上角登入，点击"Login with Cookies"，在输入框中输入 Cookies 即可。
Overleaf Cookies 获取
关于 Cookies 的获取方法，我们直接来到 Overleaf 首页，按 F12 进入开发人员工具，点击 网络 , 一两秒后进行刷新（F5），左上角查询 project ，然后点击 project，找到 Cookie，并且 仅复制 over_session2 开头的一段，这就是我们需要的 Cookie。
实现同步功能
成功连接上后，在左侧 Overleaf Workshop 中找到我们创建好的项目，右键选择本地打开（Open Project Locally …）
这时会在本地创建一个文件夹，自己选定好文件夹的位置，里面包含了该 Overleaf 项目的所有文件。这个文件夹中的所有内容都会与 Overleaf 自动同步，我们只需要在本地使用 Vscode 编辑文件，在本地中编译快速预览，保存后就会自动上传到 Overleaf。
总结
使用这种方式我们真正做到了既要又要，既拥有丰富的 Vscode 插件生态与 Copilot 协作，高速的编译，又能享受 Overleaf 的云端协作和同步功能。尽情享受高效的 LaTeX 写作体验吧！
如果编译时出现❌×符号编译错误，重启电脑试试，可能是刚安装完latex没重启。
本地latex工程只需要整个文件夹用vscode打开即可
目录显示不出来，以及首行缩进无法实现：一般连续编译2次后就可以，以及 前面的JSON文件里是"latex-workshop.latex.autoClean.run": "onFailed",，不能是onRun
参考文献不能生成的原因：
左侧tex插件里面其实也有编译四次的快捷按键，用这个编译：
最重要的一点，论文写作中的参考文献数量极多，.bib文件中，一条参考文献的编写出错，编译全不能通过。按照报错的提示，修改有问题的bib引用后，一般就可以了。
参考：使用Vscode运行LaTeX（本地部署与Overleaf同步）
深入解析：【Latex】本地部署latex+vscode - ljbguanli - 博客园
Visual studio code + latex +bibtex,参考文献不能生成的原因：_latex 不产生bbl文件-CSDN博客
latex vscode 文献引用显示问号原因集合，找找你的原因_latex workshop 找不到bib-CSDN博客
(68 封私信 / 81 条消息) LaTeX 目录为何显示不出来，以及首行缩进无法实现？ - 知乎
