Catppuccin Nix 模块：为 NixOS 与 home-manager 一键美化 70+ 应用的柔和主题方案
【免费下载链接】nix❄️ Soothing pastel theme for Nix项目地址: https://gitcode.com/gh_mirrors/nix1/nix
如果你正在给 NixOS 配置桌面环境，希望终端、编辑器和窗口管理器用同一套配色，Catppuccin Nix 模块可以直接解决这个问题。它把 Catppuccin 柔和 pastel 主题以 Nix 模块的形式提供出来，一条 enable 就能把同一套颜色应用到 70 多个应用上，而且全部配置都跟随系统声明式管理，可回滚、可复制。
项目能帮你做什么
- 一套配色贯穿全系统：从终端、编辑器到窗口管理器、状态栏乃至登录界面，主题风格统一，不再出现某个应用"格格不入"的情况。
- 配置即代码：主题随系统配置一起管理，
nixos-rebuild一次切换，无需再逐个手改应用配置文件。 - 四种风味、十余种强调色自由组合：明亮的 latte 或深邃的 mocha、薰衣草紫或桃色强调，总能找到顺眼的搭配。
- 粒度可控：每个应用都有独立的
enable、flavor、accent字段，需要时单独覆盖，不影响其他应用。 - 减少本地构建：启用
catppuccin.cache.enable后，主题化包从官方二进制缓存直接拉取。
环境准备与模块接入
前置条件：NixOS 26.05 及以上版本（或同级别的 home-manager 独立安装），并启用 Flakes。项目维护两条线：main分支跟随 unstable，release-x.x分支对应稳定版（如release-26.05），按需选择。
在 flake 中声明输入：
{ inputs = { nixpkgs.url = "https://channels.nixos.org/nixos-unstable/nixexprs.tar.xz"; catppuccin.url = "https://gitcode.com/gh_mirrors/nix1/nix"; }; }再导入对应模块。NixOS 加 home-manager 的组合写法：
modules = [ catppuccin.nixosModules.catppuccin home-manager.nixosModules.home-manager { home-manager.users.you.imports = [ catppuccin.homeModules.catppuccin ]; } ];home-manager 独立安装则把catppuccin.homeModules.catppuccin放入 home.nix 的modules即可。执行nixos-rebuild switch后主题即生效。
选择配色方案与基础配置
核心配置维度有三个：风味（flavor）、强调色（accent）和作用范围。
- latte：明亮的浅色主题，适合白天或光线充足的环境；
- frappé：温暖的中深色，明暗平衡，适合长时间使用；
- macchiato：深邃的深色主题，夜间观感舒适；
- mocha（默认）：对比度最高的深色，高对比偏好和 OLED 屏幕首选。
强调色提供 blue、mauve、pink、lavender、peach 等 14 种，作用于高亮文本、边框、图标等点缀位置。作用范围由全局开关catppuccin.enable控制：打开后所有已适配应用默认启用，也可以对单个应用写enable = false关闭。基础配置示例：
catppuccin = { enable = true; flavor = "macchiato"; # 或 latte、frappe、mocha accent = "blue"; # mauve、pink、lavender 等 14 种 cache.enable = true; # 使用官方二进制缓存 };已适配组件速查
以下按类别列出代表性模块源码文件，文件名与catppuccin.下的选项名一致，完整清单以modules/home-manager/与modules/nixos/目录为准。
终端与 Shell
- Alacritty、Kitty、WezTerm、Fish、Tmux、Zellij
编辑器与 IDE
- Neovim、Helix、VSCode、Zed、Micro
桌面与窗口管理
- Hyprland、Sway、Waybar、Polybar、Hyprlock、Rofi
浏览器与邮件
- Firefox、Thunderbird、Chrome、Qutebrowser
开发工具与 CLI
- Lazygit、GitUI、Delta、K9s、Bat
系统组件（NixOS）
- GRUB、Limine、SDDM、Plymouth、GTK、光标主题
进阶自定义
为单个应用覆盖全局配色。每个应用节点下的flavor与accent默认继承全局值，直接写明即可局部覆盖，效果只作用于该应用：
catppuccin = { enable = true; flavor = "mocha"; alacritty.flavor = "latte"; # 仅终端用浅色 alacritty.accent = "pink"; };注入自定义样式。Wlogout、Waybar 等支持 CSS 的模块提供extraStyle字段，内容会追加到生成的样式表末尾，可以微调圆角、内边距等细节，而不必维护整套配置文件。更进一步的全局级定制，比如替换主题源生成纯黑的 oledpuccin 变体，可以参考catppuccin.sources相关文档 docs/content/docs/Advanced/customization.md。
常见问题
Q：启用后个别应用没有变化？先确认该应用是否被其他配置（插件、个人配置文件）覆盖，必要时重启应用。如果应用不在适配清单里，则说明尚未支持，可用下文方式贡献适配。
Q：支持哪些版本？main分支对应 unstable，release-x.x分支对应稳定版，两者各取所需。模块最低支持 26.05，低于此版本求值时会给出警告。
Q：想临时换风味怎么办？改catppuccin.flavor重新构建即可，全局生效；对个别应用做过的覆盖会保留各自的值，不受影响。
Q：每个主题包都要本地编译吗？不需要。开启catppuccin.cache.enable后，模块会把官方二进制缓存写入nix.settings，主题化包直接从缓存拉取。
下一步
如果你还想为更多应用添加适配，可以参考贡献指南 docs/content/docs/Contributing.md 动手写一个新模块；完整的选项说明与版本记录也都收录在 docs/content/docs 中，欢迎继续探索。
【免费下载链接】nix❄️ Soothing pastel theme for Nix项目地址: https://gitcode.com/gh_mirrors/nix1/nix
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
