LaTeX - （二）如何安装LaTeX

环境说明

本文主要针对 Windows 10环境进行安装 \(\TeX\, Live\)，关于其他的 \(\LaTeX\) 发行版和不同安装环境可以参考以下链接：

• texlive-zh-cn.pdf (tug.org)- \(\TeX\,Live\) 指南
• install-latex-guide-zh-cn.pdf (ctan.org) - 一份简短的关于 \(\LaTeX\) 安装的介绍
• TeX Live - TeX Users Group (tug.org) - 官方文档

如果不清楚想要安装什么发行版，可以先阅读上面给出的文档，里面有关于发行版之间的区别。

卸载旧 \(\TeX \, Live\) 的版本

在跨版本升级 \(\TeX\, Live\) 时，由于在 Windows 10 下没有类 Unix 的升级程序，需要进行重新安装。下面介绍几种卸载方法。

使用批处理文件

如果之前已经安装过 \(\TeX \, Live\)，需要先卸载当前的版本，下载新版本，我这里已经安装了 \(\TeX \, Live\, 2023\)，我想要安装 \(\TeX \, Live\, 2024\)，所以要先进行卸载，如果之前没有安装过可以跳过这一步。

在这里参考文档1.2节的内容进行操作：

命令行执行：

kpsewhich -var-value TEXMFROOT

可以查看 TEXMFROOT 的值，该值即为 \(\TeX\, Live\) 的安装路径，接下来执行安装路径中的卸载批处理文件即可执行卸载，如默认安装时执行：

C:\texlive\2024\tlpkg\installer\uninst.bat

需要注意的点：

• 这里可能存在两个 uninst.bat，先点击 uninst.bat 再点击 uninst2.bat
• 如果没有任何反应，需要你在命令操作界面随机点击一个按键开始卸载程序

然后就静静等待卸载结束了。结束以上步骤后，手动删除用户文件夹^[1]中的 .texlive2024。

卸载后，用户需要清理注册表，按下 Win徽标键+R 输入 regedit，清除以下内容（这里以卸载 \(\TeX \, Live\, 2024\) 为例：

HKEY_CURRENT_USER\Software\Classes\TL.bitmap2eps.convert.2024
HKEY_CURRENT_USER\Software\Classes\TL.DVIOUT.view.2024
HKEY_CURRENT_USER\Software\Classes\TL.TeXworks.edit.2024
HKEY_CURRENT_USER\Software\Classes\TL.PSViewer.view.2024
HKEY_CURRENT_USER\SOFTWARE\Microsoft\Windows\CurrentVersion\ApplicationAssociationToasts\TL.bitmap2eps.convert.2024_.jpg HKEY_CURRENT_USER\SOFTWARE\Microsoft\Windows\CurrentVersion\ApplicationAssociationToasts\TL.bitmap2eps.convert.2024_.png
HKEY_CURRENT_USER\SOFTWARE\Microsoft\Windows\CurrentVersion\ApplicationAssociationToasts\TL.TeXworks.edit.2024_.sty
HKEY_CURRENT_USER\SOFTWARE\Microsoft\Windows\CurrentVersion\ApplicationAssociationToasts\TL.TeXworks.edit.2024_.tex

如果在安装时使用管理员权限”为所有人安装“，则注册表位置变为：

HKEY_LOCAL_MACHINE\SOFTWARE\Classes\TL.bitmap2eps.convert.2024
HKEY_LOCAL_MACHINE\SOFTWARE\Classes\TL.DVIOUT.view.2024
HKEY_LOCAL_MACHINE\SOFTWARE\Classes\TL.TeXworks.edit.2024
HKEY_LOCAL_MACHINE\SOFTWARE\Classes\TL.PSViewer.view.2024

手动卸载

如果执行批处理文件 uninst.bat 出错，用户也可以手动删除安装文件夹，之后再清理 \(\TeX\, Live\) 的环境变量，并且清理注册表。

开始安装

下载安装镜像^[2]

到某个国内的 CTAN 镜像站下载最新版的 \(\TeX \,Live\) 镜像，比如清华大学开源软件镜像站。

目前最新的 \(\TeX \,Live\) 版本为 2024，该文件夹下包含 3 个 .iso 文件，这 3 个文件仅有文件名不同，内容完全相同，你可以任选一个下载。该文件夹下还包含有 md5 摘要文件，你也可以下载下来以备校验。后面会提供 2024 版 \(\TeX \,Live\) 镜像的 md5 值。

校验安装镜像

这一步是可选的，主要是检查下载过程中镜像有没有出现损坏，以及镜像是否被第三方篡改过。实际上现在的网络条件很好了，一般不会出问题。如果从正规的镜像站下载，也不必担心篡改的问题。

在 PowerShell 中切换到镜像所在的文件夹（例： D:\），然后执行

certutil -hashfile texlive2024.iso md5

md5 计算需要完整读取整个镜像文件，因此计算会持续一段时间，取决于你机器的运算速度和硬盘读取速度，请耐心等待。

如果是正确的版本并且没有被篡改，你应该可以得到 \(\TeX\, Live \,2024\) 镜像文件的 md5 值 a54f5524e51267dee37e72e3b3fd31c4。

图形化安装

这部分内容可以参考最新2024版LaTeX安装教程【LaTeX环境与编译器安装到位】【论文排版必备】【图解超详细】_latex编辑器-CSDN博客。接下来就是耐心等待安装完成，这个过程会比较久。

最后在命令行中输入 tex -version，如果显示了版本的信息就说明安装成功了，比如成功安装 \(\TeX \, Live \,2024\) 会显示如下的信息：

(base) PS C:\> tex -version
TeX 3.141592653 (TeX Live 2024)
kpathsea version 6.4.0
Copyright 2024 D.E. Knuth.
There is NO warranty.  Redistribution of this software is
covered by the terms of both the TeX copyright and
the Lesser GNU General Public License.
For more information about these matters, see the file
named COPYING and the TeX source.
Primary author of TeX: D.E. Knuth.

升级宏包

安装完成后，用户可以升级宏包以获得更好的使用体验。下面将介绍使用命令行升级宏包的方法。打开 cmd 窗口，首先执行下面命令指定升级使用的镜像源。ctan 表示系统在升级时将自动寻求最近的源进行下载。

tlmgr option repository ctan

接下来, 用户执行命令：

tlmgr update --list

可查看目前源上可升级的宏包都有哪些。高级用户可以根据自己的需求选择升级特定宏包。建议初级用户直接升级全部宏包。用户只需执行：

tlmgr update --self --all

同时升级 tlmgr 本身和全部宏包。

References

1. 用户文件夹一般是指当前计算机系统为多用户环境专设的不同用户所各自私有的文件夹，比如我的用户名叫 Beta，那么用户文件夹一般是 C:。 ↩︎
2. TeX Live 2024 安装教程（Windows/WSL/Linux） - Eslzzyl - 博客园 (cnblogs.com) ↩︎