在Sublime代码编辑器中优雅地编写和编译LaTeX学术论文-sublime-PHP中文网

sublime text 本身不内置 latex 编译能力，必须通过 latextools 插件调用本地已安装的 pdflatex/xelatex 等引擎；90% 编译失败源于系统 path 未正确暴露编译器路径、tex_path 配置错误或子文件缺失 %!tex root = main.tex 注释，需终端验证命令可用性并手动配置构建器、引擎及 synctex 支持的 pdf 阅读器。

在sublime代码编辑器中优雅地编写和编译latex学术论文

Sublime Text 本身不内置 LaTeX 编译能力，但通过插件 + 正确配置工具链，能实现接近专业 LaTeX IDE 的体验——关键不在“优雅”二字，而在「路径对、引擎稳、反馈快」。

LaTeX 工具链必须提前装好，Sublime 不会替你装 `pdflatex` 或 `xelatex`

很多人卡在第一步：Sublime 报错 command not found: pdflatex 或 Could not find engine。这不是插件问题，是系统 PATH 没暴露编译器。

macOS：确认 MacTeX 或 BasicTeX 已安装，终端运行 which pdflatex，若为空，把 /usr/texbin 或 /Library/TeX/texbin 加进 shell 的 PATH（注意 Sublime 启动方式：命令行启动 subl 才继承 shell 环境；GUI 双击启动则不会）
Windows：安装 MiKTeX 或 TeX Live 后，检查是否勾选「Add MiKTeX to PATH」；若已安装但未勾选，手动将 C:\Program Files\MiKTeX\miktex\bin\x64\（或类似路径）加入系统环境变量
Linux：通常 sudo apt install texlive-latex-recommended texlive-fonts-recommended texlive-latex-extra 即可，which pdflatex 应返回有效路径

用 `LaTeXTools` 插件，但别迷信默认配置

LaTeXTools 是 Sublime 上最成熟的 LaTeX 插件，但它默认假设你用 pdflatex，且输出目录为当前目录。学术论文常用 xelatex（支持中文字体）、lualatex 或带 biber 的 BibTeX 流程，必须手动改配置。

Sublime Text Build Linux版

Sublime Text Linux x86-64 deb 安装包。官方也提供 rpm、tar.xz 和软件源安装方式。

下载

打开 Preferences → Package Settings → LaTeXTools → Settings – User

关键字段示例（适配中文论文）：

{
    "builder": "script",
    "script": [
        "xelatex",
        "biber",
        "xelatex",
        "xelatex"
    ],
    "output_directory": "out",
    "texpath": ["$HOME/texmf/bin", "/usr/texbin", "/Library/TeX/texbin"]
}

"texpath" 必须包含你的编译器所在目录，否则 Sublime 找不到引擎；"output_directory" 设为 "out" 可避免生成文件污染源码目录

中文支持别靠 `\usepackage{ctex}` 就万事大吉

ctex 宏包能简化中文排版，但 Sublime 编译时若字体缺失或编码不对，会直接报错 Font T1/cmr/m/n/10=ecrm1000 at 10.0pt not loadable 或乱码 PDF。

确保主文件保存为 UTF-8 编码（Sublime 右下角查看，不是 GBK）

导言区明确指定字体，例如：

\usepackage{ctex}
\ctexset{fontset = none} % 关闭自动字体匹配
\setmainfont{Noto Serif CJK SC} % macOS；Windows 用 "SimSun" 或 "Microsoft YaHei"

如果用 xelatex，不要加载 inputenc 或 fontenc，它们和 XeTeX 冲突

编译失败时，先看 `LaTeXTools` 的 Build Output 面板，不是 PDF

点菜单 Tools → Build System → LaTeX 后按 Ctrl+B（Win/Linux）或 Cmd+B（macOS），若 PDF 没更新，90% 的问题藏在 Build Output 面板里（Ctrl+Shift+P → View: Toggle Build Results）。

常见错误如 ! LaTeX Error: File `xxx.sty' not found.：说明宏包缺失，用 tlu（TeX Live Utility）或 mpm（MiKTeX Package Manager）安装，不是 pip
! Emergency stop. 后没具体行号：通常是未闭合的 {、$ 或注释符 % 错位，Sublime 的括号高亮和 Ctrl+Shift+P → “Bracket Highlighter: Select Scope” 能快速定位
BibTeX 相关失败（Warning--I didn't find a database entry）：确认 .bib 文件路径正确，且 \bibliography{refs} 中的 refs 对应 refs.bib，不是 refs.tex