LaTeX Tex Live 安装

整理一下 Tex Live 2025 在 Windows 和 Linux（Ubuntu22）中的安装过程，主要参考 TeX Live 2025 安装教程（Windows/WSL/Linux）以及一份简短的关于 LATEX 安装的介绍。

在 Linux 系统上的 LaTeX 编译速度普遍比 Windows 更快，而且速度提升非常明显，并且 TexLive 的安装也是如此，在 Linux 中的安装过程比 Windows 更快，这种优势即使是在 WSL2 中也是很明显的，因此可以选择在 Windows 和 WSL2 中都进行安装。

下载Texlive镜像

随便找一个 CTAN 镜像站下载 texlive2025 即可，例如清华镜像。 texlive 的下载安装其实非常友好，在不同系统上都只需要同一个镜像文件（texlive2025.iso，大约 6 个 G）。

安装Texlive

Windows

直接点击 install-tl-windows.bat 脚本即可安装，默认有 GUI 显示，根据提示进行确认即可。其实也可以加上 --no-gui 选项关掉 GUI，此时的安装过程和 Linux 类似。

GUI设置部分，最好重新设置一下安装目录，例如 D:/texlive/2025。尤其需要注意的是：Texlive 的安装目录以及用户主目录不能含有任何的空格或者中文字符，否则会导致安装失败。如果用户名称含有中文或空格，在安装之前需要修改 TEMP 和 TMP 环境变量，使安装程序绕过这些特殊路径。

安装过程大约几十分钟，安装完成之后会自动将对应路径添加到用户级别的环境变量最后，例如

1	D:/texlive/2025/bin/windows

安装完成之后，测试一下

tex -v

正常输出版本信息即可。

Linux

实践中是在 WSL2 中进行安装的，首先要挂载镜像，这里假设镜像文件存放在 Windows 的 D 盘根目录中，通过如下命令挂载

1 2	sudo mkdir /mnt/texlive sudo mount /mnt/d/texlive2025.iso /mnt/texlive

可能会出现警告：挂载的文件是写保护的，这个警告无所谓，我们的安装过程只需要读取权限。

这里的安装过程都是需要 sudo 权限的，也可以直接切换到 root 用户进行；如果使用普通用户安装，那么相应的路径都需要修改。

直接调用 install-tl 进行安装

1	sudo /mnt/texlive/install-tl

此时可以看到如下内容，提示选择安装组件

======================> TeX Live installation procedure <=====================

======>   Letters/digits in <angle brackets> indicate   <=======
======>   menu items for actions or customizations      <=======
= help>   https://tug.org/texlive/doc/install-tl.html   <=======

 Detected platform: GNU/Linux on x86_64

 <B> set binary platforms: 1 out of 6

 <S> set installation scheme: scheme-full

 <C> set installation collections:
     40 collections out of 41, disk space required: 7599 MB (free: 970831 MB)

 <D> set directories:
   TEXDIR (the main TeX directory):
     /usr/local/texlive/2025
   TEXMFLOCAL (directory for site-wide local files):
     /usr/local/texlive/texmf-local
   TEXMFSYSVAR (directory for variable and automatically generated data):
     /usr/local/texlive/2025/texmf-var
   TEXMFSYSCONFIG (directory for local config):
     /usr/local/texlive/2025/texmf-config
   TEXMFVAR (personal directory for variable and automatically generated data):
     ~/.texlive2025/texmf-var
   TEXMFCONFIG (personal directory for local config):
     ~/.texlive2025/texmf-config
   TEXMFHOME (directory for user-specific files):
     ~/texmf

 <O> options:
   [ ] use letter size instead of A4 by default
   [X] allow execution of restricted list of programs via \write18
   [X] create all format files
   [X] install macro/font doc tree
   [X] install macro/font source tree
   [ ] create symlinks to standard directories
   [X] after install, set CTAN as source for package updates

 <V> set up for portable installation

Actions:
 <I> start installation to hard disk
 <P> save installation profile to 'texlive.profile' and exit
 <Q> quit

Enter command:

这里可以选择自定义的搭配方案，删去其中不常用的组件，后续可以单独进行下载，这样做可以节约空间。但是我为了避免潜在的麻烦，直接选择全部安装，输入 I 即可进行安装，安装过程大约二十分钟。（肯定比 Windows 快一点）

输入 D 可以修改安装目录，但是在 Linux 中不建议修改安装目录，全局安装使用默认的 /usr/local/texlive/2025 即可。

安装完成之后，根据它的提示，需要手动将几个路径添加到对应的环境变量中

# Add TeX Live to the PATH, MANPATH, INFOPATH
export PATH="/usr/local/texlive/2025/bin/x86_64-linux:$PATH"
export MANPATH="/usr/local/texlive/2025/texmf-dist/doc/man:$MANPATH"
export INFOPATH="/usr/local/texlive/2025/texmf-dist/doc/info:$INFOPATH"

将这几行命令写在 ~/.bashrc 文件中即可，如果使用 fish 或者其它的 shell，还需要进行相应调整。

重新加载 bash 的配置文件，测试一下

tex -v

正常输出版本信息即可。

移除镜像（事实上系统重启之后就自动移除了挂载）

