【VSCode+LaTeX】科研写作环境搭建

0 引言

为什么选择LaTeX+VSCode？

LaTeX 并非普通的文字处理工具，而是一个面向科研、出版和高质量印刷的排版系统。它的核心价值在于用“代码”代替“手工排版”，彻底解决学术场景中的复杂格式需求：

• 数学公式的终极解决方案
• 图表与参考文献的自动化管理
• 跨平台文档一致性

VSCode作为微软推出的轻量级代码编辑器，在科研场景中远比传统编辑器（如Texmaker、WinEdt）更灵活：

• 插件生态的革命性提升
• 智能化的代码编辑体验
• 针对学术场景的深度优化

为什么不选择Overleaf？

Overleaf必须联网，编译速度较慢，报错信息不够清晰，项目较大需付费，并且存在数据泄露风险。

优势：

• 🚩 编译加速：本地多核CPU并行编译
• 🛠️ 深度定制：支持LaTeX Workshop等20+插件
• 🔐 版本控制：可用Git全流程追踪 + 差异对比
• 📈 离线可用：无需依赖网络环境

对于需要长期进行学术写作的用户，本地LaTeX环境具有显著优势。

1 TeXLive安装

这里说明一下，TeX是一种基础的排版语言，由著名计算机科学家Donald E. Knuth发明。LaTeX是基于TeX的扩展版本，由美国计算机科学家Leslie Lamport在20世纪80年代初期开发。TeXLive是一个包含TeX和LaTeX的发行版，提供了一个完整的工作环境，类似于C语言的编译器。这一步，可以理解为LaTex编译器的安装。

1.1 下载安装包

进入TeXLive官网，找到下载链接

选择Easy install，点击 install-tl-windows.exe下载安装程序

1.2 运行安装程序

双击下载到本地的安装程序，弹出的第一个窗口一路默认，等安装程序提取完成后，进入安装GUI，修改安装根目录，取消安装TeXworks前端，并在高级中自定义语言包（去除其他用不到的语言包，只保留中文和英文）

配置完成后，点击安装，会弹出安装进程窗口。

1.3 通过镜像安装

安装进程报错，程序终止，部分报错信息如下：

TLPDB::_install_data: downloading did not succeed (check_file_and_remove failed) for https://mirror.ctan.org/systems/texlive/tlnet/archive/texlive-scripts.doc.tar.xz
Installation failed.

初步判断为网络下载的问题，采用Plan B，直接去国内镜像源下载镜像文件，这里推荐清华源texlive镜像下载，下载texlive.iso

下载到本地后双击打开iso文件，以管理员身份运行install-tl-windows.bat进入和上面一样的安装界面，流程一样，配置完成后点击安装。安装时间较长，我安装的是2025版本的，安装完成GUI界面如下图所示，并没有提示“欢迎进入Tex live的世界！”

经搜索得知这可能是新版本安装程序的BUG，打开安装路径下的日志文件install-tl.log，拉到最底部，可以看见提示，安装完毕！

2 VSCode安装与配置

2.1 下载VSCode安装包

进入VSCode官网，点击Download for Windows，直接下载安装包到本地

2.2 安装VSCode

双击运行安装包

更改安装路径

点击安装即可。

2.3 安装中文语言包

修改插件默认安装位置

因为中文语言包其实是VSCode的一个扩展插件，而VSCode插件默认安装在C盘用户目录下，随着安装的插件数量增加，占用C盘内存较大，建议先修改默认安装位置。

参考方法：修改vscode插件安装路径

修改完成后，打开VSCode，点击左侧边栏Extensions，搜索Chinese (Simplified) Language Pack，点击install安装

安装完成后，根据使用方法指示，完成语言切换。

2.4 配置LaTeX核心扩展

扩展商店搜索LaTeX Workshop，该插件支持核心编译和预览功能，点击安装。

2.5 加载TeX模版文件

菜单栏点击文件-打开文件夹，选择TeX模板目录，这里使用springer提供的模版为例，下载链接

双击sn-article.tex ，点击左侧边栏出现TEX工具，进入如下界面，这便是LaTeX的编写界面。

2.6 编译配置优化

快捷键Ctrl+Shift+P 进入命令面板，输入Preferences: Open User Settings (JSON)，添加如下代码

{// 设置是否自动编译"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": "XeLaTeX*2","tools": ["xelatex","xelatex"]},{"name": "PDFLaTeX","tools": ["pdflatex"]},{"name": "PDFLaTeX*2","tools": ["pdflatex","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"],// 设置为onFaild 在构建失败后清除辅助文件"latex-workshop.latex.autoClean.run": "onFailed",// 使用上次的recipe编译组合"latex-workshop.latex.recipe.default": "lastUsed",// 用于反向同步的内部查看器的键绑定。ctrl/cmd +点击(默认)或双击"latex-workshop.view.pdf.internal.synctex.keybinding": "double-click","latex-workshop.view.pdf.viewer": "tab",
}

上述配置详细解释参见：https://zhuanlan.zhihu.com/p/166523064

2.7 环境验证

新建demo.tex，内容如下

\documentclass{article}
\title{Environment Validation}
\author{Test User}
\date{\today}\begin{document}
\maketitle\section{Basic Features}
Basic math: $a^2 + b^2 = c^2$\section{Math Environment}\label{sec:math}
\begin{equation}\sum_{n=1}^{\infty} \frac{1}{n^2} = \frac{\pi^2}{6}
\end{equation}\section{Advanced Features}
Cross-reference test: See section \ref{sec:math}\end{document}

选择XeLaTeX构建项目，生成的PDF可在VSCode中预览，点击查看日志可分析报错。

至此，科研写作环境搭建基本完成。

3 VSCode其他配置（可选）

3.1 SumatraPDF

有的时候，由于想要看到 pdf 文件的完整展现效果，使用内置查看器已无法满足需求，这时可以使用外部查看器进行查看。 SumatraPDF作为外部查看器，该软件的优点在于在具有 pdf 阅读功能的同时很轻量，安装包不到 10MB 大小，且支持双向同步功能。通过调整其与 vscode 的窗口位置，能够在拥有这些优势的同时，达到与内置 pdf 查看具有相同的效果。

安装配置教程：https://zhuanlan.zhihu.com/p/166523064

配置完成后，PDF无法反向搜索的问题参见链接：https://blog.csdn.net/a1010026261/article/details/131446557

3.2 Git

使用Git进行版本控制：https://blog.csdn.net/wq3095435422/article/details/125010399

3.3 Zotero插件

实现点击插入参考文献：https://zhuanlan.zhihu.com/p/515335936

参考

[1] https://shutiaoz.top/写作工具/LaTeX/Latex_VSCode

[2] https://blog.csdn.net/LiLiu_YiYu/article/details/146066653