超越 LaTeX Workshop:装在你电脑上的科研编辑器

一款专为科研打造的编辑器:项目级智能、SyncTeX、离线校对、内置编译器、真正的 Git 和引用管理。编译配方、远程开发和扩展市场,仍然是 VS Code + LaTeX Workshop 的地盘。

VS Code 里的 LaTeX Workshop (在新标签页中打开) 非常出色:免费,MIT 许可,维护精心。如果你的一周离不开自由配置的编译配方、texdoc、Docker / WSL / 远程开发、Live Share,或者完整的扩展市场,那就继续用那套组合。它就是为那样的工作方式而生的。

这篇文章写给想要一个以文档为先的应用的人:多文件论文、编译器、PDF、Git、引用、图表和校对都已经接好。免费开源(AGPL)。LaTeX、Typst、Markdown。普通文件夹。无需账号。

功能对照和快捷键:从 LaTeX Workshop 转过来 (在新标签页中打开)。

编辑器

基于 CodeMirror 6,带有覆盖 LaTeX、Typst、Markdown 和 BibTeX 的项目级索引。

日常使用中你实际得到的是:

  • 跳转到定义、查找引用、重命名标签和宏(有冲突警告)
  • 实时检查失效的交叉引用、错误的文献引用、缺失的包含文件(\cref、\eqref、范围引用,等等)
  • 当前文件和整个项目两级结构视图;可筛选、可跳转
  • 对键名、路径以及项目自定义宏的补全(\newcommand、xparse 的参数形状)
  • 支持 .tex、.ltx、.sty、.cls;参数片段;环境检查
  • LaTeX 使用 TexLab(需手动选择启用);Typst 自带 Tinymist
  • 统一的诊断信息:语法、编译、语言服务、交叉引用、文献引用、拼写、语法
  • 实时的 KaTeX 公式预览;源码保持可编辑
  • Harper + Hunspell 离线运行,只检查正文(命令和公式会被屏蔽)
  • 针对常见结构的可视化模式;Vim;斜杠命令;多文件标签页
  • 接下来会加入基于大型语料库、能感知宏包的命令补全(采用 LaTeX Workshop 的 MIT 许可数据,随应用内置并标注出处)

PDF 工作区:连续滚动、跨页显示、搜索、大纲、可分离的窗口。跨章节文件的双向 SyncTeX。重新构建尚未完成时,映射依然可用。上一份成功的 PDF 会一直显示。撤销回已编译的那一版源码,预览就能恢复为最新,无需完整重新编译。

书籍规模的 CI:约 6,200 行的稿件,多类数学公式、章节、文献引用、校对,并对滚动、输入、粘贴、撤销、补全、重新编译和 SyncTeX 设有性能预算。

LaTeX Workshop 是通用 IDE 里一款很强的扩展。Oleafly 把这套文档工作流装配好了再交给你,这样你就不必每个学期都靠设置项和从市场里挑选扩展,重新拼一遍同样的组合。

应用内的编译器

Tectonic(LaTeX)和 Typst 随应用一起提供。需要时通过托管的 Pandoc 处理 Markdown。第一次编译会缓存宏包,此后用缓存构建可以离线进行。离线模式可以把编译器锁定在缓存范围内。

自动编译(带防抖,可取消,以最新一次为准)。Cmd/Ctrl-Enter 重新编译。停止按钮。直接显示在出错行上的通俗易懂的错误卡片。新的构建运行期间,仍显示上一份成功的 PDF。

编译配方、latexmk 编译链、shell-escape 和自定义的 .latexmkrc,仍是 LaTeX Workshop 的擅长领域。大多数论文和毕业论文只需要一个可靠的、由应用托管的引擎。

模板:内置 23 个起步模板(IEEE、ACM、Elsevier、Beamer、毕业论文、简历、Typst 空白模板,等等),另有 99 个放在可下载的模板包里。可以把任何项目保存为模板。配置好模型后,还可以用 AI 生成模板(可选)。

项目库、Git 与科研工具

项目以书本的形式呈现:封面颜色、引擎徽标、复刻谱系、悬停时预览 PDF 的最后一页、收藏、可搜遍每一份文档的 /docs 搜索。复刻会保留完整的 Git 历史,方便你在投稿版本旁边做一次有风险的重写。

从第一天起就是真正的 Git。暂存、并排差异(工作树一侧可编辑)、放弃更改、恢复。成功编译后和空闲编辑后自动建立检查点;AI 运行会在第一次写入之前建立检查点。GitHub 为可选项(个人访问令牌 PAT,或设备流 OAuth)。终端里的 git log 与应用中显示的一致。

粘贴 DOI / arXiv / 标题 → 去重 → .bib → \cite。批量导入 BibTeX、RIS、EndNote、Zotero RDF。跨 arXiv、Semantic Scholar、Crossref、PubMed、OpenAlex 的引用搜索。图表编排器,生成可编辑的 TikZ。校验器、表格、公式、实验室搜索、会议截止日期、PDF 转 LaTeX,以及借助视觉模型的图片转 LaTeX。

可选的 AI

配置之前保持关闭。支持 OpenAI、Anthropic、Z.AI、Groq、OpenRouter、DeepSeek、Mistral、xAI、Ollama。密钥在磁盘上加密保存。请求只会发给你选择的提供商。

助手能编辑、编译、读日志、提取 PDF 文本、检索文献、维护计划。所有写入都以待你批准的差异呈现。删除需要单独确认。对选中内容可以行内“询问 AI”。本机回环 MCP 供 Claude Code、Cursor 等工具连接。AI 关闭时,编辑器、编译、Git 和引用管理照常工作。

预检、导出与隐私

预检:文档结构、未定义的引用、重复的标签、模拟解析器的文本提取预览、面向屏幕阅读器的检查结果。每一项风险提示都附带足够的上下文,让你可以自己核对,而不必相信一个黑箱评分。

导出:PDF 始终可用;有 Pandoc 时可导出 DOCX / HTML / Markdown;演示文稿导出 PowerPoint;书籍导出 EPUB;交接时导出源码 ZIP。

没有 Oleafly 账号。没有产品遥测。崩溃报告会打开一个预先填好内容的 GitHub issue,由你检查后再提交。联网用于宏包、模板、托管的 AI、引用、更新和 GitHub。编辑、缓存编译、语法检查、拼写检查和本地 Git 都可以离线工作。

LaTeX Workshop 仍然适合的情况

  • 自由配置的编译配方、latexmk、shell-escape、.latexmkrc
  • 在编辑器里使用 texdoc
  • Docker、WSL、远程开发
  • Live Share 和多人实时编辑
  • 处理文档之外的工作时,也长期使用 VS Code 的扩展市场

Oleafly 目前是公开测试版。复杂的出版商文档类文件仍可能难倒 Tectonic,遇到请反馈。

试一试

  1. 从发布页面 (在新标签页中打开)下载(macOS 版已签名并通过公证;Windows 上 SmartScreen 可能会提示一次)。
  2. 导入你的 .tex、.bib 和图片(或者从模板开始)。
  3. 编译一次,然后在一篇真实的论文上写一天。

保留 VS Code。同样的文件在两个应用里都能用。如果在一篇真实论文上的这一天,Oleafly 用起来更顺手,就把更多项目迁过来;如果某个项目目录仍然更适合用编译配方和远程开发,就把它留在 Workshop 里。

所有文章