SJTUTex.git安装加速

SJTUTex 安装加速指南

SJTUTex 是上海交通大学相关的 LaTeX 论文模板/文档类，通常以 Git 仓库形式分发，用户需要先克隆源码，再配置 TeX 环境编译。它的"安装慢"往往不是单一原因，而是克隆阶段和依赖安装阶段叠加造成的。下面按这两个阶段拆解加速思路。

> 提示：不同版本的 SJTUTex 仓库地址、目录结构和依赖可能不同，本文中的命令请以你实际拿到的仓库地址和官方说明为准。

一、安装慢的常见原因

明确是哪个阶段慢，才能对症加速。

二、克隆加速

1. 配置 Git 走代理

如果你本机已有可用代理，直接让 Git 走它： bash git config --global http.proxy http://127.0.0.1:7890 git config --global https.proxy http://127.0.0.1:7890 取消代理： bash git config --global --unset http.proxy git config --global --unset https.proxy 也可以只对 GitHub 生效，避免影响内网： bash git config --global http.https://github.com.proxy http://127.0.0.1:7890

2. 使用镜像/加速前缀

把仓库地址替换为加速服务是常见做法，例如在原始地址前拼接加速域名。不同加速服务稳定性差异大，建议：

• 优先选择你所在网络实测可用的服务；
• 只对克隆/下载这类公开只读操作使用；
• 不要把带凭证的私有仓库地址交给第三方加速服务。

3. 浅克隆与部分克隆

如果只关心最新版本、不需要完整历史： bash git clone --depth 1 <仓库地址> 只拉取需要的分支： bash git clone --depth 1 --single-branch --branch master <仓库地址> 对于超大仓库，可考虑部分克隆（按需下载对象）： bash git clone --filter=blob:none <仓库地址>

4. 子模块加速

如仓库含子模块，可在 `.gitmodules` 或全局配置中为子模块单独指定加速地址/代理，再执行： bash git submodule update --init --recursive --depth 1

三、TeX 环境安装加速

模板能否编译，取决于 TeX 发行版中是否装齐所需宏包。加速重点是把宏包源指向国内镜像。

以 TeX Live 的 `tlmgr` 为例，可切换默认仓库为国内镜像（以清华 TUNA 为例，具体路径以镜像站说明为准）： bash tlmgr option repository https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/tlnet tlmgr update --self tlmgr install <缺失宏包名> 中科大 USTC 等镜像通常也提供同类路径，可按网络情况选择。

如果使用发行版自带的 TeX 包管理器（如 Debian/Ubuntu 的 `apt`、Fedora 的 `dnf`），同样可以把系统软件源换成国内镜像，再安装 TeX 发行版包。

四、构建与验证

环境就绪后，用模板自带的构建方式编译一遍。XeLaTeX 是中文模板常用引擎： bash latexmk -xelatex main.tex 或按仓库提供的 Makefile/脚本执行。验证要点：

• 编译无"缺少宏包"报错；
• 生成的 PDF 结构正确；
• 若首次编译仍大量联网下载，说明宏包尚未装齐，回到上一步补装。

五、排查清单

六、小结

SJTUTex 的安装加速可以归纳为三句话：克隆走代理或镜像，历史能省则省（浅克隆/部分克隆），宏包源换国内镜像。先把"仓库拉下来"和"宏包装齐全"两件事分别提速，再编译验证，通常能显著缩短从零到出 PDF 的时间。具体