三亩地 三亩地SAN MU DI · CODE DIARY
交流投稿
ARTICLE DETAIL

日记详情

真实记录编程学习的某一天，欢迎挑你感兴趣的翻一翻。

首页/学习日记/日记详情

LaTeX环境配置全攻略：TexLive 2020与TeXstudio 2020安装与配置详解

发布时间：2026/8/15 2:06:51 三亩地 编程学习日记
LaTeX环境配置全攻略：TexLive 2020与TeXstudio 2020安装与配置详解

1. 从“莫问题”说起：为什么你的LaTeX环境总出问题？

“亲测莫问题”——这大概是所有技术分享里最让人心动，也最让人怀疑的一句话了。作为一个在学术写作和文档排版领域摸爬滚打多年的老手，我见过太多朋友兴冲冲地下载了某个“一键安装包”或“绿色版”，结果在编译第一份文档时就卡在某个诡异的错误上，折腾半天后只能无奈放弃。LaTeX，这个被誉为学术排版的“黄金标准”，其入门的第一道门槛，往往不是语法，而是环境配置。

今天，我们就来彻底解决这个“第一道门槛”。我将以TexLive 2020和TexStudio 2020这一对经典组合为例，手把手带你完成从下载、安装到配置的全过程。我之所以选择2020这个版本，并非因为它最新，恰恰相反，它已经足够稳定，相关的教程和问题解决方案也最为丰富，对于新手而言，踩坑的概率最低，学习路径最平滑。更重要的是，通过这次配置，你将理解LaTeX环境工作的核心逻辑，以后无论遇到什么版本、什么编辑器，都能举一反三，真正做到“莫问题”。

简单来说，TexLive是LaTeX的发行版，它包含了编译引擎、宏包、字体等一切核心组件，相当于汽车的发动机和变速箱；而TexStudio是一个集成开发环境（IDE），它提供了代码高亮、一键编译、实时预览等便利功能，相当于汽车的驾驶舱和方向盘。两者配合，才能让你高效、舒适地驾驶LaTeX这辆“车”。接下来的内容，我会假设你是一位希望开始使用LaTeX进行论文、报告或书籍写作的朋友，我们将一起把这套环境搭建起来，并理解每一个步骤背后的意义。

2. TexLive 2020：获取与安装的“正道”

在LaTeX的世界里，获取发行版的方式五花八门，但最可靠、最完整的永远是官方渠道。对于TexLive 2020，我们有两种主流方式：在线安装和离线镜像安装。我将详细解释两者，并给出我的明确建议。

2.1 在线安装与离线镜像：如何选择？

TexLive的官方维护站点是TUG（TeX Users Group）。在线安装程序会从一个主仓库动态下载所需的包，优点是安装包体积小（仅几十MB），理论上可以获取到最新的包更新。但它的致命缺点在于网络稳定性：由于服务器位于海外，下载过程中极易出现中断、速度缓慢甚至连接超时，对于国内用户尤其不友好。一次失败的在线安装足以消磨掉所有耐心。

因此，我强烈推荐所有用户，特别是新手，使用离线镜像进行安装。离线镜像是一个包含了TexLive 2020所有内容（约4.5GB）的完整副本。你只需要一次性下载这个ISO文件或压缩包，安装过程就完全在本地进行，速度极快且100%稳定。这就像买了一套完整的乐高套装，所有零件都在盒子里，不需要一边拼装一边等快递。

获取离线镜像的推荐途径是国内的大学开源镜像站，例如清华大学TUNA镜像站或中国科学技术大学USTC镜像站。它们的速度远快于国际源。以清华镜像为例，你可以访问其TeX目录，找到texlive/2020/下的texlive2020.iso文件进行下载。这是最稳妥的起点。

2.2 在Windows系统上安装TexLive 2020：步步为营

