如何快速安装lutgen-rs:cargo、Nix、包管理器5分钟上手教程

原创2026-11-15 11:06:482,132 阅读

如何快速安装lutgen-rs:cargo、Nix、包管理器5分钟上手教程

lutgen-rs 是一个用 Rust 编写的高速 LUT(查找表)生成与套色工具,能把流行配色方案转换成 Hald CLUT,并把整套主题色调快速应用到图片和文本文件上。本文带你用 5 分钟完成 lutgen-rs 安装,覆盖 cargo、Nix、系统包管理器与源码构建 4 种方式,新手照做即可。

📦 30 秒认识 lutgen-rs

lutgen-rs 由三个部分组成,按需选择安装即可:

组件 位置 说明
lutgen CLI crates/cli/ 命令行工具:generate 生成 LUT、apply 给图片套色、extract 从图片提取 LUT、patch 批量替换文本中的颜色、palette 管理配色方案
Lutgen Studio crates/studio/ 官方 GUI 图形界面,可编辑调色板并保存
lutgen 库 crates/lib/ Rust 核心库,插值算法见 crates/lib/src/interpolation/

内置配色方案(Catppuccin、Gruvbox、Nord 等)定义在 crates/palettes/palettes.toml。

lutgen-rs LUT 生成器应用主题色之前的原图示例

🧾 安装前准备:环境要求清单

安装方式 前置要求 适合人群
cargo 安装 Rust 工具链(cargo) 大多数 Linux / macOS / Windows 用户
Nix 安装 Nix 包管理器 NixOS 及 Nix 用户
系统包管理器 nixpkgs、Alpine 等发行版 发行版用户
源码构建 Rust nightly-2025-12-04(见 rust-toolchain.toml) 想参与开发的程序员

💡 只装 CLI 一条命令就够;安装 Studio 需要额外系统库(Linux,以 Ubuntu 为例):libxcb-render0-dev、libxcb-shape0-dev、libxcb-xfixes0-dev、libxkbcommon-dev、libssl-dev、wayland。

🚀 最快安装方式:cargo 一键装 lutgen-cli

从 Rust 官方包仓库 crates.io 直接安装,无需编译源码:

# 安装命令行工具
cargo install lutgen-cli

# (可选)安装 GUI 版本
cargo install lutgen-studio

安装完成后验证一下:

lutgen -V
lutgen palette names | grep gruvbox

💡 如果提示找不到 lutgen 命令,把 ~/.cargo/bin 加入 PATH 即可。

🧊 Nix 安装:免依赖、可复现的完整配置

项目的 flake.nix 同时提供 lutgen 与 lutgen-studio 两个包,运行零配置:

git clone https://gitcode.com/gh_mirrors/lu/lutgen-rs
cd lutgen-rs

# 直接运行 CLI(默认包)
nix run .

# 运行 GUI
nix run .#lutgen-studio

需要长期开发时,用 Nix 开发 shell 自动配好工具链:

nix develop

# 进入 shell 后
cargo run -r --bin lutgen
cargo run -r --bin lutgen-studio

📦 系统包管理器:发行版一键安装步骤

lutgen / lutgen-studio 已被收录进多个发行版仓库,常见命令如下:

# nixpkgs(NixOS 及其他 Nix 用户)
nix profile install nixpkgs#lutgen

# Alpine Linux
sudo apk add lutgen

其他发行版可用系统自带的包搜索工具(如 search、searchpkg、distrobox 社区源等)按名称 lutgen 查询是否可用,安装体验与上面一致。

🛠 源码构建:面向开发者的完整步骤

git clone https://gitcode.com/gh_mirrors/lu/lutgen-rs
cd lutgen-rs

# 方式 A:直接安装 CLI
cargo install --path crates/cli

# 方式 B:安装 Studio
cargo install --path crates/studio

注意:仓库通过 rust-toolchain.toml 锁定了 nightly-2025-12-04 工具链,rustup 会自动下载;嫌麻烦就配合上面的 nix develop 使用。

✅ 安装验证:跑通你的第一条 LUT 命令

# 列出全部内置配色
lutgen palette names

# 把图片一键变成 Catppuccin Mocha 主题
lutgen apply --palette catppuccin-mocha my-image.png

# 生成 Hald CLUT 文件,可导入其他修图软件
lutgen generate -p catppuccin-mocha

lutgen-rs 安装教程示例:应用 Catppuccin Mocha LUT 后的图片效果

生成出来的 Hald CLUT 查找表长这样:

lutgen-rs 生成的 Catppuccin Mocha Hald CLUT 查找表

📚 参考资料:项目内文档路径

至此,5 分钟内你已经完成 lutgen-rs 的安装并跑通第一条命令。下一步建议先玩 lutgen apply 给桌面壁纸换个主题色,体验它的「套色」魔法 🎨。

登录后查看全文
lutgen-rs