用 LaTeX 写论文，最劝退人的往往不是语法本身，而是环境搭建。我见过太多人卡在最前面：装了个几百 MB 的发行版，又在编辑器里折腾半天，最后打开模板一看满屏报错，心态直接崩了。今天这篇东西，就是想用一套足够详细的安装配置流程，把“LaTeX + VSCode”这条路彻底走通，让你照着点鼠标就能把环境跑起来，少走我当年踩过的那一堆坑。
这套组合解决的核心问题，就是“轻量编辑器 + 完整 TeX 环境”的搭配。VSCode 负责写代码、看文件结构、做版本管理，TeX Live 负责把代码编译成 PDF，两者通过 LaTeX Workshop 插件打通。整个过程免费、跨平台、可复现，而且比任何在线编辑器都更接近真实科研写作的工作流。适合的人群很明确：刚开始接触 LaTeX 的本科生、研究生，准备用 LaTeX 投论文的科研人员，以及长期被 Word 排版逼疯想换个写法的作者。
我在实际配置中发现，大部分失败案例都出在同一个地方：概念没理清。所以下面先花点篇幅把“发行版、编辑器、编译工具”这三件事掰开，再讲具体操作。
1. 内容整体设计与思路拆解
1.1 先搞明白 LaTeX、TeX Live、VSCode 各自扮演什么角色
很多人一上来就把 LaTeX 当成一个软件去安装，其实不对。LaTeX 是一套基于 TeX 的排版系统，本质上是“宏包集合 + 语法规则”。它不负责在屏幕上渲染文档，也不提供可视化界面，它只负责把.tex源文件“编译”成排版精美的 PDF 文件。
真正参与这个流程的，其实是三个层面的东西：
- TeX 发行版：比如 TeX Live、MacTeX、MiKTeX。它里面包含了 TeX 引擎、LaTeX 格式文件、几百个常用宏包、字体、编译工具链。没有发行版，你写的
\documentclass{article}就是一堆没用的字符。 - 编辑器：VSCode、TeXstudio、WinEdt 等等。编辑器只是提供一个写
.tex文件的界面，它本身不负责排版。你完全可以用记事本写 LaTeX，也能编译成功，只是体验极差。 - 编译工具：
pdfLaTeX、XeLaTeX、LuaLaTeX这些才是真正把.tex变成.pdf的程序。不同的编译工具处理字体和中文的方式不一样，这也是后面配置的重点。
我见过有人问“VSCode 装好了，LaTeX 插件也装了，为什么还是编译不了？”原因大概率就是系统里根本没有安装 TeX Live。VSCode 插件只是“遥控器”，你得先有“电视机”才能按出画面。所以这篇文章的安装顺序一定是：先装发行版，再装 VSCode，最后装插件。
1.2 为什么选 VSCode 而不是 TeXstudio 或 Overleaf
TeXstudio 是专门的 LaTeX 编辑器，开箱即用，界面里全是 LaTeX 按钮，看起来对新手很友好。但我个人的体验是：TeXstudio 的很多功能太“封闭”，如果你想在同一个编辑器里既写 LaTeX，又写 Python 脚本处理数据，或者用 Git 管理论文版本，就得在不同软件之间来回切换，非常割裂。
Overleaf 是网页版 LaTeX 编辑器，胜在零配置、模板多、多人协作方便。但它有两个问题：一是编译速度受服务器影响，大文档或图片多的文档会很慢；二是离线和本地文件管理能力弱，所有东西都锁在云端。对需要本地跑大实验、或者对隐私有要求的科研场景来说，Overleaf 不够自在。
VSCode 的思路完全不一样。它本身是一个通用代码编辑器，通过 LaTeX Workshop 插件获得完整的 LaTeX 支持，同时还能装 Python、Git、Remote-SSH 等插件。这样你在一个窗口里就能完成“写论文、跑数据、做版本管理”整套工作流。VSCode 的启动速度快、插件生态大、界面可定制程度高，加上它是微软主导维护的免费开源项目，社区资源极其丰富。对长期搞科研写作的人来说，这笔“学习成本”换来的效率提升是值得的。
1.3 整体配置思路：最小可行环境先行，再逐步扩展
新手最容易犯的一个错误，就是一上来就去研究各种高级配置，比如自定义编译链、精确到像素的宏包参数。虽然这些配置后续确实有用，但环境还没跑通之前就折腾这些，只会增加排查难度。
我推荐的策略是“最小可行环境先行”：先用默认配置把最简单的文档编译出 PDF，确认整条链路通了，再逐步加点东西进去。具体来说就是四步：
- 安装完整的 TeX Live 发行版，保证宏包不缺、字体不缺。
- 安装 VSCode 和 LaTeX Workshop 插件，让编辑器能一键编译。
- 配置编译工具为 XeLaTeX，解决中文字体支持的痛点。
- 写一个最简单的测试文档，验证“源文件 → 编译 → PDF”全链路没有问题。
这套思路的核心价值在于：把“环境问题”和“语法问题”剥离开。如果一开始就堆很多宏包，编译报错时你根本分不清是宏包缺了、字体没了，还是语法写错了。等最小环境通了，你再往文档里添加章节、公式、图片、参考文献，每一步都能知道问题出在哪一层。
2. 核心细节解析与实操要点
2.1 安装 TeX Live：建议选择完整版，别贪图“精简”
Windows 上最常见的发行版有两个：TeX Live 和 MiKTeX。MiKTeX 的好处是可以“按需安装宏包”——编译到哪缺哪个宏包就自动装哪个，听起来很智能。但我个人的建议是：科研写作直接上 TeX Live 完整版，一次性把所有东西都装好，省得在投稿前突然缺宏包，还得等 MiKTeX 现场联网拉取，运气不好还会拉取失败。
TeX Live 的安装包可以在清华镜像站等国内源下载，别去官网直接下，官网的下载速度在国内经常惨不忍睹。具体步骤：
- 访问清华镜像站 TUNA 的 TeX Live 目录，找到最新版本的 ISO 镜像文件，比如
texlive.iso。 - 下载完成后，Windows 系统直接双击 ISO 挂载，以管理员身份运行
install-tl-windows.bat。 - 安装界面里建议把安装位置改到一个没有空格的路径，比如
D:\texlive。虽然默认路径C:\texlive\2025也没问题，但有些第三方工具对空格路径处理得不好，提前规避可以省事。 - 在安装方案（scheme）里选择“完整方案（full schem）”，不要选“基础方案（basic scheme）”。完整方案会安装所有宏包，磁盘占用大概 7-8 GB，空间紧张也建议保留，后续省下的时间成本远大于这点磁盘开销。
- 点击安装，等待 15 到 40 分钟不等，具体取决于机器和源的速度。这个过程没有太多需要人工干预的地方，等它自己跑完就行。
安装完成后，打开 PowerShell 输入：
tex --version xelatex --version如果能看到版本号，说明 TeX Live 已经进入系统 PATH，可以正常使用了。如果提示“无法识别”，大概率是环境变量没有自动配置，需要手动把安装目录下的bin\windows路径加进系统 PATH。
macOS 用户装 MacTeX，它本质上是 TeX Live 的 macOS 发行版，安装包去 tug.org/mactex 下载，跟着向导点下一步即可。装上之后xelatex也是直接可用的。
2.2 安装 VSCode：几个能显著改善体验的设置
VSCode 的安装本身没什么好讲的，去官网下载安装包，一路下一步。需要注意的几个关键点：
- 安装时勾选“添加到 PATH”和“通过 Code 打开文件”等选项，方便后续在终端里直接用
code命令打开项目。 - 界面默认是英文的，不想看英文的话可以在扩展市场搜索“Chinese (Simplified) Language Pack”，装完重启 VSCode 就变成中文界面了。
- 建议在 VSCode 设置里把
files.autoSave改为onFocusChange或afterDelay。写 LaTeX 时如果自动保存太频繁，可能会在你还没写完一段命令时就触发了编译，反而增加不必要的报错。我自己习惯用afterDelay并把延迟设为 1000 毫秒，既不会丢内容，也不会过于激进。 - 在 VSCode 里打开一个专门存放论文的文件夹，不要直接在“文件 → 新建文件”里写
.tex并编译。LaTeX 的编译逻辑是“项目级”的，多文件结构、图片路径、参考文献数据库都和项目根目录相关。把文件夹作为工作区打开，后面配置多文件编译也方便。
2.3 安装并配置 LaTeX Workshop：核心中的核心
LaTeX Workshop 是 VSCode 里最主流的 LaTeX 插件。安装很简单：在扩展市场搜索“LaTeX Workshop”，认准作者是 James Yu（最新版也可能显示为其他维护者），点击安装即可。
安装完成后，需要做一些必要配置。很多教程直接告诉你“装完就能用”，其实默认配置的编译工具是latexmk，而latexmk默认调用的是pdfLaTeX。pdfLaTeX对中文支持很弱，遇到中文文档就会报错，所以必须手动把默认编译工具改成XeLaTeX或LuaLaTeX。
在 VSCode 里按Ctrl+Shift+P，输入Preferences: Open User Settings (JSON)，打开settings.json，加入以下核心配置：
{ "latex-workshop.latex.recipes": [ { "name": "XeLaTeX", "tools": [ "xelatex" ] } ], "latex-workshop.latex.tools": [ { "name": "xelatex", "command": "xelatex", "args": [ "-synctex=1", "-interaction=nonstopmode", "-file-line-error", "%DOC%" ] } ] }这段配置的意思是：定义了一个名为XeLaTeX的“编译方案”，这个方案只调用xelatex这一个工具。%DOC%是当前打开的.tex文件主文件名，-synctex=1用于生成 SyncTeX 数据，方便 VSCode 的 PDF 反向定位功能使用，-interaction=nonstopmode表示遇到错误不弹交互框，直接以文件形式记录错误信息，-file-line-error让报错信息带文件路径和行号，排查问题更方便。
如果之后你的论文要生成参考文献目录，还需要把biber或bibtex加进 recipe 里。最简单的做法是配置一个“XeLaTeX → Biber → XeLaTeX → XeLaTeX”的链式 recipe。不过这一步可以等用到 BibTeX 时再回来加，初期不配置也不会影响基础工作。
2.4 编译测试：三步验证环境是否真的通了
配置结束后，新人最容易卡住的地方就是“不知道怎样才算配好了”。我建议你按下面三步走：
第一步，新建一个测试文档，命名为test.tex，放在你的工作目录里。内容不要追求复杂，足够验证环境即可：
\documentclass{article} \usepackage{ctex} \begin{document} 你好，LaTeX！ \end{document}第二步，按Ctrl+S保存文件。LaTeX Workshop 默认会在保存时自动编译，或者你可以按Ctrl+Alt+B手动触发编译。VSCode 底部状态栏会显示编译过程，PDF 预览窗口会在编译结束后自动弹出。
第三步，看结果。如果 PDF 里正确显示“你好，LaTeX！”，说明整套环境已经通了。如果显示乱码，检查编辑器的文件编码是不是 UTF-8；如果编译报错，查看“LaTeX Workshop”的输出面板，找到第一个错误提示，一般无非是宏包缺失、字体找不到、路径有空格这几类。
3. 实操过程与核心环节实现
3.1 配置中文字体与编码：新手最容易踩的雷区
用 LaTeX 写中文论文，核心就是ctex宏包。但在配置它之前，有一个绕不开的底层问题：用什么编译工具。
pdfLaTeX编译中文比较折腾，需要配置 CJK 字体和编码方案，XeLaTeX可以直接调用系统中的中文字体，配合ctex宏包，体验已经非常接近“开箱即用”。LuaLaTeX也支持中文，但宏包兼容性有时不如XeLaTeX，所以我的默认选择是XeLaTeX。
ctex宏包有三种基本用法：
\usepackage{ctex}：加载全部中文支持，文档类仍是标准的article、book等。\documentclass{ctexart}：使用 ctex 专门定义的中文章节样式。\documentclass[UTF8]{ctexart}：显式指定编码为 UTF-8，虽然现在不设一般也能自动识别，但加上更保险。
日常论文写作用\documentclass{ctexart}最方便，它预设了符合中文排版的章节标题格式、字号和缩进。如果你是从模板改起，模板里用了\documentclass{article}加\usepackage{ctex}，也完全没问题，两种方式都能编译。
关于编码，强烈建议所有.tex文件统一用 UTF-8。VSCode 默认就是 UTF-8，所以只要你别在“文件 → 另存为”时改成 GBK 或者其他编码，基本不会出问题。万一你打开别人发给你的.tex文件出现乱码，先看右下角编码信息，VSCode 会在状态栏显示当前文件编码，点击它就可以手动切换再重新保存。
3.2 数学公式、图片和表格：从零到能写出一页完整论文
环境通了，接下来要面对的就是 LaTeX 语法。虽然完整的语法体系很大，但科研写作最开始只需要掌握几个核心场景。
数学公式是最刚需的功能。行内公式用一对美元符号包围，比如$x^2 + y^2 = z^2$；独立成行的公式用\[ ... \]包围，或者用equation环境。常见符号包括分数\frac{a}{b}、根号\sqrt{x}、上下标x_{i}^{n}、希腊字母\alpha、\beta、求和\sum_{i=1}^{n}等。写多行公式可以用align环境，用&控制对齐位置，用\\换行。
图片插入稍微麻烦一点。首先必须引入graphicx宏包，然后通过\includegraphics命令插入图片。核心要点是路径问题：如果图片和.tex文件在同一个目录，直接写文件名；如果在子目录，比如figures/xx.png，那么要写相对路径。我习惯在项目根目录建一个figures文件夹，所有图都放进去，统一用相对路径引用，这样整个项目即使换台电脑，只要文件夹结构没变就能编译通过。
图片位置控制是新手最容易疑惑的地方。LaTeX 默认会把图片放在它认为合适的位置，而不是你代码里写的位置。用[h]表示“尽量放在这里”，[htbp]表示“优先放这里，放不下就放页面顶部/底部/单独页面”。刚开始不用太执着于精确控制图片位置，先把图能显示出来最重要。
表格是另一个高频场景。一个最简单的三线表示例：
\begin{table}[htbp] \centering \begin{tabular}{ccc} \hline 方法 & 准确率 & 耗时 \\ \hline A & 92.3\% & 1.2s \\ B & 94.1\% & 0.8s \\ \hline \end{tabular} \end{table}tabular环境里的{ccc}表示三列居中对齐，\hline是横线。如果表格内容太长导致自动换行问题，优先检查是不是单元格内用了不能断行的长单词，或者列宽没有定义。解决长内容换行常见方案是用p{宽度}定义固定列宽，比如{|p{3cm}|p{5cm}|}，或者用tabularx宏包的X列类型自动分配宽度。
3.3 参考文献管理：从手工编写到 BibTeX 自动化
写科研论文不可能不引参考文献。最朴素的方式是手动在文末写\begin{thebibliography}环境，一条一条列。这种方式对短文档还行，但文档一旦变长，编号、格式、顺序全靠手动维护，很容易出错。
科研场景推荐用 BibTeX 或 BibLaTeX 来管理参考文献。思路是这样的：先把所有参考文献的信息写进一个.bib文件，每条记录对应一个唯一的关键字，然后在正文里用\cite{关键字}引用，最后通过编译工具自动生成带编号的参考文献列表。
.bib文件里最常见的期刊条目格式如下：
@article{lin2024example, author = {Lin, Zhang and Wang, Yan}, title = {An Example Paper for LaTeX Beginners}, journal = {Journal of LaTeX Studies}, year = {2024}, volume = {10}, pages = {1--10} }正文中引用多个文献时，写法是\cite{lin2024example, wang2023another}，多个关键字用逗号分隔。这对应了常见搜索里“latex引用两篇参考文献格式”的问题。
BibTeX 的编译流程比普通文档多了两步。如果使用bibtex编译参考文献，顺序是：
XeLaTeX编译第一遍，生成.aux辅助文件；bibtex读取.aux和.bib，生成.bbl文件；XeLaTeX编译第二遍，把参考文献信息写入正文；XeLaTeX编译第三遍，更新交叉引用和编号。
在 LaTeX Workshop 的配置里，这种多步骤流程需要定义一个 recipe。比如在 settings.json 里加：
{ "name": "XeLaTeX -> BibTeX -> XeLaTeX*2", "tools": [ "xelatex", "bibtex", "xelatex", "xelatex" ] }然后在文档里加入\bibliographystyle{plain}和\bibliography{refs}，其中refs是.bib文件的主文件名。保存编译后，参考文献就自动生成了。首次接触这个流程的人经常忘记“有多步编译”，只看了一遍编译的日志以为出了问题，其实只要 recipe 配置正确，插件会自动帮你跑完整条链。
3.4 常用符号与特殊字符：右斜线、花括号、特殊数学符号
网上关于 LaTeX 的搜索关键词里，高频出现“latex右斜线怎么打”“latex特殊符号”“latex符号大全”，这几个问题本质上是同一类：LaTeX 里的命令和特殊字符如何输入。
LaTeX 里所有控制序列（命令）都是以反斜线\开头的，比如\alpha、\textbf{}、\frac{}{}。所以如何输入反斜线本身就很重要。中文输入法下，反斜线键一般是键盘右上角、退格键下方那个键，按下直接输出\。如果你用的是中文全角输入法，可能会输出全角反斜线＼，那就必须切到英文输入模式重新输入。我见过太多新手在中文输入法状态下写\usepackage，结果编辑器里显示的是＼usepackage，编译直接报错。
特殊字符里，{}用来表示分组和作用域，$用来进入数学模式，&用来表格对齐和公式对齐，%是注释符号，_是下标，^是上标。如果你需要在正文里显示这些特殊字符本身，必须使用转义命令：\{、\}、\$、\%、\_、\^{}等。
数学模式下常用的符号数量非常多，但科研写作初期只需掌握高频的一部分：加减乘除+ - \times \div，等号与不等号= \neq \approx \leq \geq，集合符号\in \subset \cap \cup \emptyset，箭头\rightarrow \leftarrow \Rightarrow，以及希腊字母的完整列表。更复杂的符号，比如积分\int、偏导\partial、极限\lim，用到时再查也不迟。我自己写论文时的习惯是，需要某个符号但一时想不起代码，就打开 texdoc 查看symbols.pdf或直接搜索引擎查“latex 符号 xxx”，几秒钟就能解决，没必要一开始背一整本符号大全。
4. 常见问题与排查技巧实录
4.1 编译报错定位：不要死盯第一行错误信息
LaTeX 的报错信息对新手非常不友好，经常是一大段看起来像乱码的日志。但它的错误提示其实有规律：真正的错误信息通常以感叹号开头，而后续的行只是“上下文展示”。比如：
! Undefined control sequence. l.12 \usepackage{ctexx}这个错误告诉你第 12 行有一个未定义的控制序列，通常就是拼错了命令名。很多新手编译失败后，第一反应是去翻日志底部，看到一堆“Output written on test.pdf”才放心，其实那个只是正常输出的提示。
我建议你打开 VSCode 里的“LaTeX Workshop”输出面板，把日志级别调到“警告”或“错误”再排查。插件还会在“问题”面板里列出解析到的错误和位置，点击可跳转到对应行。这个方法适合大部分语法错误。如果确实报了一个完全看不懂的错，把完整错误信息复制到搜索引擎，八成能找到前人踩过同样坑的帖子。
4.2 中文乱码：先检查编码，再检查字体
中文乱码通常有两种表现。第一种是源文件里的中文显示为乱码，这种情况基本是文件编码问题，把.tex文件另存为 UTF-8 即可。第二种是编译出来的 PDF 里中文乱码或完全空白，这种情况基本是编译工具或宏包问题。
如果你用的是XeLaTeX并且加载了ctex宏包，PDF 里依然没有中文，要检查的是系统里是否有可用的中文字体。Windows 系统一般自带宋体、黑体、微软雅黑，macOS 自带苹方。大多数情况下不会缺字体，但如果你的模板里通过fontset指定了某种罕见字体，而系统里没有，就会报字体缺失错误。解决方法是把ctex宏包写成：
\usepackage[fontset=windows]{ctex}或者：
\usepackage[fontset=mac]{ctex}明确指定字体集，可以避免自动检测字体时出错。如果你用的是 Linux 系统，可能需要安装fonts-noto-cjk之类的字体包。
4.3 图片无法显示：路径和编译目录是重灾区
图片插入不了的原因，九成出在路径或文件扩展名上。VSCode 里编译 LaTeX，默认工作目录是当前打开的.tex文件所在目录。如果你的图片在子目录，就必须在\includegraphics里写相对路径，比如\includegraphics{figures/result.png}。如果编译时报“file not found”，先确认图片确实存在，再确认路径拼写、大小写完全一致。
另外要注意，graphicx宏包支持 PNG、PDF、EPS 等格式，但有时候你对 EPS 文件的支持并不好，建议统一转成 PDF 或 PNG 再插入。尤其在使用XeLaTeX编译时，eps的支持需要额外宏包，不要自找麻烦。
还有一个冷门但很坑的问题：如果你在文件名里用了中文或空格，比如“图 1.png”，编译时可能读取不到。稳妥的做法是所有图片文件名用英文、无空格、无中文，比如fig1.png、result_main.png。
4.4 自动换行和表格溢出：别强行用断行命令
“latex表格自动换行”是热搜词里非常靠前的需求。新手习惯性地在单元格里用\\强制换行，但\\在表格里是换行到下一行的意思，会直接破坏表格结构。正确的做法是让单元格内容根据列宽自动换行。
普通tabular环境里，l列类型不会自动换行，内容长就会溢出。改成p{宽度}列类型即可自动换行，比如：
\begin{tabular}{p{3cm}p{5cm}p{4cm}}p{宽度}的效果类似段落框，内容到达指定宽度后自动换行，配合顶部对齐可以这么用：p{3cm}默认是顶部对齐，这个行为正是大多数报告表所需要的。而tabularx宏包提供了X列类型，它可以自动分配剩余宽度，更适合表格总宽度等于页面宽度的场景。优先级建议是：表格简单时用tabular+p{}，复杂或需要自动伸展时用tabularx。
4.5 VSCode 写 LaTeX 时的“假死”：清理辅助文件
用 VSCode 写大型 LaTeX 文档，有时会出现编译后界面卡顿、或者 PDF 预览不刷新。这其实不是 VSCode 本身卡了，而是 LaTeX 编译生成的辅助文件太多了。.aux、.log、.out、.toc、.synctex.gz等文件很有用，但它们积累多了会让资源管理器变得混乱。
LaTeX Workshop 提供了一个“清理辅助文件”的命令。按Ctrl+Shift+P，输入Clean up auxiliary files，执行后可以一键删除这些中间产物，保留.tex和.pdf。我也建议在项目文件夹里设置 Git 忽略规则（.gitignore），把*.aux、*.log、*.out、*.toc、*.synctex.gz、*.bbl、*.blg都加进去，避免这些临时文件污染版本仓库。
5. 实操心得与效率技巧
5.1 模板管理：从零搭模板，不如先折腾已有模板
论文模板是另一个常见搜索点。很多期刊和学位论文都有官方提供的 LaTeX 模板，下载下来直接改，比从\documentclass{article}开始搭要高效得多。拿到模板后，建议先在本地完整编译一遍，确认模板本身能通，再动笔改内容。如果模板编译都报错，先看是否缺少宏包——大部分期刊模板都会在提交时附一个完整的宏包依赖清单。
改模板时有个重要习惯：不要盲目删除看起来“没用”的代码。很多模板配置了奇特的页面尺寸、页眉页脚格式、字体映射，你删掉一行可能就会导致整体排版崩溃。真要调整格式，先小步改动、每次都重新编译，确认结果符合预期后再继续下一步。
5.2 用 SyncTeX 实现 PDF 与源码互跳：大幅提升修改效率
VSCode 里默认配置了 SyncTeX，它能让你在 PDF 预览窗口和.tex源码之间双向跳转。在 PDF 上按住Ctrl点击某一处，会跳到对应的源码位置；在源码里按Ctrl+Alt+J，PDF 预览会跳到该段对应的页面。
这个功能看似不起眼，但实际写长论文时，你经常要回看某一段的公式或数据是哪里写的。有了 SyncTeX，定位效率能提升一个层级。前提是编译时必须带上-synctex=1参数，前面配置里已经写好了。
5.3 用 VSCode 多光标与代码片段，批量编辑更快
LaTeX 写多了之后，你会发现大量重复操作：多次写\begin{equation}...\end{equation}、反复输入\textbf{...}、批量改量纲单位。这些场景都可以用 VSCode 的功能提速。
多光标编辑：按住Alt键，在需要修改的多个位置点一下鼠标，即可同时编辑多处。或者选中一段文本后按Ctrl+Shift+L，会选中所有相同文本，同时修改。这个功能在批量把figure环境改为table环境时特别好用。
代码片段（Snippet）：VSCode 支持用户自定义代码片段。在文件 → 首选项 → 配置用户代码片段里新建一个latex.json，可以定义类似“输入eq按 Tab 自动补全整个 equation 环境”的快捷方式。不过刚开始不建议配置太多，先把基础语法练熟，再用代码片段固化自己的高频模式。
5.4 把 LaTeX 纳入 Git 管理：论文也是代码
我强烈建议从写第一篇 LaTeX 论文开始就把项目放进 Git 仓库。LaTeX 源文件是纯文本，非常利于做版本对比。导师让你改回上一版、或者你想比较两种表述的效果，Git 都能精准定位每一次改动。
配合远程仓库，你还能在不同电脑之间同步工作进度。写完一段就提交、推送到远程，这台电脑上写到一半的内容，换个环境下拉代码就能继续。这个工作流一旦习惯，就再也回不到“发送 final_v3_最终版2.docx”这样的邮件版本管理了。
5.5 备份 TeX Live 宏包目录：换电脑不用重新下载
最后分享一个很实在的经验：TeX Live 完整版装完，宏包目录里有一整套你下载好的发行版。如果你需要换电脑，最快的迁移方式是直接拷贝整个 TeX Live 安装目录，然后在新电脑上运行安装脚本的“设置路径”模式，加入系统 PATH。相比重新下载安装镜像再等半小时，这种方式快非常多。但要注意的是，不同大版本之间不要混用，比如不要直接把 2024 的目录当 2025 用，容易遇到格式不兼容问题。更保险的方法是拷贝同一版本的整个安装目录。
就我个人的使用体验来说，LaTeX + VSCode 这套组合真正舒服的地方并不在于某一项功能多惊艳，而在于所有环节都能掌控、都能自动化、都能融入自己的日常科研工作流。一旦你跨过了环境配置这道坎，后面写公式、插图、改排版都会变得很顺。如果你第一次配置就成功跑通了，恭喜你，后面的论文之路应该会顺畅很多。如果中间还有没解决的问题，不妨回头检查一下编译工具是不是 XeLaTeX、宏包是不是完整安装、路径里有没有中文，这三个地方几乎覆盖了九成的新手报错。
