
Typst 快速安装与配置指南5 步跑通 PDF 编译【免费下载链接】typstA markup-based typesetting system that is powerful and easy to learn.项目地址: https://gitcode.com/GitHub_Trending/ty/typstTypst 是一套把.typ源文件直接编译成 PDF 的标记语言排版系统。这篇文章带你完整走一遍 Typst 安装用一条命令装好、用一个 5 行文档验证能编译、配好编辑器再解决字体、中文、watch 三个高频问题最后掌握模板复用和 Typst 配置里的典型细节。按平台一条命令装好平台安装命令说明Windowswinget install --id Typst.Typst用系统自带的包管理器装完自动加入 PATHmacOSbrew install typstHomebrew 维护的官方构建Linuxsudo apt install typstDebian/UbuntuFedora 用sudo dnf install typst装完打开终端运行typst --version会看到形如typst 0.15.1的版本号。如果终端提示找不到命令说明 PATH 没配对重开一次终端再试。如果你的发行版没有 typst 包也可以从官方 release 页手动下载对应平台的二进制或按仓库根目录提供的 Dockerfile 搭容器环境这里不展开。第一件事编译一个 5 行文档验证新建main.typ写入 你好Typst 这是我的第一份 *Typst* 文档。 $ E mc^2 $回到终端运行typst compile main.typ typst watch main.typ✅ 如果同目录下生成了main.pdf、终端没有任何报错说明 Typst 编译 PDF 的链路已完全打通打开 PDF 能看到标题、一行加粗正文和一个行内公式。出错时终端会给出文件名、行号和列号照着改即可。typst watch main.typ会持续监听文件变化保存一次重编一次终端显示 completed 即完成一轮以后想升级官方二进制直接运行typst update即可包管理器装的版本则走对应包管理器。编辑器搭配VS Code 为主日常写作推荐 VS Code在扩展市场搜索并安装官方 Typst 扩展它会自动调用系统 PATH 里的 typst 可执行文件。打开.typ文件后启动预览保存时文档实时重编等价于内置的 watch 模式。如果你的 typst 不在 PATH 里把可执行文件的完整路径填进扩展设置项typst.compilerPath就行。其他编辑器基本都是一行配置的事编辑器怎么接Neovim安装 Tinymist 语言服务器lspconfig 里指向它Emacs安装 typst-mode 包Vim安装 vim-typst 插件Sublime TextPackage Manager 里装 Typst 包最常见的三个坑提示找不到字体Typst 按字体族名称精确匹配你在set text(font: ...)里写的名字必须和系统里注册的名称一字不差包括大小写。先运行typst fonts列出当前所有可用字体从输出里挑名字填进文档字体放在自定义目录时加--font-path参数临时告诉它去哪找。中文显示成方块原因是系统里没有覆盖中文的字体。装一个开源中文字体如思源黑体/思源宋体放入系统字体目录Linux 放~/.fontsmacOS 放~/Library/Fonts然后重新编译字体暂时不想装进系统的话编译时指定目录typst fonts --font-path ./fonts typst compile --font-path ./fonts main.typ想让自定义目录长期生效Typst 字体配置可以走环境变量export TYPST_FONT_PATHS$HOME/fonts写进 shell 的启动文件后编译和 watch 都会自动带上这个目录。不确定当前生效了哪些字体路径时运行typst info可以看到完整的字体路径列表。watch 不自动刷新typst watch监听的是磁盘上的文件变化编辑器里没保存没按 Ctrl/CmdS的修改它感知不到另外确认你是在包含.typ文件的那个目录里启动的 watch。两个条件都满足后保存一次终端会打印 completedPDF 随之更新。进阶两步模板复用与包声明模板复用靠#let定义函数、#import引入。把页眉逻辑抽到单独文件// report.typ #let report(title, content) { set page(margin: 1.8cm) align(center)[#text(22pt, weight: bold)[#title]] v(0.5em) content }主文档两行接入#import report.typ: report #show: report(周报)如果这个模板要发给别人用就在项目根目录放一个typst.toml声明包信息这是 Typst 配置里标准包结构的入口[package] name report version 0.1.0 entrypoint ./report.typLaTeX 用户快速对照元素LaTeXTypst章节标题\section{标题} 标题加粗\textbf{文本}*文本*斜体\emph{文本}_文本_无序列表\begin{itemize}环境- 列表项图片\includegraphics{img}#image(img)编译pdflatex main.textypst compile main.typ从装好到编译Typst 的工作流就是两条命令加一个会报行号的错误提示比 LaTeX 工具链轻得多。想继续深入可以看 官方教程、LaTeX 用户迁移指南 和 完整语法参考。【免费下载链接】typstA markup-based typesetting system that is powerful and easy to learn.项目地址: https://gitcode.com/GitHub_Trending/ty/typst创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考