Overleaf社区版本地部署中缺失TeX Live完整包解决方案

问题背景

在Overleaf Toolkit 5.2.1社区版的本地单用户部署中（如WSL环境），用户编译LaTeX文档时可能遇到titlesec.sty等宏包缺失的问题。这是由于默认安装的TeX Live为基础版本，不包含完整宏包集合。

技术分析

Overleaf社区版默认使用TeX Live基础安装方案(scheme-basic)，而专业功能如titlesec宏包需要完整方案(scheme-full)。在早期版本中，可通过-with-texlive-full参数指定完整安装，但在5.2.1版本中该方式已不再适用。

解决方案

通过Docker命令直接安装完整TeX Live方案：

docker exec sharelatex tlmgr install scheme-full

版本兼容性处理

当遇到TeX Live版本不匹配警告（如2024本地版与2025远程库冲突）时，可采用以下方法：

1. 切换至历史版本仓库

tlmgr option repository ftp://tug.org/historic/systems/texlive/2024/tlnet-final

2. 再执行完整安装

tlmgr install scheme-full

最佳实践建议

1. 对于生产环境，建议等待官方容器更新至新版TeX Live
2. 临时解决方案优先选择对应年份的历史仓库
3. 定期检查Overleaf Toolkit的更新日志，获取官方支持的完整TeX Live安装方式

技术原理

TeX Live的scheme-full包含：

• 所有标准宏包（约5,000+个）
• 字体集和配套工具
• 多语言支持组件
• 文档和源代码

社区版默认不包含完整方案主要是由于：

1. 镜像体积限制（基础版约500MB，完整版约4GB）
2. 开源协议分发限制
3. 专业功能与社区版的定位区分

扩展知识

对于需要特定宏包的用户，也可以单独安装所需包：

docker exec sharelatex tlmgr install <package-name>

建议通过tlmgr search --global --file <filename>命令查询宏包对应的安装名称。