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

文章目录

• • 0 引言
  • • 为什么选择LaTeX+VSCode？
    • 为什么不选择Overleaf？
  • 1 TeXLive安装
  • • 1.1 下载安装包
    • 1.2 运行安装程序
    • 1.3 通过镜像安装
  • 2 VSCode安装与配置
  • • 2.1 下载VSCode安装包
    • 2.2 安装VSCode
    • 2.3 安装中文语言包
    • 2.4 配置LaTeX核心扩展
    • 2.5 加载TeX模版文件
    • 2.6 编译配置优化
    • 2.7 环境验证
  • 3 VSCode其他配置（可选）
  • • 3.1 SumatraPDF
    • 3.2 Git
    • 3.3 Zotero插件
  • 参考

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