前言
本篇教程是针对WSL下的Ubuntu操作系统的配置教程，它和一般的Linux环境下的配置有所不同，并且和Windows环境下的也有所不同。
本篇博客编写参考了 官方文档（Tex） 和 插件官方（Texlive Workshop） 文档等内容。
顺序
在继续之前，首先要求已经安装完毕VsCode，并且已经能够成功连接WSL。
选择Linux系统的原因是，似乎在Linux下编译会更快？（
下面，本文将安装以下步骤介绍：
（1）安装 Texlive linux版本
（2）安装 Texlive Workshop插件
（3）配置 Texlive Workshop插件 包含解释与基础操作
（4）中文化支持 - CTex
（5）格式化支持和配置
安装Texlive和Texlive Workshop插件
安装texlive
Reference: https://tug.org/texlive/quickinstall.html
使用两种方式下载：
wget https://mirror.ctan.org/systems/texlive/tlnet/install-tl-unx.tar.gz
或者使用这种方式下载：
curl -L -o install-tl-unx.tar.gz https://mirror.ctan.org/systems/texlive/tlnet/install-tl-unx.tar.gz
下载完成后，执行以下的步骤，zcat可以用于显示压缩包的内容。
zcat < install-tl-unx.tar.gz | tar xf -
cd install-tl-*
perl ./install-tl --no-interaction
如果安装过程中遇到问题，请检查文件权限，例如可以使用chmod来修改。
在安装的过程中，可以自定义一些配置，小熊自己是选择全部安装的，占8个GB左右大小，所以就不在安装这里进行配置讲解。
（Reference：https://github.com/James-Yu/LaTeX-Workshop/wiki/Install）
安装完毕后，现在开始配置PATH环境变量。
对于WSL而言，不要使用.bashrc来配置PATH，而是使用.profile或者.bash_profile文件。
nano ~/.profile # 你也可以使用自己喜欢的文本编辑器来修改文件，使用GUI也行
在文件末尾修改：
# 配置Texlive Powerbear
export MANPATH=${MANPATH}:/usr/local/texlive/2024/texmf-dist/doc/man
export INFOPATH=${INFOPATH}:/usr/local/texlive/2024/texmf-dist/doc/info
export PATH=${PATH}:/usr/local/texlive/2024/bin/x86_64-linux
如果您是后来者，当前已经是2025年了，而且安装的是2025的版本，请将上面的2024修改为2025。
如果是nano，最后按住Ctrl+X来离开，和写入文件。
之后使用：
source ~/.profile
或者在powershell / windows终端 里面，利用重启WSL的方式来更新。
wsl --shutdown
插件安装
✔️确保已经在Linux系统下安装完毕texlive前提下，继续。
✔️确保已经安装VsCode和了解基础操作的前提下，继续。
有两种方法以供参考：
（1）在Vscode插件市场搜索“Texlive Workshop”，然后点击“安装”按钮。
（2）按住Ctrl + P，然后输入ext install latex-workshop。
插件配置
当插件安装完成后，还不能直接运行，还有几个步骤需要配置。当配置完毕这些操作后，便可以方便的进行一些操作了。
Compiler & Recipes
在继续之前，先来了解此项配置的相关含义和包含关系。编译器配置是用于TEX文件编译时的相关操作，而Recipe是方案，它能包含多个编译器配置，在Tex插件面板上（左侧最后的TEX按钮）可以通过GUI的方式来调用Recipe。
所以，现在我们开始配置编译相关操作，和Recipe设置。打开VsCode的Settings.json文件（通过 文件 -> 首选项 -> 设置 ，或者 Ctrl+shift+p 打开命令面板，搜索“> 设置 json” 或者 在打开的文件夹下 .vscode 下新建settings.json）。
本文章配置在 设置WSL（JSON） 下 。
如果不想麻烦，直接参考这个小节的最后部分，那个地方给出了一份配置参考文件。可以在其上进行一些自定义的修改。
✔️确保已经打开Settings.json的前提下，继续。
- 配置TEX编译器相关操作：
在Ubuntu下，打开终端。
再次配置Recipe的相关设置：
Settings.json文件参考
不想看上文的直接参考这个地方的内容。
{
// Latex 文件处理
"latex-workshop.latex.tools": [
{
"name": "latexmk",
"command": "latexmk",
"args": [
"--shell-escape",
"-synctex=1",
"-interaction=nonstopmode",
"-file-line-error",
"-pdf",
"-outdir=%OUTDIR%",
"%DOC%"
],
"env": {}
},
{
"name": "xelatex",
"command": "xelatex",
"args": [
"--shell-escape",
"-synctex=1",
"-interaction=nonstopmode",
"-file-line-error",
"%DOC%"
]
},
{
"name": "pdflatex",
"command": "pdflatex",
"args": [
"--shell-escape",
"-synctex=1",
"-interaction=nonstopmode",
"-file-line-error",
"%DOC%"
],
"env": {}
},
{
"name": "bibtex",
"command": "bibtex",
"args": [
"--shell-escape",
"%DOCFILE%"
],
"env": {}
}
],
"latex-workshop.latex.autoBuild.cleanAndRetry.enabled": true,
// Recipes : 食谱，在这里配置命令方案
"latex-workshop.latex.recipes": [
{
"name": "xelatex (中文支持)",
"tools": [
"xelatex"
]
},
{
"name": "latexmk",
"tools": [
"latexmk"
]
},
{
"name": "pdflatex -> bibtex -> pdflatex*2",
"tools": [
"pdflatex",
"bibtex",
"pdflatex",
"pdflatex"
]
}
],
"latex-workshop.latexindent.path": "/usr/local/texlive/2024/bin/x86_64-linux/latexindent",
"latex-preview.command": "latexmk",
"editor.tabSize": 4,
"latex-workshop.view.pdf.viewer": "tab",
"latex-workshop.showContextMenu": true,
"ltex.enabled": true,
"ltex.language": "en-US",
}
配置完成后，在编辑器的界面应该是如下图所示：
到这一步，现在应该已经能够支持latex的编译与预览了。
使用这些来测试一下效果吧！
\documentclass{article}
\begin{document}
Hello latex.
\end{document}
完成后，点击左侧的 配方xelatex试一试
中文化支持配置
在经过上一小节的配置后，实际上默认的是xelatex。
然后使用
\usepackage{ctex}
把上文的Hello latex改为中文字符试一试吧。
格式化支持和配置
当以前没有配置过Perl的时候，尝试进行格式化操作时候会出现以下提示信息：
[20:20:12.751][Event] STRUCTURE_UPDATED
[20:20:14.083][Format][TeX] Start formatting with latexindent.
[20:20:14.084][Format][TeX] Formatting LaTeX. The command is /usr/local/texlive/2024/bin/x86_64-linux/latexindent:["-c","%WS1%/","%WS1%/__latexindent_temp_main_2.tex","-y=defaultIndent: ' '"].
[20:20:14.131][Format][TeX] Formatting failed with exit code 2
[20:20:14.132][Format][TeX] stderr: Can't locate YAML/Tiny.pm in @INC (you may need to install the YAML::Tiny module)(@INC contains: /usr/local/texlive/2024/texmf-dist/scripts/latexindent /etc/perl /usr/local/lib/x86_64-linux-gnu/perl/5.34.0 /usr/local/share/perl/5.34.0 /usr/lib/x86_64-linux-gnu/perl5/5.34 /usr/share/perl5 /usr/lib/x86_64-linux-gnu/perl-base /usr/lib/x86_64-linux-gnu/perl/5.34 /usr/share/perl/5.34 /usr/local/lib/site_perl) at /usr/local/texlive/2024/texmf-dist/scripts/latexindent/LatexIndent/GetYamlSettings.pm line 24.
BEGIN failed--compilation aborted at /usr/local/texlive/2024/texmf-dist/scripts/latexindent/LatexIndent/GetYamlSettings.pm line 24.
Compilation failed in require at /usr/local/texlive/2024/texmf-dist/scripts/latexindent/LatexIndent/Verbatim.pm line 23.
BEGIN failed--compilation aborted at /usr/local/texlive/2024/texmf-dist/scripts/latexindent/LatexIndent/Verbatim.pm line 23.
Compilation failed in require at /usr/local/texlive/2024/texmf-dist/scripts/latexindent/LatexIndent/Lines.pm line 23.
BEGIN failed--compilation aborted at /usr/local/texlive/2024/texmf-dist/scripts/latexindent/LatexIndent/Lines.pm line 23.
Compilation failed in require at /usr/local/texlive/2024/texmf-dist/scripts/latexindent/LatexIndent/Document.pm line 31.
BEGIN failed--compilation aborted at /usr/local/texlive/2024/texmf-dist/scripts/latexindent/LatexIndent/Document.pm line 31.
Compilation failed in require at /usr/local/texlive/2024/bin/x86_64-linux/latexindent line 28.
BEGIN failed--compilation aborted at /usr/local/texlive/2024/bin/x86_64-linux/latexindent line 28.
[20:20:22.200][Event] STRUCTURE_UPDATED
解决方法：利用cpan安装缺少的模块。
Reference： https://github.com/James-Yu/LaTeX-Workshop/issues/699
可能需要多次使用cpan命令安装缺少的模块。
cpan YAML::Tiny
cpan File::HomeDir
之后，再次执行Format时候，就能成功格式化文档了。
接下来
下面，读者应该去了解更多有关latex的使用方法，语法和其他操作姿势。
例如：如何优美的插入代码和公式？如何去绘制三线图表？等。
若觉得此文对您有帮助，请予以一个赞以示鼓励！
如果阅读完毕尚有疑问，建议，直接在评论区开喷即可！
PowerBear 大千小熊 2024年
