TeXlyre/texlyre · 上手攻略

  • 仓库：TeXlyre/texlyre
  • 链接：https://github.com/TeXlyre/texlyre
  • 分类：学术写作工具 · LaTeX 编辑器
  • 作者：Tom
  • 更新：2026-09-09

是什么

TeXlyre 是一个本地优先（local-first）的 LaTeX + Typst 双语网页编辑器，内置实时协作、离线编辑、嵌入式图表编辑、Yjs CRDTs 冲突同步、WebRTC P2P 直连。核心亮点：所有编译都在浏览器里用 WASM 完成，不需要任何本地 TeX 发行版或服务器——开箱即用。

支持 pdfTeX / XeTeX / LuaTeX（通过 SwiftLaTeX + BusyTeX）和 Typst（通过 typst.ts），提供 SyncTeX 双向跳转（PDF ↔ 源码，仅 BusyTeX）、内嵌 Draw.io 和 TikZ 图表编辑、MathLive 数学公式实时预览。

解决什么问题

主流在线 LaTeX 编辑器（Overleaf）是云端编译，缺点：需要网络、隐私顾虑、协作延迟高。本地 TeXstudio/VSCode + LaTeX Workshop 则没有实时协作、部署麻烦。

TeXlyre 在两者之间找到位置：纯浏览器、离线可用、P2P 实时协作、无服务器依赖，同时支持 LaTeX 和 Typst 两种标记语言——这对在学术写作中想尝试 Typst 但又被期刊要求 .tex 的用户很有价值。

快速安装

前提条件

  • Node.js 20+
  • 现代浏览器：Chrome / Edge（完整功能支持，含 File System Access API + WebRTC）；Firefox（核心协作功能可用，文件系统集成有限）；Safari（部分兼容，文件访问受限）

安装步骤

git clone https://github.com/TeXlyre/texlyre.git
cd texlyre
npm install
npm run start

启动后访问 http://localhost:4173 即可使用。

⚠️ 注意：npm run start 是开发模式；生产构建建议 npm run build 后用静态服务器托管。

PWA 安装（可选）

在支持的浏览器中，可将 TeXlyre 安装为桌面 PWA，实现"类似本地应用"的体验，包括直接从操作系统分享文件到 TeXlyre（Android / 桌面 Chrome/Edge）。

核心用法

新建 / 打开项目

  • 启动后创建新项目，或打开已有项目
  • 分享协作用链接：http://localhost:4173/#yjs:abc123def456 格式的 URL，拿到链接的人直接加入实时协作
  • 也支持从模板创建并分享

协作功能

  • 实时光标：所有连接用户的编辑位置和选中区域实时可见
  • 评论 & Chat：内置评论系统和即时通讯
  • Tracked Changes：可追踪插入/删除，协作者可接受/拒绝修改
  • WebRTC P2P：无需中继服务器，低延迟直连

内嵌图表编辑

  • Draw.io：直接在编辑器内画流程图、架构图，实时协作
  • TikZ Editor：LaTeX 矢量图形编辑器

数学公式

  • MathLive：鼠标悬停或定位到公式时渲染预览，并可用虚拟键盘编辑
  • 公式格式化工具栏辅助快速插入

LaTeX / Typst 编译

  • LaTeX：SwiftLaTeX（基于 XeTeX/ pdfTeX）和 BusyTeX（TeX Live 2026 WASM 版）双引擎
  • Typst：通过 typst.ts 编译为 PDF / SVG / Canvas
  • ⚠️ SyncTeX 反向跳转（PDF → 源码）仅在 BusyTeX 下可用
  • ⚠️ Typst SVG/HTML 编译为实验性功能，不保证稳定性

文件管理

  • 内置文件浏览器，支持拖拽上传 LaTeX / Typst / 图片等
  • File System Access API：直接与本地文件夹同步（Chrome/Edge），可配合 Google Drive / Dropbox 等云盘实现跨设备
  • FilePizza（WebRTC P2P 文件传输）：大文件传输不经过服务器
  • GitHub / GitLab / Gitea / Codeberg 备份：可选启用，需要用户提供 Token

LSP（语言服务器）集成

TeXlyre 可通过 WebSocket 连接本地语言服务器： - ltex-ls-plus：语法 + 拼写检查（LaTeX 友好） - Harper LS：英语写作辅助 - TexLab / Tinymist：LaTeX 语言服务 - JabRef LSP：文献管理 - SILE / ConTeXt LMTX / PreTeXt / Asciidoctor / Quarto / LilyPond / Sphinx：外部排版服务

需要配合 Chelys（TeXlyre 桌面伴侣）或 texlyre-infrastructure recipes 部署这些服务。

文档统计

  • LaTeX：TeXcount 计算字数
  • Typst：typst-wordometer 计算字数
  • 统计反映语言结构而非原始字符数

格式化工具

  • LaTeX：tex-fmt 自动格式化
  • Typst：typstyle 自动格式化

典型适用场景

  1. 团队协作写论文：无需 Overleaf 订阅，多人实时编辑，WebRTC 低延迟
  2. 离线写作：飞机上、图书馆，网络不稳定环境（数据全在浏览器 IndexedDB）
  3. 想试 Typst 但被 .tex 绑架：同时支持两种语言，一键导出
  4. 注重隐私的学术写作：不信任云端编译器，本地编译更安心
  5. 跨设备工作：通过云盘同步本地文件夹，手机上也能看（但编辑体验有限）

坑与注意

坑点 说明
Safari / Firefox 文件系统 File System Access API 不完整，本地文件夹同步功能受限
SyncTeX 限制 仅 BusyTeX 支持，pdfTeX/XeTeX 不支持 PDF → 源码反向跳转
Typst SVG/HTML 编译 标记为 experimental，不建议在正式文档中使用
移动端 文件系统 API 在移动浏览器未充分测试，谨慎使用
LSP 需额外部署 语言服务器需要独立启动 Chelys 或 recipes，不开箱即用
PWA iOS 限制 iOS 上 PWA 的文件分享功能可能有平台限制
Node.js 20+ 低版本 Node.js 可能导致构建失败

与同类对比

TeXlyre Overleaf TeXstudio / VSCode
编译方式 浏览器 WASM 云端服务器 本地 TeX 发行版
实时协作 ✅ WebRTC P2P ✅ ❌（需手动合并）
离线支持 ✅ ❌ ✅
隐私 ✅（本地优先） ⚠️（数据在服务器） ✅
LaTeX + Typst ✅ 双语 ❌（仅 LaTeX） ❌（需插件）
内嵌图表 ✅ Draw.io + TikZ 有限 需外部工具
安装 无需安装（网页） 注册即用 需装 TeX Live + 编辑器
适合场景 协作 + 隐私 + 离线 通用协作 本地重度用户

一句话推荐结论

TeXlyre 是目前少见的本地优先 + 无服务器 + LaTeX/Typst 双语网页编辑器，WebRTC 实时协作和 WASM 编译是其最大亮点，适合隐私敏感或经常离线写作的学术团队。