假设你已经从清华镜像下载好了texlive2020.iso文件。在Windows 10或11上，你可以直接双击ISO文件，系统会将其挂载为一个虚拟光驱（比如G盘）。接下来，我们开始安装。

  1. 以管理员身份运行安装程序：进入虚拟光驱，找到install-tl-windows.bat或install-tl-advanced.bat，右键选择“以管理员身份运行”。这一步至关重要，因为安装过程需要向系统目录写入文件、设置环境变量，普通用户权限可能导致失败。
  2. 理解安装界面选项：程序启动后，你会看到一个带有进度条的黑色命令行窗口，稍等片刻会弹出图形化安装界面。这里有几个关键选项：
    • 修改安装路径：默认路径是C:\texlive\2020。如果你的C盘空间紧张，可以修改到其他盘符，例如D:\texlive\2020。路径中不要包含中文或空格，这是避免未来各种诡异问题的基本原则。
    • 安装方案：对于绝大多数用户，选择“完整安装（Full）”即可。这大约需要占用6GB磁盘空间，但它确保了所有宏包和字体都可用，避免日后写作时因缺少某个冷门宏包而中断。除非你的磁盘空间极其拮据，否则不要选择“最小安装”或“自定义安装”。
    • 创建菜单快捷方式和文件关联：建议保持默认勾选。这会在开始菜单创建TeX Live Manager等工具，并将.tex文件关联给后续安装的编辑器。
    • 高级选项：点击“Advanced”可以进入更多设置。这里需要关注一点：将“安装TeXworks前端”的勾选去掉。因为我们将使用功能更强大的TeXstudio，不需要这个简易的前端。
  3. 开始安装并耐心等待：确认设置无误后，点击“安装”。安装过程会将ISO镜像中约4.5GB的文件解压并部署到你指定的目录。根据你的硬盘速度，这个过程可能需要20分钟到1小时。期间请保持电脑供电稳定，不要进行其他高磁盘占用的操作。
  4. 安装后的验证：安装完成后，不要立即关闭窗口。安装程序最后会提示“安装成功”，并可能有一个“查看日志”的按钮。更重要的是，我们需要验证环境变量是否已正确设置。
    • 按下Win + R，输入cmd打开命令提示符。
    • 输入命令tex --version并回车。如果安装成功，你会看到类似TeX 3.14159265 (TeX Live 2020)的版本信息。
    • 再输入latex --version和xelatex --version进行验证。如果这些命令都能正确返回版本信息，恭喜你，TexLive的核心引擎已经就位。

注意：如果命令提示“不是内部或外部命令”，说明环境变量未自动添加。你需要手动添加：右键“此电脑”->“属性”->“高级系统设置”->“环境变量”，在“系统变量”中找到“Path”，编辑并添加两条路径：C:\texlive\2020\bin\win32和C:\texlive\2020\bin\win64（请根据你的实际安装路径修改）。添加后重启命令提示符再测试。

3. TeXstudio 2020：你的LaTeX写作工作台

有了强大的TexLive引擎，我们还需要一个称手的编辑器。TeXstudio是一款免费、开源、跨平台且功能极其全面的LaTeX IDE，它的自动补全、语法高亮、集成查看器和丰富的编译命令管理，能极大提升写作效率。

3.1 获取与安装TeXstudio

TeXstudio的官方网站在SourceForge上，但同样可能面临访问速度慢的问题。我们可以从其GitHub的Release页面下载，或者使用国内一些软件下载站的历史版本（务必选择可信站点）。对于2020版本，找到一个稳定的安装包即可。

安装过程非常直观：

  1. 运行下载的texstudio-3.0.0-win64.exe（版本号可能略有不同）安装程序。
  2. 遵循安装向导，建议使用默认安装路径（通常为C:\Program Files\TeXstudio）。
  3. 在安装选项页，建议勾选“创建桌面快捷方式”和“将.tex文件关联到 TeXstudio”。
  4. 完成安装并启动TeXstudio。

3.2 首次启动与核心配置：让编辑器认识你的引擎

