睡前读物第2期: WSL上的TeX Live安装
TeX Live 简介
TeX Live 是一个跨平台的 TeX 发行版，包含了大量的 TeX 宏包、字体和工具，适用于各种操作系统，包括 Windows、Linux 和 macOS。 它是 LaTeX 用户的首选发行版，提供了丰富的功能和良好的兼容性。 相比在 Windows 上安装 TeX Live，WSL 提供了一个更接近 Linux 的环境，使得安装和管理 TeX Live 更加方便，并且在编译速度和兼容性上表现更好。
安装之前
安装前的准备
你要确保你已经安装并配置好了 WSL。如果你还没有安装 WSL，可以参考微软的官方文档进行安装和配置。 本文将以我正在使用的 Ubuntu 24.04 LTS 作为示例。 并且我将使用 VSCode 作为主要的 LaTeX 编辑器。
下载安装镜像
你可以选择从国内的 CTAN 镜像站点下载 TeX Live 安装镜像，以提高下载速度，
比如 清华大学开源软件镜像站。
下载完毕后，你可以把它随意的放在任意的 Windows 文件夹下，比如 D:\Downloads\texlive.iso。
你可以通过校验 MD5 值来验证文件是否正确下载。
挂载 ISO 镜像
现在打开 WSL 终端，创建一个挂载点，并将 ISO 文件挂载到该目录下：
sudo mkdir /mnt/texlive
sudo mount /mnt/d/texlive.iso /mnt/texlive
安装过程
启动安装程序
通过一下命令启动 TeX Live 安装程序：
sudo /mnt/texlive/install-tl
随后根据提示进行安装即可。
调整安装配置
在安装时想要自定义配置的话，请输入 C 进入自定义配置界面。
实际上 TeX Live 的默认配置包括的宏包、字体等由于数量太多，会占用大量的磁盘空间。
如果你不需要安装所有的宏包，可以根据指示取消勾选不需要的宏包。
以下是我个人的配置，可以快捷复制来取消勾选：
deghjkstuvwyznoABCEHIKLMNS
随后按 R 返回主菜单，按 I 开始安装。
安装善后
清理残留
安装完成后，卸载挂载点并删除挂载目录：
sudo umount /mnt/texlive
sudo rm -r /mnt/texlive
设置环境变量
之后，你需要更新环境变量，以便相对应的程序与命令可以在终端中直接使用。
编辑 ~/.bashrc 文件，添加以下内容：
# TeX Live PATH Environment Variables
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
保存退出，重启 WSL 终端或者执行 source ~/.bashrc 使配置生效。
然后可以通过执行 tex --version 来验证 TeX Live 是否安装成功。
卸载 TeX Live
如果你需要卸载 TeX Live，可以通过以下命令：
sudo `which tlmgr` uninstall --all
sudo rm -rf /usr/local/texlive/2025
详细步骤请参考 TeX Live 官方中文文档。
使用过程
使用 VSCode 编辑文档
安装 LaTeX Workshop 插件来支持 LaTeX 文档的编辑和编译。
接下来，只要直接在 VSCode 中打开 LaTeX 文档，使用快捷键 Ctrl + Alt + B 即可编译文档， Ctrl + Alt + V 即可浏览文档。
在 VSCode 中，你可以通过 settings.json 文件来配置 LaTeX Workshop 的相关设置。
以下是一些常用的配置示例：
{
"latex-workshop.latex.recipe.default": "latexmk (xelatex)",
"latex-workshop.latex.autoBuild.run": "never",
"editor.wordWrap": "off",
"latex-workshop.view.pdf.invertMode.enabled": "never",
"latex-workshop.view.pdf.invert": 0.9,
"latex-workshop.formatting.latex": "latexindent",
"latex-workshop.latex.outDir": "%WORKSPACE_FOLDER%/build/%DOCFILE%/"
}
Windows 字体
某些使用 Windows 字体的中文文档可能在 Linux 上无法正常编译，通常这需要在系统中安装所需的字体。 然而，WSL 上有个更简单的方法，就是使用软链接直接将宿主 Windows 的字体目录链接到 WSL 的字体目录中。 以下命令会将 Windows 字体目录链接到 WSL 的字体目录中，并更新字体缓存：
sudo ln -s /mnt/c/Windows/Fonts /usr/local/share/fonts/WindowsFonts
fc-cache -fv
格式化文档
在 VSCode 中要格式化 LaTeX 文档时，一般会采用 latexindent 工具。
如果你没有安装，可以通过以下命令安装：
sudo cpan Log::Log4perl
sudo cpan Log::Dispatch
sudo cpan YAML::Tiny
sudo cpan File::HomeDir
sudo cpan Unicode::GCString