1 2	sudo umount /mnt/texlive # 注意不是unmount! sudo rm -r /mnt/texlive

字体配置

下面的命令可以在 Linux 中查看当前 texlive 可以识别的所有中文字体（在 Windows 也可以使用，但是似乎不支持 :lang=zh 参数）

1	fc-list -f "%{family}\n" :lang=zh > zhfont.txt

对于 Linux，在安装完成之后需要拷贝字体并刷新字体缓存

1 2	sudo cp /usr/local/texlive/2025/texmf-var/fonts/conf/texlive-fontconfig.conf /etc/fonts/conf.d/09-texlive.conf sudo fc-cache -fsv

在 Windows 上安装字体的过程非常简单，但是注意需要选择全局安装。实践中安装了几个免费的方正字体，还有开源的思源字体等，可以通过查看所有可用中文字体的方式来检查。

在 Linux 上安装字体的过程参考 ubuntu 安装 ttf 字体

su - root

cd /usr/share/fonts
mkdir fz-font

cp <ttk files> fz-font/
cd fz-font
chmod 644 *.ttf

fc-cache -fv

WSL2 可以直接利用 Windows 已经全局安装的所有字体（字体都在 c:/Windows/Fonts 目录下），做法如下：

确保安装了 fontconfig：sudo apt install fontconfig

新建文件 /etc/fonts/local.conf，内容如下

<?xml version="1.0"?>
<!DOCTYPE fontconfig SYSTEM "fonts.dtd">
<fontconfig>
    <dir>/mnt/c/Windows/Fonts</dir>
</fontconfig>

刷新字体缓存：sudo fc-cache -fv

注意：基于 ctex 宏包编译输出 PDF 时，默认采取的中文字体是与平台相关的，Windows 和 Linux 的默认中文字体（尤其是粗体）明显不一样，Overleaf 等在线平台实质部署在 Linux 服务器上，因此默认行为属于 Linux 类别。

编译测试

基本的英文文档示例

\documentclass{article}

\title{LaTeX Test}
\date{\today}
\author{}

\begin{document}

\maketitle

Hello, world!

\end{document}

执行如下命令进行编译测试

1
2
3

pdflatex main.tex
# or
latexmk -pdf -auxdir=tmp main.tex

基本的中文文档示例

\documentclass{ctexart}

\title{LaTeX 测试}
\date{\today}
\author{}

\begin{document}

\maketitle

你好世界！

\end{document}

执行如下命令进行编译测试

1
2
3

xelatex main.tex
# or
latexmk -xelatex -auxdir=tmp main.tex

查看文档

使用 texdoc 命令可以查看当前 texlive 附带的 pdf 文档，通常是一些宏包的说明文档，例如

1 2	texdoc listings texdoc xcolor

此外，一些著名的中文文档也可以通过 texdoc 命令查看，例如

1 2	texdoc lshort-zh-cn texdoc install-latex-guide-zh-cn

卸载Texlive

不建议对 Texlive 进行升级操作，升级容易出现各种问题，推荐的做法是直接卸载旧版本，然后安装新版本。（或者多个版本共存，设置好环境变量即可）

Windows

执行 texlive/2025/tlpkg/installer/uninst.bat 脚本来进行卸载，卸载完成之后，当前 TexLive 的安装目录中的内容会被完全删除，但是还剩下一些空目录，手动删除即可。

可以删除 ~/.texlive2025 目录，然后可以顺便检查一下环境变量和注册表，似乎环境变量中的相关路径会被自动删除，注册表不清理看起来也没啥问题。

Linux

对于在默认安装位置进行的安装，直接删除整个目录即可

1	sudo rm -rf /usr/local/texlive/2025

同时删除 ~/.bashrc 或其它配置脚本中的相关内容。

补充

实践中遇到了在 Linux 中使用 VSCode 的 Latex workshop 插件无法支持格式化的问题，报错信息显示是缺少了某些 Perl 模块，因此手动进行下载（在普通用户下执行的，暂不清楚这个命令的安装是否是全局的，root 用户执行是否有区别）

1 2	cpan YAML::Tiny cpan File::HomeDir

下载完成后可以正常进行格式化。

在编译 LaTeX 文件时有时需要进行 eps 文件到 PDF 文件的转换，在 Linux 系统上可能需要 ghostscript 软件，某些发行版并不自带这个软件，编译报错形如

1	!! Error: Required program gs not found in PATH

手动安装一下 ghostscript 即可

1	sudo apt-get install ghostscript

顺便关注一下在 WSL2 中如何查看编译得到的 pdf 文件：

可以直接使用 VSCode 的内置 pdf 浏览器查看
在命令行中也可以直接调用 Windows 上的SumatraPDF.exe，注意需要在 Windows 系统中把它的路径加入 PATH 环境变量。
1
SumatraPDF.exe main.pdf
根据参考的博客推荐，还有一种 Linux 下的轻量级 PDF 浏览器（比 SumatraPDF 更轻量级），支持 vim 风格的键位，鉴于 WSLg 可以支持简单的 GUI 了，因此也尝试一下（但是感觉并不好用）
1
2
apt install zathura
zathura main.pdf