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 内安装

1. 打开 VSCode
2. 按 Ctrl+Shift+X 打开扩展面板
3. 搜索 LaTeX Workshop
4. 点击安装

三、配置 VSCode

3.1 打开设置文件

1. 按 Ctrl+Shift+P
2. 输入 settings json
3. 选择 Preferences: Open User Settings (JSON)

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 获取学校模板

1. 学校研究生院官网：查找官方 LaTeX 模板
2. GitHub 搜索：学校名 + thesis（如 THUThesis、BUAAThesis）
3. LaTeX 开源小屋：https://github.com/latexstudio

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   # 本文档