TeXstudio 是一个免费的开源 LaTeX IDE，适用于 Windows、macOS 和 Linux。 Editor、PDF 查看器、构建配置和完成都在一个窗口中进行，并且它驱动您单独安装的 TeX 发行版（例如 TeX Live）。本页重点关注实践中最重要的三件事：人们陷入困境的 构建配置、加快写入速度的 完成 以及用于在源代码和 PDF 之间跳转的 SyncTeX。
TeXstudio 是什么
TeXstudio 是一个专用的 LaTeX 编辑器，最初是旧 Texmaker 代码库的一个分支 - Benito van der Zander 等人于 2009 年将其命名为“TexMakerX”，并于 2011 年将其重命名为 TeXstudio。它基于 Qt 构建，在三个操作系统中的外观和行为几乎相同，并且提供语法突出显示、实时拼写和语法检查、调色板超过 1000 数学符号，以及内置 PDF 查看器。请注意，它并不捆绑 LaTeX 本身：编译是通过 TeXstudio 启动系统上已安装的命令（例如 pdflatex 或 latexmk）来进行的。
因此安装顺序很重要：首先安装 TeX 发行版，然后安装 TeXstudio。一旦工作设置到位（例如 TeX Live 2026），TeXstudio 方面剩下的就是连接它如何构建文档。
构建配置
所有设置都位于选项 → 配置 TeXstudio 下。勾选底部的“显示高级选项”会显示更多条目。两个选项卡管理构建：Build 选项卡决定哪个命令是默认命令，而 Commands 选项卡指定每个命令的实际内容 - 可执行文件及其参数的路径。
在日常使用中，您只需要两个按钮。 Build & View (F5) 编译然后打开PDF； 编译 (F6) 仅生成 PDF。除此之外，View (F7) 打开 PDF，Clean 清除 .aux 和 .toc 等中间文件。
在内部，每个操作都表示为以 txs:/// 开头的 命令。例如，txs:///compile 是“默认编译器”，txs:///view 是“默认查看器”，而 txs:///latexmk 是 latexmk。 “Build & View”只是由管道 | 连接的一系列此类命令。默认编译器作为 pdfLaTeX 提供，但常见的做法是将其切换为 latexmk，它会自动处理依赖项 - 参考书目、索引和重新运行的次数。
在 Commands 选项卡中编写 latexmk 行，如下所示，直接生成 PDF 并同时发出 SyncTeX 信息。 % 扩展到正在处理的文件（不带扩展名）：
latexmk -pdf -synctex=1 -interaction=nonstopmode %.tex当您想要切换每个文档的引擎时，第一行的神奇注释可以做到这一点。例如，下面的一行仅使用 LuaLaTeX 编译该文档：
% !TeX program = lualatex首先冻结的设置
TeXstudio 公开了许多设置，因此更容易从冻结三个开始：默认编译器、Build & View 链以及是否启用 SyncTeX。一旦这些都解决了，按 F5 每次都会遵循相同的路径。
- 对于大多数西方文档，使用 latexmk 直接生成 PDF；对于继承的日语模板，选择 upLaTeX + dvipdfmx。
- 将“构建和查看”视为日常 F5 键的行为，包括编译和打开内部查看器。
- 在命令中包含
-synctex=1和-file-line-error，以便您可以从 PDF 跳转回源并按文件和行读取错误。 - 在打开论文正文之前，在十行
.tex文件上测试设置并检查日志和 PDF。
配置日语版本
日语广泛使用两种方法。一种是 LuaLaTeX：在“构建”选项卡中，将“构建和视图”设置为“编译和视图”，将“默认编译器”设置为“LuaLaTeX”，然后按一下 F5 即可进入 PDF。对于一个新的开始，这是一个简单的选择。另一个是 upLaTeX + dvipdfmx，这是日语标准：您可以将 Build & View 设置为“DVI->PDF 链”，将 默认编译器设置为“LaTeX”（因为它在 PDF 之前经过 DVI）。
最简洁的安排是在 .latexmkrc 中描述引擎组合，并让 TeXstudio 仅调用 latexmk。将以下文件放在与 .tex 相同的文件夹中，latexmk 负责处理 upLaTeX → dvipdfmx 流程、参考书目 (upbibtex)、索引 (upmendex) 和重新运行计数。因为 $latex 包含 -synctex=1，所以 SyncTeX 也可以工作：
$latex = 'uplatex %O -synctex=1 -interaction=nonstopmode %S';
$bibtex = 'upbibtex %O %B';
$makeindex = 'upmendex %O -o %D %S';
$dvipdf = 'dvipdfmx %O -o %D %S';
$pdf_mode = 3;这里$pdf_mode = 3选择模式“制作一个DVI，然后用$dvipdf将其变成PDF”。标记 %O（额外选项）、%S（源文件）、%B（不带扩展名的基本名称）和 %D（输出目标）是 latexmk 的占位符。通过这种方法，无论您是从 TeXstudio、命令行还是其他编辑器调用它，您都会得到相同的结果 - 配置位于一个位置。
从第一个错误开始读取日志
TeXstudio 的日志面板使其成为诊断故障的好地方。在随机更改设置之前，首先询问：启动了哪个命令，日志中的第一个错误是什么？ LaTeX 错误级联，因此第一条红线通常比最后一条更重要。
- 如果您看到
Could not start the command，请在指责 TeXstudio 之前怀疑 PATH 或 TeX Live / MiKTeX 安装。 - 对于
File not found，检查根文件、相对路径和图窗文件名。 - 对于缺少的软件包，请在 TeX Live 上使用
tlmgr或在 MiKTeX 上使用 MiKTeX Console 添加它。 - 单击日志行号，仅修复第一个错误，并在读取其余级联之前重建。
完成和结构视图
TeXstudio 的补全功能可靠地减少了击键次数。输入 \ 后跟一个字母，会弹出候选命令列表，随着添加字母的增加，列表会缩小；当多个候选人共享一个共同的前缀时，Tab 会立即填写该共享部分。更好的是，编写交叉引用 \ref{...} 提供文档中存在的 标签，而 \cite{...} 提供参考书目 键 (bibID) - 因此您很少需要记住一个名称。
工作环境也很愉快。开始一个 - 比如说 \begin{itemize} - 匹配的 \end{itemize} 会自动插入。将光标放在现有环境名称上一会儿，就会出现镜像光标，让您同时重写 \begin 和 \end 中的名称（一次性将 itemize 更改为 enumerate）。要关闭任何仍打开的环境，请按 Alt+Return。
左侧的 结构视图 成为文档的地图。它列出了标题（\section 和朋友）、标签（\label）、通过 \input/\include 拉入的文件、beamer 块和 TODOs（\todo{} 或 % TODO 注释）；单击某个条目会跳转到该位置。即使在很长的手稿或多文件项目中，您也能看到整体。
SyncTeX（正向和反向搜索）
SyncTeX 将源行映射到 PDF 中的位置并返回。有了它，您就可以进行正向搜索（从编辑器中所在的行跳转到 PDF 中的匹配位置）和反向搜索，从 PDF 中的某个位置跳回到相应的源代码行。校对时它会得到回报：对“哪一行产生了这一段”的追寻就消失了。
有两个条件可以实现这一点。首先，将 -synctex=1 传递给编译命令，以便生成同步文件 (.synctex.gz) - 上面的 latexmk 行和 .latexmkrc 已经执行此操作，如果您忘记了，TeXstudio 可以为您更正该命令。其次，在内部 PDF 查看器中打开 PDF；它的 SyncTeX 支持使得双向跳转成为可能。
手势很简单。每次打开查看器时，向前搜索都会自动运行到您的当前光标位置；要在任何地方触发它，请在源中Ctrl + 左键单击或从上下文菜单中选择“转到 PDF”。对于反向搜索，Ctrl + 左键单击 PDF 中的文本，或从右键单击菜单中选择 “跳转到源”。启用“滚动跟随光标”和“光标跟随滚动”可在您编辑时保持两者连续链接。