企业官网建设流程全解析

Overleaf 十分钟上手指南：如何用这款免费开源的在线 LaTeX 编辑器从初稿到交付

【免费下载链接】overleafA web-based collaborative LaTeX editor项目地址: https://gitcode.com/GitHub_Trending/ov/overleaf

周五晚上导师催初稿，你不想再折腾 TeX 安装——这就是 Overleaf 登场的时刻：一款免费、开源的在线实时协作 LaTeX 编辑器，浏览器就是你的全部工作站，多人可以同时编辑同一份文档。

3 步跑通：从克隆仓库到第一个可编辑项目

用 Overleaf 有两条路：注册官方托管站点最快；用开源代码自建，则是本节的主题。自建的前提只有一个：机器上有 Docker。步骤其实就三行：

git clone https://gitcode.com/GitHub_Trending/ov/overleaf cd overleaf/develop bin/build && bin/up

第一次bin/build最磨人——基础镜像里装了一整套 TeXLive 发行版，体积有好几个 GB，耐心等它跑完。bin/up起来后，浏览器打开http://localhost/launchpad（注意是 launchpad 路径，不是根路径），创建第一个管理员账号，就能建项目了。

两个细节值得先知道：

• develop/目录里的默认配置足够试用，dev.env里列着各服务地址和默认口令；打算长期用的话，先把口令改掉。
• 构建时 Docker 内存吃紧，就在develop/目录建一个.env文件，写入COMPOSE_PARALLEL_LIMIT=1，让服务串行构建（develop/README.md里就是这么写的）。

跑起来之后，接下来按写作主线走一遍：建项目、编辑、拉人协作、审阅、交付。

日常写作主线：从建项目到交付源码

建项目：模板、空白还是导入已有项目

创建项目时可以选空白工程或挑一个模板。写论文强烈建议直接选目标期刊或会议的模板——它替你解决了 LaTeX 最难的一头：导言区配置和宏包挑选。如果你手头已有本地的 .tex 项目，把 zip 上传即可，Overleaf 会自动解压并保留目录结构，不用手工搬文件。

编辑与编译：为什么右边 PDF 跟着你走

编辑器是三栏布局：左边文件树，中间写代码，右边 PDF 预览。改完点 Recompile，几秒后右侧就出新 PDF。这不是浏览器本地在干活，而是背后有一个独立编译服务services/clsi/——每次编译都会拉起带 TeXLive 的容器，把产物放回预览区。编辑器前端只管代码和显示，所以两页的课程作业和两百页的学位论文用的是同一个界面，真正的耗时都发生在编译侧。

这个设计也解释了后面会遇到的很多行为：编译超时设置、底部编译日志里带行号的报错提示，都围绕 clsi 这个服务展开。

协作：分享一个链接，大家互相看得见光标

在项目页点 Share，输入协作者邮箱并设好角色（只读或读写）。协作者打开项目后，每个人的光标和选区都以不同颜色显示在代码里。实时同步由services/real-time/这个服务经 WebSocket 推送完成，文档操作在后台做合并，所以两个人各写各的段落不会像邮件来回传文件那样互相覆盖。

项目右侧还挂着聊天面板，讨论"这句话改没改"不用切去别的软件。

审阅：用评论和历史代替口头争论

有分歧时，最好的落点是评论：选中对应的代码行，点评论图标即可添加，协作者可以逐条回复。评论锚定在代码上，不会散落在聊天记录里找不到。

改错了也别慌：历史页记录着各次编译对应的版本，可以对比前后差异，也能回滚到任意一版。版本数据按分块方式存储，大项目的历史不会把数据库撑爆。

导出：一键拿走源码 zip

初稿定稿后，点 Menu → Download → Source，会得到一个包含全部文件的 zip——发给合著者或投稿系统，结构和编辑器里看到的一模一样。只要 PDF 的话，直接用编译出的预览文件即可。

主线走通之后，下面这几样工具能让长文档和参考文献少花不少时间。

效率工具箱：长文档与参考文献省时术

这些界面功能各自独立成模块，都放在services/web/frontend/js/features/下，想加自己的小功能，去这里翻就对了。

托管版还额外提供 AI 工具集，比如把一张手写公式的照片直接转成 LaTeX 代码：

工具用熟了，也顺便记住几个最容易踩的坑。

避坑实录：这几个坑最费时间

• 刚装完第一次编译慢，之后就快了：编译容器的 TeXLive 镜像很大，首次要拉取并缓存。第一次编译慢属正常，别急着下结论。
• 编译超时、转圈半天：八成是图片太大。把图压成合适的分辨率，长文档用\includeonly分章编译，能省掉大半等待。
• 自建版别直接暴露公网：官方 README 明确写了，社区版没有沙箱编译——编译进程对容器文件系统、网络有读写权限，自建只适合完全可信的环境（课题组内部、课程站点这类）。
• 生产数据别随手升级：升级会触发数据库迁移，动手前先备份 MongoDB 和项目文件，再按版本号顺序逐步升。

进阶通道：上手之后的三个方向

• 接 Git 仓库：services/git-bridge/是 Git 桥接服务，把 Overleaf 项目和 Git 仓库同步起来，本地编辑器和在线编辑器可以并存使用。
• 看懂编译架构：读services/clsi/的 README，理解沙箱编译（Sandboxed Compiles）是怎么用兄弟容器跑 LaTeX 的，对"LaTeX 如何在容器里编译"这件事会有系统认知。
• 参与开发：在develop/目录跑bin/dev进入开发模式，服务改代码自动重启、各自暴露调试端口，能从 Chrome DevTools 直接 attach；注意前端改动需要连同 webpack 服务一起起。

现在就可以克隆仓库，创建你的第一个项目——仓库地址 https://gitcode.com/GitHub_Trending/ov/overleaf 📝

【免费下载链接】overleafA web-based collaborative LaTeX editor项目地址: https://gitcode.com/GitHub_Trending/ov/overleaf