s-balli/latex-editor · 上手攻略
- 仓库：
s-balli/latex-editor - 链接：https://github.com/s-balli/latex-editor
- 分类：academic-writing
- 作者：Tom
- 更新：2026-09-04
是什么
s-balli/latex-editor 是一个基于 PyQt6 的轻量级桌面 LaTeX 编辑器，定位为 Notepad++ 风格 + 实时 PDF 预览 的离线替代方案，目标是摆脱 Overleaf 的浏览器标签和云端依赖。项目明确支持 Windows（通过 WSL）和 Linux（AppImage）两大平台，无云服务、无需注册账号，安装后完全离线运行。
核心功能包括：双向 SyncTeX（编辑器↔PDF 互相跳转）、三种编译引擎（lualatex / pdflatex / xelatex 自动识别）、.bib 文献库管理与 DOI 一键抓取、项目级全文搜索（Ctrl+Shift+F）、文件树操作（新建/重命名/删除）、文档大纲导航、Find & Replace（支持正则）等。最新版本 v1.0.19 包含 1702 个单元测试，Windows + Linux 双平台覆盖。
解决什么问题
在线 LaTeX 编辑器（Overleaf 等）有三个常见痛点：① 需要网络连接；② 内容存在第三方服务器，隐私敏感；③ 复杂项目有编译限制或依赖订阅。latex-editor 用一个完整的桌面应用把这三件事全卸掉了——写稿、编译、PDF 预览全部在本地完成，不需要打开浏览器，也没有账号体系。
对于需要处理多文件大型论文（30+ 章节/子文件）、频繁在前言和正文之间跳转写作者，以及在 Overleaf 下载项目后想本地继续工作的用户，这个工具填补了轻量离线编辑器的空缺。
快速安装
前置要求
必须先安装 TeX 发行版（编辑器本身不含编译器）：
- Windows：需要 WSL（
wsl --install）+ WSL 内安装 TeX Live - Linux：需要系统已装 TeX Live
⚠️ 编辑器本身不包含任何 TeX 编译器，下载页面和 README 都有明确说明——没有 TeX Live 的话软件打开后无法编译。
Windows 安装步骤
# 1. 以管理员身份打开 PowerShell，安装 WSL
wsl --install
# 2. 进入 WSL，安装 TeX Live（完整套装示例）
sudo apt-get update
sudo apt-get install texlive-base texlive-binaries texlive-latex-base \
texlive-latex-extra texlive-latex-recommended texlive-lang-european \
texlive-luatex texlive-xetex texlive-fonts-extra texlive-science \
texlive-bibtex-extra texlive-font-utils texlive-extra-utils biber \
texlive-publishers texlive-humanities texlive-pstricks python3-pygments pandoc
# 3. 从 GitHub Releases 下载最新 Windows 便携版
# 访问 https://github.com/s-balli/latex-editor/releases
# 下载 LaTeX_Editor_v*_Windows.exe（便携版，无需安装）
Linux 安装步骤
# 从 GitHub Releases 下载 AppImage
# https://github.com/s-balli/latex-editor/releases
chmod +x LaTeX_Editor_v*_Linux_x86_64.AppImage
./LaTeX_Editor_v*_Linux_x86_64.AppImage
⚠️ Linux 版同样需要系统已安装 TeX Live（apt-get install texlive-full 或按需安装对应宏包）。
核心用法
基本操作流程
打开文件夹（项目根目录）→ 打开 .tex 文件 → Ctrl+S 保存自动编译 → PDF 预览刷新
SyncTeX 双向跳转
| 操作 | 快捷键 | 效果 |
|---|---|---|
| 编辑器 → PDF | Ctrl+点击编辑器行号 | PDF 跳转到对应位置（跨页也行） |
| PDF → 编辑器 | Ctrl+点击 PDF 位置 | 编辑器跳转到对应源码行 |
| 编译后定位 | 编译完成后 | PDF 自动滚到当前光标所在位置 |
编译引擎
编辑器自动检测 lualatex / pdflatex / xelatex，无需手动切换。手动指定方式：⚠️ 当前版本（v1.0.19）UI 中未提供引擎切换入口，依赖文件内容自动判断。
文献管理（Bibliography Tab）
- 打开含
.bib文件的项目，Bibiliography Tab 自动加载文献列表（key / type / author / year / title 分列显示，可点击排序） - 支持纯
\bibitem手写格式 - DOI 抓取：在 Bibliography Tab 内粘贴 DOI → 自动从 Crossref（优先）或 doi.org 拉取引用条目 → 确认后追加到
.bib文件 - 重复 key 检测 + 必填字段缺失检测（显示在检查列表，但不阻断编译）
⚠️ DOI 抓取需要在能访问 Crossref / doi.org 的网络环境下运行，不是完全离线的功能。
项目全文搜索（Find in Folder）
Ctrl+Shift+F → 输入关键词 → 搜索 .tex / .bib / .cls / .sty 全部文件
结果以 文件名:行号 列表展示，点击跳转到目标位置。搜索在后台运行，大型多文件项目不会冻结界面。
-shell-escape 权限控制
minted 等宏包需要 -shell-escape 标志才能运行任意命令。v1.0.19 之前：默认开启；v1.0.19 起：每个项目首次使用会弹出确认对话框，记住用户选择。这是安全加固改动，下载的互联网模板无法静默执行命令。
崩溃恢复
编辑中进程被 kill / crash / 断电 → 重启后弹出恢复对话框，询问是否恢复未保存内容。dirty tabs 每 30 秒自动快照到应用数据目录。
其他快捷键
| 功能 | 快捷键 |
|---|---|
| 保存 + 编译 | Ctrl+S |
| 全文搜索 | Ctrl+Shift+F |
| 当前文件搜索 | Ctrl+F |
| 查找替换 | Ctrl+H |
| 快速打开文件 | Ctrl+P |
| 跳转到行 | Ctrl+G |
| 快照版本 | Ctrl+K |
| 停止编译 | Esc |
典型适用场景
- 学位论文 / 长文写作：多章节 .tex 文件、交叉引用复杂，需要频繁 SyncTeX 跳转核验
- 隐私敏感项目：论文未发表、含内部数据，不想上传云端
- 网络不稳定环境：野外/会议现场/网络受限地区，无 Overleaf 可用时
- Overleaf 迁移：已下载 Overleaf 项目，想本地继续开发，编辑器内置 Overleaf 项目自动修复
- 土耳其中文学者：原生处理
ş ğ ı字符，对 IEEE/ASYU 模板编码问题有特殊处理
坑与注意
- Windows 必须用 WSL：编辑器本身是 Linux 原生应用（PyQt6），Windows 版实际是 WSL 内部的 Linux 可执行文件。没有 WSL，Windows exe 无法运行。
- TeX Live 必须手动装：编辑器不含编译器，Windows 用户首次安装需要折腾 WSL + TeX Live（约 5GB+），门槛不低。
- Linux AppImage 嵌入 Python 版本：不同构建版本（文档说 Python 3.10/3.12 混用），建议使用最新 Release 版本以避免兼容问题。
- 编译失败不覆盖旧 PDF：编译失败时预览区保留上一个成功版本，不会清空——这个设计是故意的，防止误以为编译成功。
- 正则表达式搜索有保护：v1.0.19 起拒绝可能导致死循环的正则（如
(a+)+$），但合法的正则仍可能耗时数秒，搜索框无超时取消按钮（需按 Esc 终止）。 - WSL 时钟漂移问题：WSL2 时钟与宿主机不同步导致编译时间戳判断不准，v1.0.19 已修复（通过比较逻辑改写），但旧版在频繁切换系统状态后可能出现"编译成功但报失败"的假象。
- DOI 抓取非完全离线：文献管理的 DOI 查询需要访问网络，如果 .bib 文件中有未解析的 DOI 且无网络环境，该功能无法使用。
- 没有内置拼写检查：编辑器本身不包含拼写检查插件，需要 OS 层面或自行配置。
与同类对比
| 工具 | 平台 | 云端 | 账号 | SyncTeX | 文献管理 | 适合人群 |
|---|---|---|---|---|---|---|
| latex-editor | Win(WSL)/Linux | ❌ | ❌ | ✅ 双向 | DOI抓取+重复检测 | 隐私敏感/离线写作者 |
| Overleaf | 浏览器 | ✅ | ✅ | ✅ | 有限 | 协作/免费用户 |
| TeXstudio | Win/Mac/Linux | ❌ | ❌ | ✅ 需配置 | 无 | 桌面端重度用户 |
| VS Code + LaTeX Workshop | 全部 | ❌ | ❌ | ✅ | 无 | 开发者/习惯 VS Code 者 |
| TeXShop | macOS | ❌ | ❌ | ✅ | 无 | macOS 独占用户 |
核心差异：latex-editor 的护城河是离线 + Notepad++ 轻量感 + 内置 DOI 抓取，劣势是 Windows 依赖 WSL（安装门槛高）和没有宏包补全/智能提示。
一句话推荐结论
适合需要完全离线、隐私优先的 LaTeX 写作者，尤其是从 Overleaf 迁移出来或经常在 WSL/Linux 环境下工作的人——安装配置稍繁，但换来的是无云依赖、无账号体系、无编译限额的清净写作体验。
⚠️ 注意：Windows 版需要 WSL + TeX Live；Linux 版需要 TeX Live。编辑器本身不包含 LaTeX 编译器，下载前请确认已安装或愿意安装 TeX 发行版。