摘要:freeze 是 Charmbracelet 出品的命令行工具,一行命令把代码文件或终端输出变成高质量的 PNG/SVG/WebP 图片。支持语法高亮、主题切换、阴影圆角、行号截取,还有交互式 TUI 实时调参。单二进制无依赖,终端里完成所有操作,写技术文章、做文档配图再也不用开浏览器了。
写技术文章最让我头疼的事情是什么?
截图。
打开编辑器,调好字体,截图,粘贴进文章,发现尺寸不对,再调,再截……每次在博客里插一段代码图,前后能折腾半小时。
后来我这几天在逛 Github 的时候,发现了 freeze,这个过程变成了一秒钟的事。完美的解决了这个问题!

Charmbracelet:专出好用终端工具的团队
freeze 来自 Charmbracelet,做过 Bubble Tea(Go 的 TUI 框架)、Glow(终端 Markdown 渲染器)的同一个团队。他们的东西有个共同特点:解决真实痛点,上手极快,颜值还高。
freeze 解决的问题很具体——把代码变成图片。
不是随便截个屏,而是带语法高亮、有圆角、能加阴影的那种精致图。目前在 GitHub 上拿了 4600+ Stars,Go 写的,MIT 协议,最新版 v0.2.2。

安装:两分钟搞定
# macOS / Linux,Homebrew 最省心
brew install charmbracelet/tap/freeze
# Go 项目
go install github.com/charmbracelet/freeze@latest
# Arch Linux(btw)
yay -S freeze
也可以去 GitHub Releases 直接下二进制,支持 Linux、macOS、Windows,单文件无依赖,下载就能跑。

基础用法:一行命令出图
截图代码文件
freeze main.go -o screenshot.png
就这一行。freeze 会自动识别语言(Go、Python、Rust、JS 都支持),用 JetBrains Mono 排版,输出一张 PNG。

截图终端输出
freeze –execute "eza -lah"
–execute 会在伪终端里跑这条命令,把带颜色的 ANSI 输出原封不动渲进图里,配色完全保留。

三种格式一次输出
freeze main.go -o out.{svg,png,webp}
SVG 矢量图、4× 高清 PNG、WebP,一条命令同时生成。写文档用 SVG,发微博用 PNG,一步到位。
进阶定制:从"能用"到"真好看"
默认生成的图已经不错,但定制才是 freeze 真正厉害的地方。
预置风格
freeze -c full main.go
full 预置直接出 macOS 风格的窗口截图——红绿黄三个圆点,写博客配图很好用。

base 则是极简风格,干净没有多余装饰。
手动调参:阴影 + 圆角 + 窗口
freeze main.go \\
–window \\
–border.radius 8 \\
–shadow.blur 20 \\
–shadow.y 10
圆角 + 阴影 + 窗口控件叠在一起,出来的效果比很多在线截图工具都漂亮。

主题切换
freeze main.go –theme dracula
内置几十种主题,Dracula、GitHub、One Dark、Tokyo Night 随便选,总有一款对得上你的审美。

行号与部分截取
# 显示行号
freeze main.go –show-line-numbers
# 只截第 10 到第 25 行
freeze main.go –show-line-numbers –lines 10,25
写教程的时候只需要展示关键片段,–lines 用起来特别顺手。
自定义字体
freeze main.go \\
–font.family "SF Mono" \\
–font.size 16 \\
–line-height 1.4
还支持字体文件嵌入(TTF/WOFF/WOFF2),生成的 SVG 里自带字体,分享出去不会乱。
背景色 + 边框
freeze main.go \\
–background "#1e1e2e" \\
–border.width 1 \\
–border.color "#414559" \\
–border.radius 12

交互式 TUI:不想背参数就用这个
freeze –interactive
打开交互界面,左边调参数,右边实时看效果,调满意了按确认,配置自动写入 ~/.config/freeze/user.json。
以后直接 freeze -c user main.go 就用自己存的配置,不用每次重新敲一堆参数。
截图正在运行的 TUI 程序
这个用法我觉得相当妙。配合 tmux,可以截下正在运行的终端 UI 程序:
# 先在 tmux 另一个面板里开着你的 TUI,比如 Helix 编辑器
hx
# 用 capture-pane 捕获当前面板,pipe 给 freeze
tmux capture-pane -pet 1 | freeze -c full
给自己写的 CLI 工具做文档时,这样生成的截图比手动截屏干净得多。

配合管道和 CI 使用
从 stdin 读取:
cat main.go | freeze –language go -o out.png
输出到 stdout(SVG 格式):
freeze main.go > output.svg
完全可以塞进 CI/CD 流程,自动为 README 或 Changelog 生成代码截图,持续维护文档配图不再是负担。
说说我的感受
用 freeze 一段时间之后,感觉最明显的一点是:它把一件本来要折腾的事情压缩到了极限。
以前截代码图,要么开浏览器用 Carbon.now.sh,要么装 VS Code 插件,流程都不短。freeze 的定位就是终端原住民——你在终端里工作,截个图也不用离开终端。
交互式 TUI + 配置持久化这两个设计很聪明。不熟悉参数的人,用 –interactive 调一次,以后直接复用;熟悉参数的人,直接写 flag,更快。两类用户都照顾到了。
如果你写技术博客、维护开源项目文档,或者经常在社交媒体分享代码片段,装一个 freeze 试试,大概率回不去了。
🔗 开源地址:https://github.com/charmbracelet/freeze
你用过 freeze 或者有其他顺手的代码截图工具吗?欢迎评论区聊聊,说不定能挖到更好玩的东西。
我是顾北,关注我,获取更多好玩有趣的 AI 工具!
谢谢你阅读我的文章~
我们下期再见!
PS:本文部分内容由AI辅助创作

