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

发布于：2025-07-14 ⋅ 阅读:(58) ⋅ 点赞:(0)

文章目录

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官网，找到下载链接

image-20250703201212406

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

image-20250703201928080

1.2 运行安装程序

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

image-20250703203501822

image-20250703203303973

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

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

image-20250703204906277

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

image-20250703215455692

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

image-20250703215904212

2 VSCode安装与配置

2.1 下载VSCode安装包

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

image-20250703205743055

2.2 安装VSCode

双击运行安装包

image-20250703211338649

更改安装路径

image-20250703211628865

image-20250703211832376

点击安装即可。

2.3 安装中文语言包

修改插件默认安装位置

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

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

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

image-20250703214201709

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

image-20250703214538400

image-20250703214626936

2.4 配置LaTeX核心扩展

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

image-20250703220146943

2.5 加载TeX模版文件

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

image-20250703221710267

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

image-20250703222309833

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中预览，点击查看日志可分析报错。

image-20250703231816532

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

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

网站公告

今日签到

点亮在社区的每一天
去签到

热门文章

最新发布