Typst 安装部署指南：10 分钟从零编译出第一份 PDF
【免费下载链接】typstA markup-based typesetting system that is powerful and easy to learn.项目地址: https://gitcode.com/GitHub_Trending/ty/typst
Typst 是一个用标记语言写文档的排版系统，功能接近 LaTeX，语法却简单得多，编译还有增量加速。本文带你完成 Typst 安装、写出第一个 .typ 文件，并用一行命令编译出 PDF。
装法对比：按平台直接选路线
结论先行：绝大多数人用系统包管理器一行命令搞定，不用自己找二进制文件。
| 平台 / 场景 | 推荐路线 | 说明 |
|---|---|---|
| macOS | Homebrew | 版本新、维护及时 |
| Windows | winget 官方包管理器 | 自动进 PATH |
| Linux | 发行版包管理器 | apt / dnf / pacman 均可，版本可能略旧 |
| 容器 / 临时使用 | Docker 官方镜像 | 不污染环境 |
| 要试开发版 | Rust 源码编译 | 需要已装 Rust 工具链 |
Typst 安装主线：macOS 三步编译出第一份 PDF
整条主线最短的路径在 macOS 上，三步走。
第一步，安装 CLI：
brew install typst第二步，建一个hello.typ，内容两行就够：
= 你好，Typst 这是一份由 typst compile 生成的 PDF第三步，编译：
typst compile hello.typ⚡ 命令跑完，同目录下就有hello.pdf，打开即是成品。下面这张图就是 Typst 排版系统实际渲染出的文档效果，页眉、标题、图形都是引擎排版完成的：
日常写作建议直接用监视模式，保存即增量重编，比反复手动编译快得多；字体情况用typst fonts查看：
typst watch hello.typ typst fontsTypst 安装的其他选择：Windows、Linux 与 Docker
- Windows：winget 一行装好，
winget install --id Typst.Typst，装完重开终端即可使用。 - Linux：
sudo apt install typst（Debian/Ubuntu）或对应发行版命令；包版本偏旧时用cargo install --locked typst-cli装最新版。 - Docker：
docker run ghcr.io/typst/typst:latest --help直接体验，适合 CI 和临时环境。 - 源码编译：
git clone https://gitcode.com/GitHub_Trending/ty/typst后执行cargo build --release，产物在target/release/，适合想读源码或跟开发版的人，细节见 CONTRIBUTING.md。
各子命令的完整参数用typst help查看，CLI 源码在 crates/typst-cli/src/。
常见报错对照：从现象到一行修复
踩坑不可怕，对照着改就行：
| 现象 | 原因 | 一行解决 |
|---|---|---|
typst: command not found | 装完没刷新 PATH | 重开终端，或which typst确认路径 |
| 中文变方块 / 提示找不到字体 | 字体目录不在搜索路径 | 编译时加--font-path ~/fonts，或在文档里#set text(font: "思源宋体") |
| 大文档每次编译都卡 | 反复全量重编 | 改用typst watch，走增量编译 |
typst update提示 self-update disabled | 用的是包管理器或源码安装 | 回到原安装渠道升级，如brew upgrade typst |
延伸一步：编辑器集成与进阶配置
装好 CLI 只是开始：VS Code 装 Typst 扩展、Neovim 接社区语言服务器 tinymist，都能拿到自动补全和即时预览。字体、页面、样式等高级配置，直接读仓库内置教程 docs/content/tutorial/；LaTeX 背景的人优先看 docs/content/guides/for-latex-users.typ，想看编译原理翻 docs/dev/architecture.md。
从安装到第一份 PDF 不超过十分钟，剩下时间都花在内容上。文档写法拿不准去 docs/content/guides/ 翻对应指南，报 bug 或想参与开发参考 CONTRIBUTING.md。
【免费下载链接】typstA markup-based typesetting system that is powerful and easy to learn.项目地址: https://gitcode.com/GitHub_Trending/ty/typst
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
