ARTICLE DETAIL

资讯详情

深耕网站建设与运营推广的一线实战洞察。

Typst 安装三步走:跨平台部署与中文配置完全指南

Typst 安装三步走:跨平台部署与中文配置完全指南 Typst 安装三步走跨平台部署与中文配置完全指南【免费下载链接】typstA markup-based typesetting system that is powerful and easy to learn.项目地址: https://gitcode.com/GitHub_Trending/ty/typst如果你正在做 Typst 安装又顺手把 Typst 配置一次搞明白这篇文章就是为你写的。目标只有一个尽快在 Windows、macOS 或 Linux 上装好 Typst跑通第一个 PDF。按下面的顺序走全程不超过十分钟。一张表选安装方式不用看完全文先对照这张速查表定位你的系统直接跳到对应章节即可。验证命令都是typst --version能打印出版本号就算成功。平台可用方式一句话说明验证命令Windows包管理器winget/ 手动下载推荐winget install一条命令搞定typst --versionmacOS包管理器brew/ 手动下载brew install typst最省事typst --versionLinux包管理器apt / dnf / pacman / snap/ 手动下载 / 源码编译发行版有包就装包没有再编译typst --version环境要求很宽松Windows 10 以上、macOS 10.15 以上或主流 Linux 发行版留 100MB 磁盘、有网就行。为什么是 TypstLaTeX 功能强但配置繁琐、编译慢新手劝退感很强。Typst 走的是另一条路标记语法直接写排版函数和脚本系统又保证了复杂需求也能扩展数学公式、参考文献、增量编译一个不少。它适合写论文、技术文档和书籍尤其适合想快速出稿、不想跟引擎配置搏斗的人。按方式装三选一方式一包管理器最省事各平台的包管理器命令合并在一个代码块里挑你系统对应的那行执行装完打开新终端就能用typst命令# Windowswinget winget install --id Typst.Typst # macOSHomebrew brew install typst # Ubuntu/Debian / Fedora / Arch sudo apt install typst sudo dnf install typst sudo pacman -S typst # 或任意发行版用 Snap sudo snap install typst执行后包管理器会自动下载、放置二进制并配好 PATH无需任何手工步骤。方式二手动下载 配环境变量适合公司内网装不了包管理器、或者想固定版本的场景# 1. 到 Typst 官方 GitHub 发布页下载对应平台压缩包 # Windows: typst-x86_64-pc-windows-msvc.zip # macOS: typst-x86_64-apple-darwin.tar.gz # 2. 解压Windows 例如放 C:\Program Files\typst # macOS 放 /usr/local/bin 等已在 PATH 中的目录 # 3. 把解压目录加入系统 PATH 环境变量 typst --version # 能打印版本号即配置成功最后一条命令是真正的验收动作能输出版本号说明 PATH 已生效报找不到命令就是路径没加对。容器环境同理——直接拿现成的 Docker 镜像跑省去整个安装过程。方式三源码编译cargo只有前两条路都不通时才用这条前提是机器上已装好 Rust 工具链。执行下面命令后cargo 会把 typst-cli 从源码编译并安装到本地cargo install --locked typst-cli编译需要几分钟期间机器会明显发热属正常现象。装好后命令同样叫typst。验证安装顺手学会升级装完先跑一次版本检查确认二进制可用typst --version正常输出类似typst 0.13.1。以后想升级也很直接让 Typst 自己更新自己typst update执行后它会拉取新版并替换当前可执行文件跑完再typst --version确认版本号变新即可。编译你的第一个 PDF这一节做完你就有第一个属于自己的 PDF 了 建一个hello.typ内容不超过 10 行就够 你好 Typst 这是我的第一个文档带 *加粗* 文本。 列表项一 列表项二 $ E mc^2 $然后编译。不带输出路径时它会在源文件旁生成同名 PDF带路径则指定输出位置typst compile hello.typ typst compile hello.typ out.pdf写作阶段建议开监视模式文件一保存就自动重编增量编译基本是秒级省去反复手敲 compiletypst watch hello.typ需要查命令用法时typst help看全部子命令typst help watch看单个命令的细节。编辑器搭配保存即编译VS Code装 Typst 扩展工作区设置里加typst.compileOnSave: true即可存完自动出 PDF。Neovimcargo install --git https://github.com/Myriad-Dreamin/tinymist tinymist-lsp装语言服务器再用 lspconfig 启用tinymist获得补全和跳转。其他Emacs 用 typst-modeVim 用 vim-typst 插件都能完成基础编辑与编译。中文排版两行搞定国内用户最高频的坑是中文乱码或缺字⚠️ 记住两件事字体要先装到系统认得的位置再在文档里声明一下。第一步把思源宋体、思源黑体等开源中文字体放进系统目录Linux 放~/.fontsmacOS 放~/Library/FontsWindows 装进已安装字体。第二步在文档开头加一行声明#set text(font: Source Han Serif CN)字体不在默认目录时用--font-path临时指定或设环境变量后执行typst fonts检查是否被识别typst compile --font-path ./fonts mydoc.typ TYPST_FONT_PATHS$HOME/fonts typst fonts想做成项目级永久配置可以在项目根目录写typst.toml声明[compile]下的font-path这样不用每次敲参数。从 LaTeX 迁移对照速查表按日常操作频率排了序写文档时先查上几行就能覆盖大部分需求高频操作LaTeX 写法Typst 写法章节标题\section{标题} 标题加粗 / 斜体\textbf{}/\emph{}*文本*/_文本_无序 / 有序列表itemize/enumerate环境- 项/ 项行内数学$Emc^2$$Emc^2$插入图片\includegraphics{file}#image(file)表格tabular环境#table(...)页面边距geometry宏包#set page(margin: 1.75in)习惯 LaTeX 视觉风格的话在文档头部加这段就能拿到相近观感#set page(margin: 1.75in) #set par(leading: 0.55em, spacing: 0.55em, first-line-indent: 1.8em, justify: true) #set text(font: New Computer Modern)故障自查表遇到问题先别慌对号入座现象最可能原因处理办法提示字体找不到字体不在默认搜索目录typst fonts确认识别或加--font-path指定目录中文显示为方块系统没装中文字体装思源宋体等 CJK 字体再#set text(font: ...)声明图片不显示路径错误或格式不支持核对相对路径Typst 支持 PNG、JPEG、GIF、SVG、WebP报错看不懂语法写错了直接按提示里的行号定位Typst 的错误信息通常很明确大文档反复编译慢每次全量手动编译改用typst watch并拆模块用import组织最后说两句装好、编出第一个 PDF 之后Typst 的日常就是写 .typ、存文件、看 PDF这么简单。想继续深入直接看 Typst 官方文档语法和标准库都有系统讲解想跟进新特性或提建议去官方 GitHub 仓库找 issue 和讨论区社区里 Discord 频道答疑最活跃卡住的时候基本都有人接话。祝排版顺利 【免费下载链接】typstA markup-based typesetting system that is powerful and easy to learn.项目地址: https://gitcode.com/GitHub_Trending/ty/typst创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表