安装LaTeX发行版并配置Sublime Text的LaTeXTools插件:1. 安装MiKTeX(Windows)、MacTeX(macOS)或texlive-full(Linux);2. 安装Sublime Text及Package Control;3. 通过Package Control安装LaTeXTools插件;4. 根据系统设置builder、tex_path和viewer等参数;5. 编写UTF-8编码的.tex文件并用Ctrl+B编译;6. 解决常见问题如路径错误、中文乱码和PDF同步失败。配置完成后可高效进行本地LaTeX写作。

要在 Sublime Text 中配置 LaTeX 环境用于写论文,核心是安装并正确配置 LaTeXTools 插件,并确保系统中已安装 LaTeX 发行版。整个过程不复杂,但需要几个关键步骤配合。
1. 安装 LaTeX 发行版
在使用 Sublime 编辑 LaTeX 文档前,必须先在系统中安装完整的 LaTeX 环境:
- Windows 用户推荐安装 MiKTeX 或 TeX Live,两者都支持自动下载缺失宏包。
- macOS 用户建议使用 MacTeX,它是基于 TeX Live 的完整发行版。
- Linux 用户可通过包管理器安装,例如 Ubuntu 执行:
sudo apt install texlive-full。
安装完成后,打开终端或命令提示符,输入 pdflatex --version 验证是否成功。
2. 安装 Sublime Text 与 Package Control
确保你已安装最新版的 Sublime Text(建议 4.x 版本)。接着安装 Package Control,它是插件管理工具:
- 如果尚未安装,可访问 Package Control 官网 按指引手动安装。
- 安装后重启 Sublime,按
Ctrl+Shift+P调出命令面板,输入 "Install Package" 即可搜索插件。
3. 安装 LaTeXTools 插件
LaTeXTools 是 Sublime 中最成熟的 LaTeX 编译工具,支持一键编译、正反向搜索、PDF 预览等功能:
- 按
Ctrl+Shift+P,输入 "Package Control: Install Package",回车。 - 搜索 LaTeXTools 并点击安装。
安装完成后不要立即使用,需根据系统进行配置。
4. 配置 LaTeXTools
不同操作系统可能需要不同的构建设置。进入配置界面:
- 菜单栏选择 Preferences → Package Settings → LaTeXTools → Settings – User。
- 首次使用会生成用户配置文件,可在此覆盖默认设置。
常见配置示例(以 Windows + MiKTeX 为例):
{
"builder": "traditional",
"tex_path": "C:/Program Files/MiKTeX/miktex/bin/x64",
"keep_focus": false,
"viewer": "sumatra",
"show_log": "yes"
}
macOS 用户若使用 MacTeX,通常无需修改路径,但可指定预览器:
{
"viewer": "skim",
"sync_tex_after_build": true
}
Linux 用户一般使用 Okular 或 Zathura 作为 PDF 查看器,确保已安装并配置好 D-Bus 支持同步。
5. 编写与编译 LaTeX 文档
新建一个 .tex 文件,保存为 UTF-8 编码,例如 paper.tex:
\documentclass{article}
\usepackage[UTF8]{ctex}
\title{我的第一篇 LaTeX 论文}
\author{作者}
\begin{document}
\maketitle
Hello \LaTeX! 这是一篇测试文档。
\end{document}
- 保存文件后,按
Ctrl+B使用 LaTeXTools 构建项目,默认会调用pdflatex编译成 PDF。 - 编译成功后,PDF 会在默认查看器中打开,支持正向搜索(从代码跳转到 PDF 位置)和反向搜索(从 PDF 跳回编辑器)。
6. 常见问题处理
-
编译失败或找不到编译器:检查
tex_path是否包含pdflatex.exe(Windows)或对应二进制文件。 -
中文乱码:确保使用
ctex宏包并用 UTF-8 编码保存文件。 - PDF 不更新:尝试清理辅助文件(如 .aux, .log),重新构建。
- 无法同步查看:确认查看器支持 SyncTeX,且在配置中启用了同步功能。
基本上就这些。配置一次后,Sublime Text + LaTeXTools 就能高效支持学术写作,轻量又灵活。虽然不如 Overleaf 方便协作,但在本地写长文档时响应更快,适合深度用户。不复杂但容易忽略。










