Sublime Text配置LaTeX学术论文写作环境教程

手动写死 tex_path，禁用自动探测

Sublime Text的LaTeXTools插件有个“智能”探测功能（use_simple_detection），但它经常“聪明反被聪明误”。这个功能会去扫描系统的PATH变量，却很容易忽略你实际安装TeX的bin目录位置。尤其是在多TeX环境共存、自定义安装路径，或者Sublime Text从Dock、桌面快捷方式启动（而非从终端启动）时，这个自动探测大概率会失效。

最稳妥的办法，就是手动把路径写死。打开Sublime Text，进入Preferences → Package Settings → LaTeXTools → Settings – User，粘贴下面针对你操作系统的完整配置（注意，不要留空，也不要依赖默认值）：

• macOS（MacTeX）："tex_path": "/Library/TeX/texbin"
• Windows（TeX Live 2023）："tex_path": "C:\\texlive\\2023\\bin\\win32"（Windows路径中的反斜杠需要转义，所以是双反斜杠）
• Linux："tex_path": "/usr/local/texlive/2023/bin/x86_64-linux"
• 如果你的系统里有多个TeX路径，可以用冒号（macOS/Linux）或分号（Windows）分隔，例如："/usr/texbin:/opt/texbin"
• 还有一个关键操作：检查并删除配置文件里任何"use_simple_detection": true的字段。这个开关如果开着，会覆盖掉你手动设置的tex_path，让前面的功夫白费。

子文件必须加 %!TEX root = main.tex 注释

写学术论文，肯定要把内容拆分成main.tex、ch1.tex、refs.bib等多个文件。但Sublime Text可不会自动识别哪个是主文件。这时候，就必须在每个子文件（比如ch1.tex）的第一行，且只能是第一行，添加一行特殊的魔法注释：

%!TEX root = main.tex

这行注释必须位于文件最顶部，前面不能有空行，也不能有空格。否则，latexmk在编译时就找不到主文档，那些include{}或input{}命令会直接报“File not found”错误。

中文编译必须用 xelatex + ctex，且顺序不能错

用默认的pdflatex引擎去编译中文文档，结果通常是灾难性的——轻则满屏方块字，重则直接报错Package ctex Error: No a vailable font found。这可不是缺宏包那么简单，根本原因是引擎机制和字体查找路径不匹配。

• 文档设置：在.tex文件的导言区，第一行必须是类似documentclass[UTF8]{ctexrep}这样的命令。ctex宏包必须放在最前面加载，如果顺序错了，字体初始化就会失败。
• 构建配置：在Sublime的构建配置里，需要强制指定使用XeLaTeX。可以在用户设置中添加类似这样的配置："builder_settings": { "cmd": ["latexmk", "-pdfxe", "-synctex=1", "-interaction=nonstopmode", "$file"] }
• 字体宏包：切忌混用ctex和fontspec这两个宏包来处理字体，它们的底层机制有冲突。选定一个，就从头用到尾。
• 同步文件：确保生成的PDF文件和对应的.synctex.gz同步文件在同一目录下，并且主文件名相同。如果你使用了includeonly{}指令或者复杂的多文件主文档结构，要特别注意synctex通常只认主文件名，因此不要把PDF输出到output/这类子目录里，否则反向定位功能会失效。

最后再提一个隐蔽的坑：Sublime Text的启动方式不同，读取的系统环境可能也不同。比如从Dock图标点击启动，可能就读不到你在终端shell里设置的$PATH和字体环境变量。所以，上面强调的这三板斧——tex_path要写死、%!TEX root注释要加、synctex参数要带上——真的是缺一不可。把这些都做到位，Sublime Text才能成为一个真正流畅高效的LaTeX写作利器。