快速开始

关于 TeX64

TeX64 是一款仅适用于 macOS 的本地优先 LaTeX 编辑器。打开工作区文件夹、编辑 .tex 文件、一键构建，并在集成的 PDF 查看器中预览。原生支持 Apple Silicon（M1/M2/M3/M4）与 Intel。除 AI 功能外可完全离线运行。

前置条件

  • macOS 12（Monterey）或更高版本
  • Apple Silicon（M1/M2/M3/M4）或 Intel Mac
  • TeX 环境：推荐 MacTeX（需要 latexmk、lualatex、latexindent、synctex）
  • 约 150 MB 可用磁盘空间

安装 TeX64

  • 从 /download 下载 DMG（选择 Apple Silicon 或 Intel）
  • 打开 DMG，将 TeX64.app 拖入「应用程序」文件夹
  • 首次启动：可能出现 Gatekeeper 警告。请按住 Control 点击并选择「打开」。
  • 查看架构：在终端运行 `uname -p`（arm = Apple Silicon，i386 = Intel）

安装 TeX 环境

为使用 TeX64 的全部功能，请安装一个 TeX Live 发行版，推荐 MacTeX。

  • MacTeX（推荐）
    完整 TeX Live + GUI 工具，约 4GB
  • BasicTeX
    最小化安装，约 100MB。可根据需要使用 `sudo tlmgr install` 安装额外宏包。

查看 TeX 发行版详细指南 →

七步快速上手

  1. 启动 TeX64
  2. File > Open Workspace（或将文件夹拖入应用）
  3. 在文件树中选择主 .tex 文件（TeX64 会自动检测）
  4. 点击工具栏中的构建按钮（播放图标）
  5. PDF 在集成查看器中显示
  6. 编辑源文件 → 点击构建按钮 → PDF 自动更新
  7. 在 PDF 上按住 Cmd 单击可跳转到源代码（反向 SyncTeX）

编辑器功能

  • 文件树：可折叠显示工作区目录结构
  • 标签页编辑：同时打开并切换多个文件
  • 分屏视图：左右或上下并排显示编辑器和 PDF
  • PDF 独立窗口：将 PDF 查看器分离到独立窗口（支持多显示器）
  • 大纲视图：自动识别章、节、图表、标签、引用、TODO 并列出，点击即可跳转
  • 项目搜索：对整个工作区进行全文搜索（基于 ripgrep）
  • 重命名支持：支持在整个项目中重命名文件和标签

构建系统

  • 通过工具栏一键构建
  • 底层使用 latexmk（支持增量构建，从第二次起更快）
  • 构建输出面板：显示进度、警告与错误。点击错误即跳到源代码行
  • PDF 自动更新：仅在构建成功时更新（失败时保留上一次成功的 PDF）
  • 主文件选择：自动检测或手动指定
  • 构建配置：可配置多个编译目标

键盘快捷键

  • Cmd+B — 插入或包裹 \textbf{}
  • Cmd+, — 打开设置
  • Cmd+Click（在 PDF 上） — 跳转到源代码（反向 SyncTeX）
  • Cmd+Shift+E — 打开区块编辑器

验证您的环境

若要确认 TeX64 已找到所有必要工具，请打开「设置」并查看「环境」。

  • 检测的工具：lualatex、latexmk、latexindent、synctex
  • ✅ 绿色对勾 = 已检测到
  • ❌ 红色 = 未检测到
  • 若缺失：请安装 MacTeX 或使用 `tlmgr` 单独添加宏包

后续步骤

通过以下指南，充分发挥 TeX64 的能力：