帮助中心
关于撰写、编译和协作 LaTeX 与 Typst 项目的清晰实用指南。
排查问题
解决常见的编译、访问和工作区问题。
本指南适用于
先看清细节
错误信息通常已经指出了需要处理的源文件或操作。
操作步骤
- 看清报错信息、它引用的文件，以及最近一次改动。
- 刻意复现一次，好知道问题出在文档上还是只是那一刻的偶发。
- 重新照对应的指南试一遍；仍然不行就带上项目名和报错细节联系支持。
编译失败或卡住时
编译失败和编译排队在状态栏里看着差不多，但处理方式正好相反。
操作步骤
- 编译失败时打开问题面板，从第一个错误看起 —— 后面的往往只是它的连锁反应。
- 报错信息本身看不懂时，对该诊断用 AI 的「解释」或「修复」。
- 每人同时只跑一个编译，所以新的自动编译会顶掉排队中的那个，手动编译可能提示你稍后重试。
- 提示编译服务无法完成请求，指向的是服务而不是你的文档 —— 先重试，一直如此再联系支持。
- 因超过时间限制，或用尽空间或内存而被停止的编译，重试也不会通过：找找有没有死循环、开销很大的宏包或特别大的图片，或者把文档拆开。
- 如果编译总是栽在过期的辅助文件上，或者源码和 PDF 之间的跳转失灵了，打开编译菜单并选择「清除缓存并重新编译」。
问题出在项目本身时
有些失败来自文件所在的位置或项目的体量，而不是报错那一行的源码。
操作步骤
- 刚移动或重命名文件后出现找不到文件的错误，通常是还有路径写着旧位置：在移动之后出现的提示上选择「更新」，或者自己改正路径（LaTeX 里是 \input 或 \includegraphics，Typst 里是 #include 或 #image）。
- 提示项目接近大小上限，意味着一旦满了，新文件和编辑就无法保存；删掉不再需要的文件，或者拆分项目。
- 编译服务繁忙或不可用时，提示会指向桌面应用，它可以用你自己电脑上的 LaTeX 编译；在应用里，设为在服务器上编译的项目则会看到「改用本机编译」。
访问与连接问题
打不开某个东西，通常是账户或连接状态的问题，而不是项目丢了。
操作步骤
- 把指针移到状态栏的保存圆点上，如果提示你正在离线工作，照常写：改动会留在浏览器里，连上后自动同步。
- 离线状态下不要退出登录 —— 退出会清掉这些本地副本。
- 打不开的项目会提示找不到；问一下所有者是不是权限变了，或者项目被移进了回收站。
- 邮箱未验证或账户被停用会挡住整个应用，而不只是某一个项目。
Typst 项目表现不一样时
Typst 项目在你写作时在页面里编译，在浏览器里下载时则在服务器上编译，所以多数意外都出在预览究竟是哪一方生成的。
操作步骤
- PDF 没有跟着你的输入更新，或者源码和 PDF 之间的跳转不起作用：这说明预览是服务器编译的，而不是页面。在编译菜单里检查「自动编译」，更新浏览器并重新加载页面。如果文档里有页面的字体覆盖不到的文字，它也会由服务器编译。
- 导入 @local 包时提示找不到包是预期行为：只有 @preview 包可用。
- 导入的 ZIP 或仓库如果有多个 .typ 文件，而顶层没有 main.typ，根文件会选没有被其他 .typ 文件 import 或 include 的那个。如果选的不是你的文档，打开项目设置，选择作为根文件的 .typ 文件。
- 提示编译服务暂时还不能编译 Typst 文档，问题出在服务而不是你的文档：请稍后再试。