文档教程

从环境搭建到进阶技巧，TeXstudio 官方文档将引导您逐步掌握这款强大的 LaTeX 编辑器，无论是 LaTeX 新手还是有经验用户都能找到所需内容。

快速开始

TeXstudio 是一款专注于 LaTeX 写作的集成开发环境，目标是让作者能够更舒适、更高效地编写 LaTeX 文档。它通过智能命令补全、语法高亮、实时预览、错误分析等功能，显著降低 LaTeX 的学习与使用门槛。在开始之前，请确保您已具备基本的 LaTeX 概念认知，例如文档类、环境、命令等术语的含义。

本教程假设您已完成 TeXstudio 与 TeX 发行版的安装。若尚未安装，请先参考下一节"安装与配置"。整个入门流程通常在 30 分钟内即可完成，之后您便可以开始撰写第一篇 LaTeX 文档，并体验 TeXstudio 提供的各项智能辅助功能。

提示：TeXstudio 是 LaTeX 编辑器，本身不包含 TeX 编译引擎。它需要配合 TeX Live、MiKTeX 或 MacTeX 等 TeX 发行版使用。两者关系类似于 VS Code 与编程语言运行时的关系。

核心概念速览

  • TeX 发行版：提供 LaTeX 编译器与基础宏包集合，例如 TeX Live、MiKTeX。
  • 编辑器：负责源代码编辑、预览与管理，TeXstudio 即属于此类工具。
  • 编译：将 .tex 源文件转换为 PDF（或其他格式）的过程，由 TeX 引擎完成。
  • 宏包：扩展 LaTeX 功能的模块，通过 \usepackage 命令加载。

安装与配置

TeXstudio 的安装分为两步：首先安装 TeX 发行版，然后安装 TeXstudio 编辑器。强烈建议按此顺序进行，因为 TeXstudio 在首次启动时会自动扫描系统中已安装的 TeX 发行版并完成配置。若先安装编辑器，可能需要手动指定 TeX 引擎路径。

Windows 安装

Windows 用户推荐使用 TeX Live 或 MiKTeX 作为 TeX 发行版。TeX Live 体积较大但功能完整，适合需要处理多种语言文档的用户；MiKTeX 采用按需安装策略，初始体积小，编译时自动下载缺失宏包，适合磁盘空间有限的用户。

  1. 下载 TeX Live 安装程序（推荐）或 MiKTeX 安装包，按向导完成安装。
  2. 从本站下载页面获取 TeXstudio Windows 安装程序（.exe 文件）。
  3. 双击安装包，按向导选择安装路径与组件，建议保持默认设置。
  4. 启动 TeXstudio，软件会自动检测已安装的 TeX 发行版。
  5. 新建文档，输入示例代码，按 F5 编译预览，验证安装是否成功。

macOS 安装

macOS 用户推荐使用 MacTeX，它是 TeX Live 的 macOS 定制版本，包含完整的 TeX Live 发行版与图形化配置工具。安装 MacTeX 后再安装 TeXstudio，可以获得开箱即用的完整 LaTeX 工作环境。

  1. 下载 MacTeX 安装包（约 4 GB），双击 pkg 文件按向导安装。
  2. 从本站下载 TeXstudio macOS DMG 镜像文件。
  3. 双击挂载 DMG，将 TeXstudio 拖入"应用程序"文件夹。
  4. 首次启动时若提示安全警告，前往"系统偏好设置—安全性与隐私"点击"仍要打开"。
  5. 启动 TeXstudio，自动检测 MacTeX 并完成配置。

Linux 安装

Linux 各发行版通常提供 TeX Live 与 TeXstudio 的官方软件包，通过包管理器即可一键安装。这种方式由发行版维护者保证兼容性，是最省心的方案。若需要最新版本，可使用 AppImage 或 Flatpak。

# Ubuntu / Debian
sudo apt update
sudo apt install texlive-full texstudio

# Fedora
sudo dnf install texlive-scheme-full texstudio

# Arch Linux
sudo pacman -S texlive texstudio

# 通过 Flatpak 安装最新版
flatpak install flathub org.texstudio.TeXstudio

第一个文档

完成安装后，让我们编写第一个 LaTeX 文档来熟悉 TeXstudio 的基本操作。打开 TeXstudio，点击"文件—新建"，输入以下示例代码，然后按 F5 键编译并预览。若一切正常，您将在右侧 PDF 预览窗口看到渲染结果。

\documentclass{article}
\usepackage{ctex}
\usepackage{amsmath}

