Texmaker

Texmaker 是法国 Pascal Brachet 自 2003 年以来开发的免费开源 LaTeX IDE。它在 Windows、macOS 和 Linux 上运行，将编辑器、PDF 查看器、构建配置和完成收集到一个窗口中。后来的 TeXstudio 是 Texmaker 的一个分支——这就是为什么两者看起来很相似。本页介绍了 Texmaker 的独特之处：它的 构建配置（快速构建）、加快写入速度的 完成和结构视图，以及用于在源代码和 PDF 之间移动的 SyncTeX。

Texmaker 是什么

Texmaker 是用 Qt 编写的，因此它在三个操作系统上的外观和行为几乎相同。它根据 GPL（GNU 通用公共许可证，v2）分发：免费使用和自由修改。它提供 Unicode 支持、拼写检查、代码折叠（您可以折叠 \part、\chapter、\section 和 \begin{...}…\end{...} 块）、400 多个数学符号的调色板以及内置 PDF 查看器。第一个版本于 2003 年 5 月 29 日发布，当前稳定版本是 6.0.1，于 2025 年 4 月 26 日发布。

关键点是 Texmaker 不捆绑 LaTeX 本身。编译通过让 Texmaker 启动单独安装的命令来进行 - pdflatex、uplatex、dvipdfmx 等。因此安装顺序是首先安装 TeX 发行版（例如 TeX Live 2026），然后是 Texmaker。您在 Texmaker 端所做的就是配置这些命令如何连接在一起。

它有助于理解与TeXstudio的关系。 TeXstudio 是一个独立的项目，它从 Texmaker 代码库中分支出来，添加了自己的功能，例如语法检查和镜像光标。粗略的划分是，Texmaker 保持配置简单，正如您对原始版本的期望，而 TeXstudio 功能更加丰富。两者共享相同的型号，因此在其中一种中感到舒适会立即转移到另一种中。

构建配置（快速构建）

所有设置都位于 选项 → 配置 Texmaker 下（在 macOS 上称为 首选项）。两个部分管理构建：命令指定每个命令的实际内容（可执行文件及其参数），快速构建选择它们的运行顺序。

Texmaker 的核心是 快速构建：按一下工具栏按钮（或 F1 键）即可运行您选择的命令序列，从头到尾。 “快速构建”部分将常见组合列为单选按钮，您可以选择一个。

• PdfLaTeX + 查看 Pdf — 直接使用 pdfLaTeX 制作 PDF 并显示它。发货默认；对于大多数西方文本来说很好。
• LaTeX + dvips + View Ps — 通过 DVI 并用 dvips 将其转换为 PostScript，然后显示它。
• LaTeX + dvipdfm + 查看 Pdf — 通过 DVI 并使用 dvipdfm(x) 将其转换为 PDF，然后显示它。日本人的标准路线。
• 用户：（定义您自己的） — 将您喜欢的任何命令与上面字段中的 | 链接起来以构建自定义流程。

在每个命令的参数中，% 扩展为不带扩展名的文件名（主模式下主文档的名称）。例如，默认情况下，“命令”部分中的 PdfLaTeX 字段如下所示 — -interaction=nonstopmode 使其不会因错误而停止，而 -synctex=1 会发出下面讨论的 SyncTeX 信息：

pdflatex -synctex=1 -interaction=nonstopmode %.tex

如果您希望自动处理参考书目、索引和重新运行计数，另一个选择是将 latexmk 放入快速构建“用户”字段中。 latexmk 解决依赖关系并根据需要多次运行每个步骤，因此您不必自己布置组合：

latexmk -pdf -synctex=1 -interaction=nonstopmode %.tex

选择一个快速构建路径

在Texmaker中，一旦你确切地知道F1在运行什么，写作节奏就会变得稳定。与其在调试时在 pdfLaTeX、upLaTeX 和 LuaLaTeX 之间切换，不如在开始认真写作之前为该手稿选择一种标准路线。稍后更改它可能会影响图形、字体、参考书目和换行符。

• 对于大多数西方报告，请从 PdfLaTeX + 查看 Pdf 或调用 latexmk 的用户设置开始。
• 对于继承的日语模板，将 LaTeX 字段设置为 uplatex，将 Dvipdfm 字段设置为 dvipdfmx，然后选择 LaTeX + dvipdfm + 查看 Pdf。
• 对于使用 OpenType 字体的新日语文档，请准备并保留 LuaLaTeX 用户设置。
• 只有在 F1 可靠地运行相同的命令序列之后，您才可以扩展章节和参考资料。

