LaTeX 编译指南

编译器选择

pdfLaTeX

• 最适合：英文论文，快速编译
• 限制：CJK 支持较差，需要 CJKutf8 包
• 命令：latexmk -pdf main.tex

XeLaTeX（推荐中文）

• 最适合：中文文档、Unicode 支持、系统字体
• 套餐：ctex, xeCJK, fontspec
• 命令：latexmk -xelatex main.tex

LuaLaTeX

• 最适合：现代功能、Lua 脚本、复杂的排版
• 注意：积极维护，建议面向未来
• 命令：latexmk -lualatex main.tex

乳胶配置

在项目根目录中创建 .latexmkrc：

# For XeLaTeX (Chinese documents)
$pdf_mode = 5;  # xelatex
$xelatex = 'xelatex -interaction=nonstopmode -no-shell-escape %O %S';

# For pdfLaTeX (English papers)
# $pdf_mode = 1;
# $pdflatex = 'pdflatex -interaction=nonstopmode -no-shell-escape %O %S';

# Enable -shell-escape only for sources you have explicitly verified as trusted.

# Bibliography
$bibtex_use = 2;
$biber = 'biber %O %S';

# Output directory (optional)
# $out_dir = 'build';

# Clean extensions
@generated_exts = (@generated_exts, 'synctex.gz', 'nav', 'snm', 'vrb');

常见问题

找不到中文字体

% Specify fonts explicitly
\setCJKmainfont{SimSun}[BoldFont=SimHei, ItalicFont=KaiTi]
\setCJKsansfont{SimHei}
\setCJKmonofont{FangSong}

包裹丢失

# TeX Live
tlmgr install <package-name>

# MiKTeX (auto-install on first use)
# Or use MiKTeX Console

参考书目未更新

# Force rebuild
latexmk -C main.tex  # Clean all
latexmk -xelatex main.tex  # Rebuild

观看模式（连续编译）

# Auto-recompile on file changes
latexmk -xelatex -pvc main.tex

# With PDF viewer sync
latexmk -xelatex -pvc -view=pdf main.tex

跨平台笔记

视窗

• 安装 MiKTeX 或 TeX Live
• 使用 PowerShell 或 CMD
• 路径：使用正斜杠或转义反斜杠

Linux

sudo apt-get install texlive-full latexmk

macOS

brew install --cask mactex
# Or: brew install basictex