Typst 安装配置实战30 分钟跑通排版项目【免费下载链接】typstA markup-based typesetting system that is powerful and easy to learn.项目地址: https://gitcode.com/GitHub_Trending/ty/typst写文档要反复调宏包、等几十秒编译Typst 用接近自然语言的标记语法做排版一行 set 定页面$ $ 直接写公式编译快、报错直接。这篇实战带你完成 Typst 安装与基础配置从空目录到第一份 PDF 不超过 30 分钟覆盖包管理器、官方二进制、源码构建三条路径并给出字体与编辑器集成的常用配置。① 30 秒跑通 ✅最短闭环就三个动作装、验证、编译赶时间看到这里就够用了。macOS 用 brew 最省事Windows 用 wingetLinux 按发行版选brew install typst # macOS # Linux 可换sudo apt install typst / sudo pacman -S typst typst --versionwinget install Typst.Typst # Windows预期输出typst 0.15.1版本号以你的安装来源为准。接着建一个三行的hello.typ内容就是一行标题加一行正文然后typst compile hello.typtypst compile hello.typ命令没有任何输出、旁边多出hello.pdf环境就是通的。若验证到的版本偏旧不影响使用3.2 里会讲怎么升级。② 前置检查装前环境自检清单动手前花 30 秒对一遍这张表缺哪项先补哪项检查项最低要求推荐配置备注操作系统Windows 10 / macOS 11 / 主流 Linux近两年内的系统版本三个平台都有官方二进制磁盘空间100 MB500 MB二进制本体几十 MB留出版本与包缓存空间网络能访问官方发布页有代理也可包管理器安装、拉取模板包都需要网络字体系统默认字体额外装一套中文字体缺 CJK 字体时中文会渲染成方框Rust 工具链1.92 及以上最新 stable仅源码构建需要纯使用可忽略表里没列 CPU 和内存因为编译单个文档消耗很低日常机器都够用真正会拖慢编译的通常是字体目录过大这在问题速查里会再提。③ Typst 分路径安装从一键命令到源码构建三条路径按省事程度排序任选其一装完都跑同一条验证命令预期输出typst 0.15.1。3.1 包管理器一键装Windows 用 wingetmacOS 用 brew推荐走包管理器因为升级、卸载、PATH 都交给系统管最不容易出环境问题。命令按系统对号入座brew install typst # macOS sudo apt install typst # Ubuntu / Debian sudo dnf install typst # Fedora / RHEL sudo pacman -S typst # Arch sudo snap install typst # 其他发行版兜底winget install Typst.Typst # Windows包源里的版本可能比官方发布页滞后一两个小版本要锁版本或追最新走 3.2。3.2 官方二进制需要指定版本或无包管理器时适合复现别人环境、CI 固定依赖或系统压根没有包。从 Typst 官网发布页下载对应平台的压缩包把typst可执行文件放进 PATHtar -xf typst-x86_64-unknown-linux-musl.tar.xz # Linux sudo cp typst-x86_64-unknown-linux-musl/typst /usr/local/bin/Expand-Archive .\typst-x86_64-pc-windows-msvc.zip -DestinationPath C:\Tools # 把 C:\Tools\typst-x86_64-pc-windows-msvc 加入 PATH 后重开终端二进制装法自带升级能力typst update下载官方新二进制原地替换加--revert可回退上一版。3.3 源码构建想改内核或贡献代码时才用git clone https://gitcode.com/GitHub_Trending/ty/typst cd typst cargo build -p typst-cli --release # 产物target/release/typst三条路径装完统一验证typst --version④ 首次运行与基础配置第一个 PDF第一次运行只做三件事建文档、编译、看 PDF。#set page(paper: a4, margin: 2cm) #set heading(numbering: 1.) 第一个章节 这是 Typst 排版的最小文档支持 *强调* 与 $ E mc^2 $。typst compile hello.typcompile 成功时没有输出hello.pdf落在源文件旁边没报错就是跑通了。日常写作切 watch 模式保存即重编改 import 进来的模板文件同样会触发typst watch hello.typ字体按需再配默认走系统字体只有出现缺字方框或想换字体时才动两步。先用typst fonts确认可用字体名自定义字体目录用--font-path或环境变量TYPST_FONT_PATHS喂给编译器。写中文建议显式指定 CJK 字体#set text(font: Source Han Sans SC)⑤ 编辑器集成VS Code 与 Neovim 怎么配编辑器插件解决保存即预览和悬停提示配完两个主力就能开工。VS Code 装官方 Typst 扩展字体目录这类个性化项放工作区设置{ typst.fonts.paths: [./fonts] }扩展默认用 PATH 里的 typst 编译二进制装在非标准位置时把路径指给扩展的 LSP 设置即可。Neovim 走 Tinymist 语言服务器用 Mason 安装最省事require(mason).setup() require(mason-tool-installer).setup({ tools { tinymist } })装完 tinymist 后补全、跳转、诊断自动接管。JetBrains 全家桶在 Marketplace 搜 Typst 插件装完即用。Emacs 用 typst-mode、Sublime Text 装 Typst 包思路相同外部调 CLI 或挂 Tinymist LSP。⑥ 高频问题速查 ⚠️安装配置阶段 90% 的坑在下面这张表里按症状直接查症状原因解法终端提示typst命令找不到二进制目录不在 PATH先重启终端二进制安装的确认目录已加入 PATH用typst info核对 Typst 认的环境变量与默认路径中文全部渲染成方框系统缺 CJK 字体安装思源黑体/宋体typst fonts确认被识别再在文档里指定font:指定了却不生效字体名与系统注册名不一致用typst fonts --variants抄准确名称大小写和空格都要对Windows 上编译成功但 PDF 打不开查看器锁定了输出文件关掉查看器重编或输出到另一个文件名本机版本行为和同事不一致包源版本滞后typst update原地升到官方最新或改用官方二进制大文档编译明显变慢字体目录过大导致扫描耗时收敛--font-path范围别指向整个磁盘都解决不了时跑typst info看 Typst 实际读到的环境变量和默认路径多数“玄学”问题到这里就现形了。⑦ 进阶模板与项目级定制 Typst 的定制就是普通函数版式写成一个 letshow 规则一挂整站生效。下面这个报告模板可直接复制到新文档开头#let report(title: , author: , body) { set page(paper: a4, margin: 2cm, header: set align(center)[#title], footer: set align(center)[#counter(page).display()]) set text(size: 11pt) align(center)[#text(size: 22pt, weight: bold)[#title]] v(1em) align(center)[#text(12pt)[#author]] v(2em) body } #show: report(title: 我的报告, author: 你)[ 引言 正文…… ]换项目只改 title 和 author 两个参数页眉页脚已固化。多文件项目把共享版式放进template.typ各章节用 import 引入set 是可继承样式show 规则只改呈现方式两者配合能覆盖绝大多数定制需求。⑧ 下一步到这里环境已经齐了按这个顺序往外走把官方教程和语言参考过一遍重点吃透 set / show 规则与元素模型这是 Typst 配置能力的根基常用模板和包去官方 Universe 市场找论文、简历、海报都有现成模板typst init可直接从模板建项目版本升级用typst update行为变化对照官方 changelog 查卡住了带全上下文版本、命令、完整报错去官方论坛或 Discord 提问复现效率最高【免费下载链接】typstA markup-based typesetting system that is powerful and easy to learn.项目地址: https://gitcode.com/GitHub_Trending/ty/typst创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考