安装后直接打开TeXstudio，它可能还无法正常工作，因为它还不知道我们安装的TexLive在哪里。接下来进行最关键的一步——配置。

  1. 打开配置界面：点击菜单栏的“选项” -> “设置TeXstudio”（或直接按Ctrl+Alt+Shift+P）。
  2. 配置命令路径（最关键步骤）：在设置窗口左侧，选择“命令”。右侧会显示TeXstudio需要调用的各种编译命令的路径。TeXstudio通常会尝试自动检测，但如果检测不到或检测错误，就需要我们手动指定。
    • 你需要将各个命令的路径指向你TexLive安装目录下的bin\win32或bin\win64文件夹。例如：
      • PdfLaTeX:C:\texlive\2020\bin\win32\pdflatex.exe
      • XeLaTeX:C:\texlive\2020\bin\win32\xelatex.exe
      • LuaLaTeX:C:\texlive\2020\bin\win32\lualatex.exe
      • BibTeX:C:\texlive\2020\bin\win32\bibtex.exe
      • MakeIndex:C:\texlive\2020\bin\win32\makeindex.exe
    • 如何选择win32还是win64？通常选择win32目录下的可执行文件兼容性更好。即使你是64位系统，使用32位的引擎也完全没问题，而且能避免一些历史宏包的兼容性隐患。这是很多老手总结出的经验。
  3. 配置构建选项：在左侧选择“构建”。
    • 默认编译器：对于中文文档，我强烈推荐将“默认编译器”设置为XeLaTeX。因为XeLaTeX原生支持Unicode和系统字体，处理中文非常简单直接，无需额外的CJK宏包配置。对于纯英文文档，PdfLaTeX也是一个高效的选择。
    • 默认文献工具：设置为BibTeX即可。如果使用biblatex，则选择Biber。
    • 构建并查看：建议选择“编译后自动跳转到PDF查看器”，这样保存文件后就能自动编译并打开预览，实现“所见即所得”的流畅体验。
  4. 配置编辑器与预览：
    • 编辑器：可以设置字体、缩进（建议4个空格代替Tab）、自动换行等，根据个人习惯调整。
    • 预览：在“预览”设置中，可以选择内置的PDF查看器或外部程序（如Sumatra PDF）。内置查看器刷新快，与编辑器集成好；Sumatra PDF轻量且支持正向/反向搜索（点击PDF跳转到源码，点击源码跳转到PDF），是很多人的首选。你需要先在外部PDF查看器设置中指定Sumatra PDF的路径。

完成以上配置后，点击“确定”保存。你的TeXstudio就已经和TexLive 2020正确连接了。

4. 创建你的第一个文档：测试与验证

环境配置好了，是时候点火试车了。我们通过一个简单的文档来测试整个工作流是否畅通。

  1. 在TeXstudio中，点击“文件” -> “新建”，创建一个空白文档。
  2. 输入以下经典的测试代码，这是一个包含中文的简单文档：
%!TEX program = xelatex \documentclass[UTF8]{article} \usepackage{ctex} % 引入ctex宏包，用于中文支持 \begin{document} \title{我的第一个\LaTeX 文档} \author{你的名字} \date{\today} \maketitle \section{引言} 你好，世界！这是一个使用 \textbf{XeLaTeX} 和 \textbf{ctex} 宏包排版的简单中文文档。 \section{数学公式} 行内公式：$E = mc^2$。 独立公式： \[ \int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi} \] \end{document}
  1. 保存文件：将文件保存到一个纯英文路径下，文件名也使用英文，例如test.tex。再次强调，路径和文件名中绝对不要出现中文或空格。
  2. 编译并查看：点击工具栏上的绿色箭头（“构建并查看”，快捷键F5）。TeXstudio会按照你的配置，调用XeLaTeX编译器处理你的.tex文件。
  3. 观察输出面板：编辑器下方的“消息”面板会显示编译日志。如果一切顺利，你会看到类似“成功编译”的信息，并且右侧或弹出的PDF查看器中会显示排版好的文档，包含标题、章节和公式。

如果编译失败，消息面板会以红色文字显示错误信息。最常见的初期错误是“宏包未找到”，例如File 'ctex.sty' not found。这通常意味着：

  • 配置错误：回到“命令”设置，检查xelatex.exe的路径是否正确指向了TexLive的bin目录。
  • 宏包未安装：但ctex宏包是TexLive完整安装的一部分，如果完整安装则不应该缺失。如果确实缺失，你可以通过TexLive自带的包管理器tlmgr来安装。在命令提示符（以管理员身份运行）中输入tlmgr install ctex即可。

5. 深入配置与效率提升：从能用变好用

基础环境跑通只是第一步。要让LaTeX成为你得心应手的工具，还需要一些进阶配置和习惯养成。

5.1 配置中文环境与字体

在上面的测试中，我们使用了ctex宏包。它是一个集成的中文解决方案，默认会调用系统中存在的字体（如Windows的宋体、黑体）。如果你对字体有要求，可以进行更细致的配置。例如，使用思源宋体和思源黑体：

\documentclass[UTF8]{article} \usepackage{fontspec} \usepackage{xeCJK} \setmainfont{Times New Roman} % 设置英文主字体 \setCJKmainfont{Source Han Serif SC} % 设置中文衬线字体（思源宋体） \setCJKsansfont{Source Han Sans SC} % 设置中文无衬线字体（思源黑体） \begin{document} 中文与英文混排示例。 \end{document}

这种方式需要你的系统已安装相应字体，并提供了更灵活的字体控制。

5.2 管理宏包与更新