配置日语版本

日语的长期标准是 upLaTeX + dvipdfmx。在 Texmaker 中你改变了两个地方。首先，在“命令”部分中，重写 LaTeX 字段 以使用 uplatex，重写 Dvipdfm 字段 以使用 dvipdfmx。然后，在“快速构建”下，选择 “LaTeX + dvipdfm + 查看 Pdf”。 现在按 F1 按顺序处理 upLaTeX → dvipdfmx 并打开 PDF。

TeX Wiki给出的具体Windows设置如下。 -kanji=utf8 将输入编码修复为 UTF-8，-no-guess-input-enc 关闭编码自动检测。不要忘记 -synctex=1 是使逆向搜索起作用的关键：

uplatex -no-guess-input-enc -kanji=utf8 -synctex=1 -interaction=nonstopmode %.tex

dvipdfmx %.dvi

另一条路径是 LuaLaTeX，如果您刚开始学习日语，则需要更少的步骤。确认 Commands 下的 LuaLaTeX 字段是有序的，将 lualatex -synctex=1 -interaction=nonstopmode %.tex 放入 Quick Build “User”字段中，它会直接转到 PDF，而无需 DVI（日语是通过 luatexja 包或 ltjsarticle 类处理的）。如果您希望将配置保留在一处，您还可以在 .latexmkrc 中描述 upLaTeX 或 LuaLaTeX 流程，并让 Texmaker 仅调用 latexmk。

构建失败检查表

Texmaker 的简单性也使得故障诊断变得简单。当 F1 失败时，在重写 Quick Build 链之前，先分开两个问题：日志说什么，以及外部命令是否可以启动？同样的顺序适用于长论文和短报告。

• 从消息/日志文件面板开始。如果行号可单击，则跳转到导致第一个错误的源位置。
• 对于 Could not start the command，请在终端中运行 pdflatex --version 或 uplatex --version 并首先修复 PATH。
• 如果只有PDF刷新失败，请检查内置查看器是否保存了旧文件以及快速构建是否包含查看Pdf。
• 如果只有日语失败，请确认 LaTeX 和 Dvipdfm 字段形成一致的 upLaTeX + dvipdfmx 路由。

完成和结构视图

Texmaker 的完成减少了击键次数。键入 \ 后跟一个字母，会弹出候选命令列表，并随着添加字母而缩小。主要的 LaTeX 命令可以通过这种方式快速插入，对于带有参数的命令，会显示输入点（占位符），以便您可以依次填充大括号。

交叉引用也能得到帮助。编写 \ref{...} 或 \pageref{...} 提供文档中存在的标签，而 \cite{...} 插入参考书目键。你很少会因为记不住一个名字而陷入困境。

左侧的 结构视图 是文档的地图，它会在您键入时自动更新。它在层次结构中列出了标题（\section 和朋友）、标签（\label）以及通过 \input/\include 拉入的文件；单击某个条目会跳转到该位置。即使在很长的手稿或多文件项目中，您也可以四处移动而不会丢失整体情况。

SyncTeX（正向和反向搜索）

SyncTeX 将源行映射到 PDF 中的位置并返回。 Texmaker 的 内置 PDF 查看器 支持它，为您提供 正向搜索 — 从编辑器中所在的行跳转到 PDF 中的匹配位置 — 以及 反向搜索，从 PDF 中的某个位置跳回到相应的源代码行。在校对过程中，对“哪一行产生了这一段”的搜索消失了。

有两个条件可以实现这一点。首先，将 -synctex=1 传递给编译命令，以便生成同步文件 (.synctex.gz) - 编写如上所示的命令就足够了。其次，在 内置查看器 中打开 PDF（在“命令”部分中，将 Pdf Viewer 设置为内置查看器，如果希望将其停靠在主窗口中，请启用“嵌入”）。在外部查看器中打开会禁用双向跳转。

手势很简单。正如手册所说，使用编译命令上的 -synctex=1，内置查看器会自动跳转到 PDF 中与当前行相对应的位置 - 即向前搜索。对于反向搜索，右键单击内置查看器中的单词并从上下文菜单中进行选择，编辑器将跳转到匹配行。