Typst 安装与配置：10 分钟从零到第一个 PDF
【免费下载链接】typstA markup-based typesetting system that is powerful and easy to learn.项目地址: https://gitcode.com/GitHub_Trending/ty/typst
等排版引擎编译了整整 40 秒，只为了改一个词？Typst 是一套基于标记语言的排版系统：你写.typ源文件，它输出 PDF，增量重编译大约 1 秒。Typst 安装与配置做一次就能用很久，从零到跑通全程 10 分钟。
一条命令跑起来
Typst 跨平台部署比想象中省事，三个系统各一条包管理器命令就够了。
Windows 用系统自带的 winget：
winget install --id Typst.TypstmacOS 用 Homebrew：
brew install typstLinux 用发行版包管理器，以 Debian/Ubuntu 为例（Fedora 把 apt 换成 dnf，Arch 用 pacman）：
sudo apt install typst装完在终端敲typst --version，能打印出版本号就说明部署成功。如果你的发行版仓库里没有 Typst，去项目的 releases 页面直接下载预编译二进制，或者用cargo install --locked typst-cli从源码编译；容器化场景仓库里也附带了 Dockerfile，可以照着自建镜像。
从打字到出 PDF
日常使用只有两个命令：compile和watch。
先建一个main.typ，这就是一个能出 PDF 的最小文档：
= Hello Typst 这是第一篇文档。 - 列表项 1 - 列表项 2 $E = m c^2$一次性编译：
typst compile main.typ当前目录会生成main.pdf，也可以写成typst compile main.typ out.pdf指定输出位置。
持续编辑时改用 Typst watch 命令：
typst watch main.typ闭环是：改源文件 → 保存 → watch 检测到变更自动重编译 → PDF 原地更新。这个增量机制让 200 页文档的响应时间从整页重排的 40 秒降到约 1 秒，写长文时体验差距很明显。
排版不像样？先查这里
中文场景最高频的坑是字体。系统里没装 CJK 字体时，中文会回退成方框或奇怪的衬线字。装一套思源宋体或思源黑体（Linux 放~/.fonts下），然后在文档开头一行代码指给 Typst：
#set text(font: "Source Han Serif SC")Typst 字体配置是否生效，用typst fonts核对字体是否被识别；字体放在非默认目录时，临时加--font-path 目录指向它，或用环境变量TYPST_FONT_PATHS永久指定。
如果你从 LaTeX 过来，Typst 与 LaTeX 的核心区别是"标记优先、函数兜底"——多数排版需求用纯标记就能表达，需要时才写函数：
| 常见需求 | LaTeX | Typst |
|---|---|---|
| 章节标题 | \section{引言} | = 引言 |
| 加粗 | \textbf{文本} | *文本* |
| 无序列表 | \begin{itemize}... | - 列表项 |
| 行内公式 | $E=mc^2$ | $E=mc^2$ |
| 插入图片 | \includegraphics{fig} | #image("fig.png") |
项目还可以放一个typst.toml在根目录，写项目级默认配置，比如font-path指向共享字体目录，之后同项目的文档不用各自重复设置。
编辑器接哪个
VS Code：装 Typst 扩展，自带语法高亮、悬停文档和保存即编译，工作区设置加一行即可：
{ "typst.compileOnSave": true }Neovim：装 tinymist-lsp 语言服务器（cargo 一行装好，地址见 tinymist 仓库说明），lspconfig 里补require'lspconfig'.tinymist.setup{}两行搞定。
其余编辑器都有社区方案，Sublime Text 装 Typst 包、Emacs 用 typst-mode、Vim 用 vim-typst，体验略逊于上面两家但够用。
排错速查
| 症状 | 原因 | 解法 |
|---|---|---|
| 中文显示方框 | 系统缺中文字体 | 装思源宋体/黑体，文档里#set text指定 |
| 编译报错指向某行 | 语法问题，多为括号或#不配对 | 按报错行列号定位；Typst 的报错信息通常直接说出缺什么 |
| 图片不显示 | 相对路径写错或格式不支持 | 以文档所在目录为基准核对路径；支持 PNG、JPEG、GIF、SVG、WebP |
| 大文档编译偏慢 | 全量重编译成本高 | 用typst watch走增量编译 |
| 行为与新版文档不一致 | 版本太旧 | typst update升级到最新版 |
深入之前
- 官方文档站（搜 "Typst docs" 即可找到）收录了完整教程与函数参考，是 Typst 配置遇到问题时的第一查询处；仓库内对应源文件见 docs/content/tutorial/1-writing.typ 与各 参考章节。
- 想弄清 Typst 内部怎么工作——解析、布局、增量重编译各由哪层负责——看架构文档 docs/dev/architecture.md，再对照
crates/下的目录结构读源码。 - 上游仓库的 issue 区沉淀了已确认的缺陷与修复进展，官方 Discord 社区则是提问响应最快的地方。
【免费下载链接】typstA markup-based typesetting system that is powerful and easy to learn.项目地址: https://gitcode.com/GitHub_Trending/ty/typst
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
