Ubuntu 24.04 安装 LaTeX + VSCode 环境指南

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

一、安装 TeX Live

1.1 更新软件包列表

bash 复制代码

sudo apt update

1.2 安装 TeX Live 完整版

bash 复制代码

sudo apt install -y texlive-full

说明：

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

1.3 验证安装

bash 复制代码

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

bash 复制代码

sudo snap install code --classic

验证安装：

bash 复制代码

code --version

2.2 安装 LaTeX Workshop 扩展

方法一：命令行安装

bash 复制代码

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

方法二：VSCode 内安装

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

三、配置 VSCode

3.1 打开设置文件

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

3.2 添加 LaTeX 配置

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

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 配置说明

配置项	说明
`recipe.default`	默认编译方案：xelatex → bibtex → xelatex × 2
`recipes`	编译方案列表
`tools`	编译工具定义
`view.pdf.viewer`	PDF 在 VSCode 标签页中预览
`autoBuild.run`	保存时自动编译

四、测试环境

4.1 创建测试文件

创建文件 test.tex：

latex 复制代码

\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 编译测试

方法一：命令行编译

bash 复制代码

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 预期结果

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

文件	说明
test.pdf	生成的 PDF 文档
test.aux	辅助文件
test.log	编译日志
test.synctex.gz	同步定位文件

五、常用快捷键

快捷键	功能
`Ctrl+S`	保存并自动编译
`Ctrl+Alt+V`	预览 PDF
`Ctrl+Alt+J`	正向同步（源码 → PDF）
`Ctrl+点击PDF`	反向同步（PDF → 源码）
`Ctrl+Alt+B`	手动编译
`Ctrl+Alt+C`	清理辅助文件

六、常见问题

6.1 中文显示问题

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

latex 复制代码

\usepackage{ctex}

6.2 字体警告

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

bash 复制代码

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

6.3 编译错误

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

6.4 清理临时文件

bash 复制代码

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

七、毕业论文模板

7.1 获取学校模板

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

7.2 常用模板资源

学校	模板名称	GitHub 地址
清华大学	THUThesis	https://github.com/tuna/thuthesis
北京大学	pkuthss	https://github.com/CasperVector/pkuthss
上海交通大学	SJTUThesis	https://github.com/sjtug/SJTUThesis
浙江大学	ZJUthesis	https://github.com/TheNetAdmin/zjuthesis
中国科学技术大学	ustcthesis	https://github.com/ustctug/ustcthesis

八、参考文献管理

8.1 推荐工具

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

8.2 BibTeX 使用

在 LaTeX 文档中引用：

latex 复制代码

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

九、安装信息汇总

项目	版本/信息
操作系统	Ubuntu 24.04
TeX Live	2023/Debian
XeTeX	3.141592653-2.6-0.999995
pdfTeX	3.141592653-2.6-1.40.25
BibTeX	0.99d
VSCode	1.107.0
LaTeX Workshop	James Yu
安装日期	2025-12-24

十、目录结构

复制代码

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