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 |
安装完成之后,测试一下
1 | tex -v |
正常输出版本信息即可。
Linux
实践中是在 WSL2 中进行安装的,首先要挂载镜像,这里假设镜像文件存放在 Windows 的 D 盘根目录中,通过如下命令挂载
1 | sudo mkdir /mnt/texlive |
可能会出现警告:挂载的文件是写保护的,这个警告无所谓,我们的安装过程只需要读取权限。
这里的安装过程都是需要
sudo权限的,也可以直接切换到 root 用户进行;如果使用普通用户安装,那么相应的路径都需要修改。
直接调用 install-tl 进行安装
1 | sudo /mnt/texlive/install-tl |
此时可以看到如下内容,提示选择安装组件
1 | ======================> TeX Live installation procedure <===================== |
这里可以选择自定义的搭配方案,删去其中不常用的组件,后续可以单独进行下载,这样做可以节约空间。
但是我为了避免潜在的麻烦,直接选择全部安装,输入 I 即可进行安装,安装过程大约二十分钟。(肯定比 Windows 快一点)
输入
D可以修改安装目录,但是在 Linux 中不建议修改安装目录,全局安装使用默认的/usr/local/texlive/2025即可。
安装完成之后,根据它的提示,需要手动将几个路径添加到对应的环境变量中
1 | # Add TeX Live to the PATH, MANPATH, INFOPATH |
将这几行命令写在 ~/.bashrc 文件中即可,如果使用 fish 或者其它的 shell,还需要进行相应调整。
重新加载 bash 的配置文件,测试一下
1 | tex -v |
正常输出版本信息即可。
移除镜像(事实上系统重启之后就自动移除了挂载)
1 | sudo umount /mnt/texlive # not unmount! |
字体配置
下面的命令可以在 Linux 中查看当前 texlive 可以识别的所有中文字体(在 Windows 也可以使用,但是似乎不支持 :lang=zh 参数)
1 | fc-list -f "%{family}\n" :lang=zh > zhfont.txt |
对于 Linux,在安装完成之后需要拷贝字体并刷新字体缓存
1 | sudo cp /usr/local/texlive/2025/texmf-var/fonts/conf/texlive-fontconfig.conf /etc/fonts/conf.d/09-texlive.conf |
在 Windows 上安装字体的过程非常简单,但是注意需要选择全局安装。
实践中安装了几个免费的方正字体,还有开源的思源字体等,可以通过查看所有可用中文字体的方式来检查。
在 Linux 上安装字体的过程参考 ubuntu 安装 ttf 字体
1 | su - root |
WSL2 可以直接利用 Windows 已经全局安装的所有字体(字体都在 c:/Windows/Fonts 目录下),做法如下:
- 确保安装了 fontconfig:
sudo apt install fontconfig - 新建文件
/etc/fonts/local.conf,内容如下
1 |
|
- 刷新字体缓存:
sudo fc-cache -fv
注意:基于 ctex 宏包编译输出 PDF 时,默认采取的中文字体是与平台相关的,Windows 和 Linux 的默认中文字体(尤其是粗体)明显不一样,Overleaf 等在线平台实质部署在 Linux 服务器上,因此默认行为属于 Linux 类别。
编译测试
基本的英文文档示例
1 | \documentclass{article} |
执行如下命令进行编译测试
1 | pdflatex main.tex |
基本的中文文档示例
1 | \documentclass{ctexart} |
执行如下命令进行编译测试
1 | xelatex main.tex |
查看文档
使用 texdoc 命令可以查看当前 texlive 附带的 pdf 文档,通常是一些宏包的说明文档,例如
1 | texdoc listings |
此外,一些著名的中文文档也可以通过 texdoc 命令查看,例如
1 | texdoc lshort-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 | cpan YAML::Tiny |
下载完成后可以正常进行格式化。
在编译 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 | apt install zathura |
