Ubuntu 24.04 安装 LaTeX + VSCode 环境指南

本文档记录在 Ubuntu 24.04 系统上安装 LaTeX 环境的完整过程。

一、安装 TeX Live

1.1 更新软件包列表

sudo apt update

1.2 安装 TeX Live 完整版

sudo apt install -y texlive-full

说明：

• 安装时间较长（约 20-40 分钟）
• 占用磁盘空间约 5-6GB
• 包含所有宏包，避免后续编译报错

1.3 验证安装

xelatex –version
pdflatex –version
bibtex –version

预期输出(输出相似即可)：

XeTeX 3.141592653-2.6-0.999995 (TeX Live 2023/Debian)
pdfTeX 3.141592653-2.6-1.40.25 (TeX Live 2023/Debian)
BibTeX 0.99d (TeX Live 2023/Debian)

二、安装 VSCode 及扩展

2.1 安装 VSCode

sudo snap install code –classic

验证安装：

code –version

2.2 安装 LaTeX Workshop 扩展

方法一：命令行安装

code –install-extension James-Yu.latex-workshop

方法二：VSCode 内安装

三、配置 VSCode

3.1 打开设置文件

3.2 添加 LaTeX 配置

在 settings.json 中添加以下配置：

{
"latex-workshop.latex.recipe.default": "xelatex -> bibtex -> xelatex*2",
"latex-workshop.latex.recipes": [
{
"name": "xelatex -> bibtex -> xelatex*2",
"tools": ["xelatex", "bibtex", "xelatex", "xelatex"]
},
{
"name": "xelatex",
"tools": ["xelatex"]
}
],
"latex-workshop.latex.tools": [
{
"name": "xelatex",
"command": "xelatex",
"args": ["-synctex=1", "-interaction=nonstopmode", "-file-line-error", "%DOC%"]
},
{
"name": "bibtex",
"command": "bibtex",
"args": ["%DOCFILE%"]
}
],
"latex-workshop.view.pdf.viewer": "tab",
"latex-workshop.latex.autoBuild.run": "onSave"
}

3.3 配置说明

四、测试环境

4.1 创建测试文件

创建文件 test.tex：

\\documentclass[12pt]{article}
\\usepackage{ctex}
\\usepackage{amsmath}
\\usepackage{geometry}

\\geometry{a4paper, margin=2.5cm}

\\title{LaTeX 环境测试文档}
\\author{测试作者}
\\date{\\today}

\\begin{document}
\\maketitle

\\section{中文测试}
这是一个中文测试文档，用于验证 LaTeX 环境是否正常工作。

中文排版测试：人工智能、深度学习、联邦学习、网络安全。

\\section{数学公式}

行内公式：爱因斯坦质能方程 $E = mc^2$

行间公式：
\\begin{equation}
\\int_{-\\infty}^{\\infty} e^{-x^2} dx = \\sqrt{\\pi}
\\end{equation}

多行公式：
\\begin{align}
f(x) &= ax^2 + bx + c \\\\
f'(x) &= 2ax + b
\\end{align}

\\section{列表测试}

\\subsection{无序列表}
\\begin{itemize}
\\item 第一项
\\item 第二项
\\item 第三项
\\end{itemize}

\\subsection{有序列表}
\\begin{enumerate}
\\item 步骤一
\\item 步骤二
\\item 步骤三
\\end{enumerate}

\\section{表格测试}

\\begin{table}[htbp]
\\centering
\\caption{测试表格}
\\begin{tabular}{|c|c|c|}
\\hline
列1 & 列2 & 列3 \\\\
\\hline
数据1 & 数据2 & 数据3 \\\\
数据4 & 数据5 & 数据6 \\\\
\\hline
\\end{tabular}
\\end{table}

\\section{结论}

如果你能看到这个 PDF 文件，说明 LaTeX 环境配置成功！

\\end{document}

4.2 编译测试

方法一：命令行编译

cd /home/myx/pythonfiles/hzx/Thesis
xelatex -synctex=1 -interaction=nonstopmode test.tex

方法二：VSCode 自动编译

• 在 VSCode 中打开 test.tex
• 保存文件（Ctrl+S）会自动编译
• 按 Ctrl+Alt+V 预览 PDF

4.3 预期结果

编译成功后生成以下文件：

五、常用快捷键

六、常见问题

6.1 中文显示问题

确保使用 xelatex 编译，并添加 ctex 宏包：

\\usepackage{ctex}

6.2 字体警告

如果出现字体警告，可以安装额外字体：

sudo apt install fonts-noto-cjk fonts-noto-cjk-extra

6.3 编译错误

查看 .log 文件定位错误，或在 VSCode 底部面板查看 LaTeX Workshop 输出。

6.4 清理临时文件

rm -f *.aux *.log *.out *.toc *.synctex.gz *.bbl *.blg

七、毕业论文模板

7.1 获取学校模板

7.2 常用模板资源

八、参考文献管理

8.1 推荐工具

• Zotero：免费开源的文献管理工具
• 导出格式：导出为 .bib 文件供 LaTeX 使用

8.2 BibTeX 使用

在 LaTeX 文档中引用：

\\bibliographystyle{plain}
\\bibliography{references} % 引用 references.bib 文件

九、安装信息汇总

十、目录结构

/home/hzx/pythonfiles/myx/Thesis/
├── test.tex # 测试源文件
├── test.pdf # 生成的 PDF
├── test.aux # 辅助文件
├── test.log # 编译日志
├── test.synctex.gz # 同步文件
└── Ubuntu安装LaTeX环境指南.md # 本文档