企业官网建设流程全解析

3 分钟从 0 到 PDF：Typst 安装与上手完整指南

【免费下载链接】typstA markup-based typesetting system that is powerful and easy to learn.项目地址: https://gitcode.com/GitHub_Trending/ty/typst

这篇指南带你完成 Typst 安装：从选对安装方式、验证版本，到编译出第一份 PDF，全程大约 3 分钟。Typst 是一个基于标记语言的排版系统，用来替代 LaTeX 那种配置繁琐、编译缓慢、报错难懂的流程——你写.typ文件，它直接产出 PDF，常用功能开箱即用。

先想清楚你要什么

Typst 的定位是把排版做到"像写 Markdown 一样简单"，同时保留接近 LaTeX 的排版能力。它开箱自带：

• 标题、段落、表格、图注等常见排版的内置标记语法
• 一套脚本系统，可在文档里写逻辑、做循环
• 数学公式排版与参考文献管理
• ⚡ 基于增量编译的快速出图

如果你只是想快速出一份带公式的 PDF，装完二进制就能用，不必像传统排版那样先装一整套发行版、再配环境变量。

按系统选择安装方式

装二进制包是最省事的路径，三种系统各有一条命令，挑你的那条：

# Windows (PowerShell) winget install --id Typst.Typst # macOS brew install typst # Linux sudo apt install typst # Debian / Ubuntu sudo dnf install typst # Fedora / RHEL sudo pacman -S typst # Arch

如果你要从源码构建，需要先装好 Rust 工具链，再从仓库拉取代码用 cargo 编译，适合想改编译器本身的人；日常排版不需要走这条路。

验证 Typst 安装是否成功

打开终端执行typst --version，能看到类似typst 0.x.x的版本号就说明装好了。顺手执行typst fonts，可以确认系统字体是否被正确扫描到，这一步能提前暴露后面编译时的字体问题。

用 Typst 编译出第一份 PDF

新建一个hello.typ，写一个最小文档：

#set page(width: 10cm, height: auto) = 欢迎使用 Typst 这是你的第一份 Typst 文档，编译后直接得到 PDF。

在文件所在目录执行编译命令：

typst compile hello.typ

同目录会生成hello.pdf。把height: auto改成固定值，或加上header:页眉，就能调整页面形态——这些都属于set规则的配置。

高频问题与排查

• 改完没反应：单次compile只跑一次。想边改边看，用typst watch hello.typ，它会监听文件变化并自动重编，配合增量编译只重算变动部分。
• 字体加载失败怎么办：先typst fonts看字体在不在列表里；不在就放进系统字体目录，或在编译时用--font-path ./fonts指定自定义字体路径。
• 报错看不懂：Typst 的报错会直接给出出错行号和上下文，先定位那一行再改，比传统排版满屏星号好读得多。

进阶：从排版到脚本与包

入门之后可以按这条路线走：

1. 熟悉标记语法与基本排版（#set/#show规则）
2. 用脚本系统写循环、条件，做批量排版
3. 用数学与参考文献功能处理带公式的正式文档
4. 需要现成模板时用typst init <模板>从官方模板快速起项目

更多细节直接翻仓库里维护的文档：官方文档在 docs/，入门教程见 docs/content/tutorial/，命令参考与 CLI 实现分别在 docs/content/reference/ 和 crates/typst-cli/。行为是否稳定，可以对照 tests/ 里的测试用例。

【免费下载链接】typstA markup-based typesetting system that is powerful and easy to learn.项目地址: https://gitcode.com/GitHub_Trending/ty/typst