在本地用 TeX Live 编译 LaTeX，并通过 Git 同步到 ScienHub

ScienHub 提供开箱即用的在线编译，无需任何本地安装。但有些场景下，本地编译依然值得拥有：网络不稳定时离线写作、依赖大量图片的长文需要更快的编译反馈、或者你已经习惯了 VS Code 的编辑体验。

好消息是，ScienHub 的每个 project 本质上都是一个标准 Git 仓库。你可以把它 clone 到本地，用本地的 TeX Live 编译，改完再 push 回云端——两边始终保持同步。本文分两步讲清整个流程。

第一步：安装 TeX Live

TeX Live 是跨平台的完整 LaTeX 发行版。请按你的操作系统选择安装方式。

直接用 apt-get 安装完整版（包含所有宏包与字体，省去后续缺包的麻烦）：

sudo apt-get update
sudo apt-get install texlive-full

用 Homebrew 安装：

brew install texlive

Windows 建议从镜像源下载完整 ISO 离线安装，比在线安装器稳定得多。

安装完成后，请确认 TeX Live 的可执行文件已加入系统 PATH。打开任意命令行（Windows 上可用 PowerShell），运行：

pdflatex --version

如果输出了版本信息（类似 pdfTeX 3.141592653-2.6-1.40.xx (TeX Live 2026)），说明安装成功、PATH 配置正确。若提示"命令未找到"，请重新打开命令行窗口，或手动把 TeX Live 的 bin 目录加入 PATH 后重试。

提示：中文 project 通常需要用 XeLaTeX 编译（而非 pdfLaTeX），验证时也可以额外运行 xelatex --version 确认。

同步 project 需要用到 Git。若尚未安装，请按操作系统选择：

安装后运行 git --version，能输出版本号即表示安装成功。

在 ScienHub 上打开你的 project，把下面命令中的 [USERNAME] 和 [PROJECTNAME] 换成你自己的用户名和项目名：

git clone https://scienhub.cn/[USERNAME]/[PROJECTNAME]

clone 完成后，本地会得到一个包含全部 .tex、.bib 和图片文件的目录。

推荐用 VS Code 搭配 LaTeX Workshop 扩展：

在 VS Code 扩展市场搜索安装 LaTeX Workshop（James-Yu.latex-workshop）。
用 VS Code 打开刚才 clone 下来的项目文件夹。
打开主 .tex 文件，保存（Ctrl+S）即会自动触发编译，右侧可实时预览生成的 PDF。
中文 project 请选用 XeLaTeX 编译 recipe：点击左侧 TeX 侧边栏 → Build LaTeX project，选择 latexmk (xelatex)，或在 .tex 文件首行加入魔法注释指定编译器：
```
% !TeX program = xelatex
```

本地改好后，把新增或修改的文件提交并推送回云端：

git add .
git commit -m "更新论文内容"
git push

push 成功后，刷新 ScienHub 上的 project，即可看到本地的全部改动。至此，本地与云端完成一次完整同步。

本地编译：装好 TeX Live（Ubuntu 用 apt-get、macOS 用 brew、Windows 用清华镜像 ISO），并用 pdflatex --version 验证 PATH。
云端同步：git clone 拉取 → VS Code + LaTeX Workshop 本地编辑编译 → git add / git commit / git push 推回 ScienHub。

在线协作与本地编译，你完全可以两者兼得。还没有账号？前往 scienhub.cn 免费创建你的第一个 project。