\title{我的第一篇 LaTeX 文档}
\author{TeXstudio 用户}
\date{\today}

\begin{document}
\maketitle

\section{引言}
这是一篇用 LaTeX 编写的示例文档。LaTeX 是一种基于 TeX 的高质量排版系统，
特别适合制作科学技术文档，其卓越的数学公式排版能力深受学术界青睐。

\section{数学公式}
LaTeX 可以轻松排版复杂的数学公式。下面是一个行内公式 $E=mc^2$，
以及一个独立公式：

\begin{equation}
\int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2}
\label{eq:gaussian}
\end{equation}

公式~\ref{eq:gaussian} 是著名的高斯积分，在概率论与统计学中有重要应用。

\section{总结}
通过这个简单示例，您已经接触了 LaTeX 的文档结构、章节划分、
数学公式与交叉引用等核心要素。

\end{document}

上述示例展示了 LaTeX 文档的基本骨架：\documentclass 声明文档类型，\usepackage 加载功能宏包（ctex 用于中文支持，amsmath 用于数学公式），\begin{document} 与 \end{document} 之间是文档正文。掌握这个结构后，您就可以开始编写更复杂的文档了。

小技巧：在 TeXstudio 中输入 \begin{ 后会自动弹出环境候选列表，选择 itemize 等环境后按 Tab 键，编辑器会自动补全 \end{itemize}，并将光标定位在环境内部，省去手动闭合的麻烦。

编译配置

TeXstudio 支持多种 TeX 引擎与编译工具链。对于纯英文文档，pdfLaTeX 是最快速的选择；对于包含中文或其他非拉丁字符的文档，推荐使用 XeLaTeX 或 LuaLaTeX，它们原生支持 Unicode 与系统字体，配合 ctex 宏包可以完美处理中文排版。

切换编译引擎

点击工具栏上的"编译"按钮旁的下拉箭头，可以选择不同的编译命令。常用选项包括 pdfLaTeX、XeLaTeX、LuaLaTeX、ConTeXt 等。对于中文文档，请选择 XeLaTeX。也可以通过"选项—配置 TeXstudio—构建"设置默认编译器。

多遍编译

LaTeX 的交叉引用、目录、参考文献等功能需要多次编译才能正确生成。TeXstudio 默认配置了智能编译序列，会自动判断是否需要重复编译。若发现目录未更新或引用显示为问号，可手动按 F5 多次编译，或使用"工具—清理辅助文件"清理 .aux、.toc 等临时文件后重新编译。

自定义编译命令

对于复杂项目，可以配置自定义编译命令序列。在"选项—配置—命令"中，您可以修改默认的编译器路径，添加额外的预处理或后处理步骤。例如，可以配置 BibTeX 自动运行，或在编译后自动执行 latexmk 完成多遍编译。

快捷键参考

熟练使用快捷键可以大幅提升编辑效率。以下是 TeXstudio 最常用的快捷键列表，Windows/Linux 与 macOS 的快捷键差异主要为 Ctrl 与 Cmd 键的对应关系。

功能 Windows / Linux macOS
编译并预览 F5 F5
仅编译 F6 F6
查看 PDF F7 F7
新建文档 Ctrl + N Cmd + N
打开文件 Ctrl + O Cmd + O
保存 Ctrl + S Cmd + S
查找替换 Ctrl + R Cmd + R
命令补全 Ctrl + Space Cmd + Space
跳转到行 Ctrl + G Cmd + G
注释/取消注释 Ctrl + T / Ctrl + U Cmd + T / Cmd + U
正反向同步 Ctrl + 点击 Cmd + 点击
公式预览 Alt + P Option + P

所有快捷键均可在"选项—配置 TeXstudio—快捷键"中自定义。建议保持默认设置以便与他人交流时使用统一的术语，或导出配置文件以便在多台设备间同步。

常用 LaTeX 命令速查

以下列出 LaTeX 文档中最常使用的命令与环境，配合 TeXstudio 的智能补全功能，可以快速构建文档结构。输入命令的前几个字母后，编辑器会自动弹出候选列表，按 Tab 键确认即可。

文档结构

\documentclass{article}    % 文档类：article/report/book
\usepackage{ctex}           % 加载宏包
\title{文档标题}
\author{作者}
\date{\today}

\section{节标题}            % 自动编号
\subsection{小节标题}
\subsubsection{小小节标题}
\paragraph{段落标题}

\tableofcontents            % 生成目录
\newpage                    % 分页
\linebreak                  % 换行

列表与表格

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

% 有序列表
\begin{enumerate}
  \item 第一项
  \item 第二项
\end{enumerate}

% 表格
\begin{table}[htbp]
  \centering
  \caption{表格标题}
  \begin{tabular}{lcc}
    \hline
    项目 & 数值 & 单位 \\
    \hline
    A & 100 & kg \\
    B & 200 & m \\
    \hline
  \end{tabular}
\end{table}

数学公式

% 行内公式
质能方程 $E = mc^2$ 描述了质量与能量的等价关系。

% 行间公式
\begin{equation}
  \frac{\partial f}{\partial x} = \lim_{\Delta x \to 0}
  \frac{f(x + \Delta x) - f(x)}{\Delta x}
\end{equation}

% 矩阵
\begin{equation}
  \begin{pmatrix}
    a_{11} & a_{12} \\
    a_{21} & a_{22}
  \end{pmatrix}
  \begin{pmatrix}
    x_1 \\ x_2
  \end{pmatrix}
  =
  \begin{pmatrix}
    b_1 \\ b_2
  \end{pmatrix}
\end{equation}

引用与参考文献

% 交叉引用
如图~\ref{fig:example} 所示，公式~\ref{eq:sample} 描述了...

% 文献引用（需配合 BibTeX）
研究表明 \cite{smith2023} 该方法有效。

% BibTeX 条目示例
@article{smith2023,
  author  = {Smith, John},
  title   = {A Study on LaTeX},
  journal = {Journal of Typesetting},
  year    = {2023},
  volume  = {42},
  pages   = {1--20}
}

更新日志

TeXstudio 遵循语义化版本号规范，定期发布新版本。以下是近期主要版本的更新摘要，完整变更记录请查阅 GitHub Releases 页面。

TeXstudio 4.9.6

  • 修复光标位置在视图宽度变化时丢失的问题
  • 允许 LLM 通过工具函数访问当前文档内容
  • 默认关闭 AI 向导，提升隐私保护
  • 改进 Windows 与 macOS 上的 Qt 6.2 兼容性
  • 多项界面翻译更新与稳定性优化

TeXstudio 4.8.9

  • 引入协同编辑功能（基于 teamtype 协议）
  • 新增 AI 写作助手，支持命令解释与文本润色
  • 优化大型文档的加载与编译性能
  • 修复代码折叠状态在保存后丢失的问题
  • 更新内置模板与文档向导

TeXstudio 4.8.0

  • 全面迁移至 Qt 6 框架，提升现代系统兼容性
  • 重新设计 PDF 查看器，支持连续滚动与多页视图
  • 增强语法高亮引擎，支持自定义主题
  • 改进多光标编辑与宏录制功能
  • 新增对 LuaLaTeX 与 ConTeXt 的原生支持

常见问题

为什么我的中文显示为方框？

这是字体配置问题。请确保使用 XeLaTeX 或 LuaLaTeX 编译，并在导言区加载 ctex 宏包：\usepackage{ctex}。若仍异常，请检查系统是否安装了中文字体，或使用 \setCJKmainfont{SimSun} 显式指定字体。

编译时报"Undefined control sequence"是什么意思？

这表示您使用了 LaTeX 不认识的命令，通常是因为拼写错误或未加载相应宏包。请检查命令拼写，确认所需的宏包已通过 \usepackage 加载。TeXstudio 会在错误日志中高亮显示问题命令，方便定位。

如何让公式编号从 1 开始？

LaTeX 默认公式编号从 1 开始。若编号异常，可能是使用了 \setcounter{equation}{n} 修改了计数器，或文档中存在 \* 号环境（如 equation* 不编号）。检查导言区与公式环境定义即可。

如何调整页边距？

使用 geometry 宏包即可灵活控制页面尺寸。在导言区添加 \usepackage[margin=2.5cm]{geometry}，将四周边距统一设为 2.5 厘米。也可使用 \usepackage[a4paper, margin=2.5cm]{geometry} 同时指定纸张大小。

PDF 中书签没有正确生成？

PDF 书签由 hyperref 宏包生成。请确保在导言区加载 \usepackage{hyperref}（建议放在所有其他宏包之后），并多次编译以使书签信息正确写入 .out 文件。若中文书签显示为乱码，使用 \usepackage[unicode]{hyperref} 选项。

外部资源

除本站文档外，以下资源对学习 LaTeX 与使用 TeXstudio 同样具有重要参考价值，建议按需查阅。