TexLive自带一个强大的命令行包管理器tlmgr。你可以用它来搜索、安装、更新和移除宏包。

  • 搜索宏包：tlmgr search --global --file <文件名>，例如找包含algorithm.sty的宏包。
  • 安装宏包：tlmgr install <宏包名>。
  • 更新所有宏包和TexLive自身：tlmgr update --self --all。注意：对于2020这样的固定发行版，通常不建议大规模更新，以免引入不兼容性。除非某个宏包有严重bug修复，否则保持发行版原状是最稳定的。

提示：运行tlmgr相关命令时，请始终以管理员身份打开命令提示符（Windows）或使用sudo（Linux/macOS），否则会因权限不足而失败。

5.3 TeXstudio的实用技巧与快捷键

熟练使用快捷键能极大提升编码效率：

  • F5： 构建并查看（编译并打开PDF）。
  • F6： 仅构建（编译但不打开PDF）。
  • F7： 查看（打开PDF）。
  • Ctrl + Space： 代码自动补全。
  • Ctrl + B： 为选中的文本添加粗体\textbf{}。
  • Ctrl + I： 为选中的文本添加斜体\textit{}。
  • Alt + Shift + F： 格式化代码（对齐缩进）。
  • Ctrl + 鼠标左键： 在PDF和源码之间进行正向/反向搜索（需配置好外部查看器如Sumatra PDF）。

此外，善用TeXstudio的“向导”菜单，可以快速插入表格、图片、公式、参考文献等复杂结构的代码框架。

6. 常见问题排查与解决思路

即使按照步骤操作，也可能遇到问题。这里列出几个典型场景及其解决思路。

问题一：编译时提示“无法启动PdfLaTeX”或“无法启动XeLaTeX”。

  • 排查：这是最典型的路径配置错误。请严格按照第3.2节，检查“选项”->“设置TeXstudio”->“命令”中，各个编译器路径是否正确指向了TexLive安装目录下的.exe文件。确保路径中没有中文字符。

问题二：编译中文文档时，PDF中中文显示为空白或乱码。

  • 排查：
    1. 确认文档开头的编译器指令为%!TEX program = xelatex。
    2. 确认使用了正确的宏包（ctex或xeCJK+fontspec）。
    3. 确认文件以UTF-8 无BOM格式编码保存。在TeXstudio中，默认即是此格式，但如果你用其他编辑器创建过文件，需注意检查。可以在TeXstudio右下角查看编码格式。

问题三：添加了新的宏包后编译报错“File ‘xxx.sty’ not found”。

  • 排查：
    1. 首先确认宏包名拼写是否正确。
    2. 使用tlmgr search命令确认该宏包在TexLive中的确切名称。
    3. 使用tlmgr install安装缺失的宏包。
    4. 安装后，可能需要刷新TeX的文件名数据库。在命令提示符中，进入TexLive的bin\win32目录，运行mktexlsr命令。

问题四：参考文献（BibTeX）无法编译或引用显示为问号。

  • 排查：这是一个经典的多步骤编译问题。正确的顺序是：
    1. 用XeLaTeX或PdfLaTeX编译一次.tex文件，生成.aux引用文件。
    2. 用BibTeX编译一次.aux文件（在TeXstudio中，工具栏有单独的BibTeX按钮，或使用快捷键F8），生成.bbl文献列表文件。
    3. 再次用XeLaTeX或PdfLaTeX编译两次.tex文件，以正确插入引用编号和文献列表。 在TeXstudio中，你可以使用内置的“工具”->“命令”->“BibTeX”来执行第二步，或者直接使用“构建并查看”（F5），TeXstudio会根据你的配置自动执行这个序列（例如，配置为XeLaTeX -> BibTeX -> XeLaTeX -> XeLaTeX）。

问题五：文档中插入的图片找不到。

  • 排查：
    1. 确认\includegraphics命令中的图片文件名（不含后缀）正确，且图片文件（如.png,.jpg,.pdf）存在于当前目录或指定的路径下。
    2. 图片路径中不要有中文和空格。
    3. 对于.eps等矢量图格式，可能需要额外编译引擎支持（如latex->dvips->ps2pdf），对于新手，建议先将图片转换为.pdf或.png格式，直接使用pdflatex或xelatex编译。

环境配置的稳定性是LaTeX写作愉悦度的基石。花一点时间，严格按照上述步骤搭建好TexLive 2020 + TeXstudio 2020这个经典组合，并理解其运作原理，足以让你在未来的学术写作道路上避开无数环境类的坑，把精力真正集中在内容创作本身。当你不再为编译错误而焦头烂额时，LaTeX强大的排版能力才会真正为你所用。

编程学习 学习日记 实战经验
← 返回列表