SJTUThesis编译系统终极指南：从配置到故障排除的全流程实操方案

SJTUThesis作为上海交通大学LaTeX论文模板的核心项目，通过智能化编译脚本解决了学术写作中格式排版与高效构建的痛点，让研究者能够专注于内容创作而非技术细节。本文将以"问题-方案-案例"结构，带你掌握从环境配置到故障处理的完整编译技巧。

1. 编译系统核心问题与解决方案

1.1 跨平台编译痛点与统一方案

💡 核心问题：不同操作系统下的编译命令差异、中文显示乱码、依赖缺失等问题常导致编译失败。

🔧 解决方案：SJTUThesis通过双脚本架构实现跨平台兼容：

• Makefile：适用于Linux/macOS系统
• Compile.bat：针对Windows系统优化

操作步骤：

1. Linux/macOS用户：直接在终端执行make命令
2. Windows用户：双击Compile.bat或在命令行运行
3. 首次使用需确保已安装TeXLive或MiKTeX发行版

1.2 编译效率优化：增量编译技术

💡 核心问题：完整编译耗时过长，影响写作效率。

🔧 解决方案：采用增量编译技术（仅重新处理修改文件的编译方式），通过latexmk工具实现智能依赖检测。关键配置参数：

• -time：记录文件修改时间戳
• 自动处理交叉引用和参考文献更新

效果对比：初次编译需3-5分钟，修改后增量编译仅需30秒-1分钟

2. 编译系统配置与使用案例

2.1 3步基础配置技巧

配置步骤：

1. 克隆项目仓库：git clone https://gitcode.com/gh_mirrors/sj/SJTUThesis
2. 进入项目目录：cd SJTUThesis
3. 根据操作系统选择对应编译方式

2.2 核心参数场景化配置指南

参数名称	场景说明	配置示例
THESIS	主文档文件名设置	当你需要使用自定义主文档名（如"thesis.tex"）时，设置THESIS = thesis
LATEXMK_OPT	编译行为控制	调试时设置-interaction=nonstopmode可避免编译中断
清理级别	中间文件管理	提交版本控制前使用cleanall参数可删除所有生成文件

2.3 字数统计功能全解析

不同场景下的字数统计需求对比：

使用场景	命令	统计范围	输出结果
快速预览	make wordcount/Compile.bat wordcount	正文内容	总字数+中文字数+英文字符数
精确统计	配合grep命令过滤特定章节	指定章节内容	按章节分类统计
期刊投稿	配置wordcount-filter参数	排除摘要和参考文献	符合期刊要求的正文字数

3. 跨平台适配指南

3.1 系统环境准备清单

必要依赖：

• TeX发行版：TeXLive 2021+ 或 MiKTeX 21.0+
• 字体支持：建议安装Fandol或思源字体
• 辅助工具：perl（latexmk依赖）、git（版本控制）

3.2 平台特定问题解决

• Linux系统：通过包管理器安装缺失依赖sudo apt-get install texlive-full
• macOS系统：使用Homebrew安装brew install mactex
• Windows系统：MiKTeX首次运行需选择"安装缺少的包"选项

4. 常见故障排除案例

4.1 编译中断：缺失字体文件

问题表现：编译过程中出现"Font ... not found"错误

解决方案：

1. 检查texmf/tex/latex/sjtutex/font目录下是否存在对应字体定义文件
2. 确保已安装SJTUThesis推荐字体
3. 执行fc-cache -fv更新字体缓存

4.2 参考文献未生成

问题表现：PDF中引用显示为问号"?"

解决方案：

1. 确认refs.bib文件格式正确
2. 执行完整编译流程：LaTeX → BibTeX → LaTeX → LaTeX
3. 检查引用标签是否与bib文件中的条目匹配

4.3 中文显示乱码

问题表现：PDF中中文显示为方块或乱码

解决方案：

1. 检查main.tex中是否正确设置编码\usepackage[UTF8]{ctex}
2. Windows用户确保Compile.bat已设置UTF-8编码（chcp 65001）
3. 尝试更换字体方案，修改sjtu-cjk-font-*.def配置文件

5. 高级使用技巧

5.1 实时预览工作流配置

配置步骤：

1. 执行make pvc启动预览模式
2. 编辑TeX文件并保存
3. 系统将自动重新编译并刷新PDF预览

5.2 自定义编译流程

通过修改Makefile或Compile.bat，你可以：

• 添加自定义清理规则
• 集成语法检查工具
• 配置自动备份功能
• 设置编译完成后自动发送邮件通知

总结

SJTUThesis编译系统通过智能化脚本和跨平台设计，为学术写作提供了高效可靠的格式处理解决方案。掌握本文介绍的配置技巧和故障排除方法，将帮助你在论文写作过程中避免技术障碍，专注于内容创作。无论你使用哪种操作系统，都能通过简单的命令完成复杂的排版工作，让论文格式不再成为学术研究的负担。