WezTerm 配色开发指南使用wezterm.color.get_default_colors()继承并改造内置默认配色【免费下载链接】weztermA GPU-accelerated cross-platform terminal emulator and multiplexer written by wez and implemented in Rust项目地址: https://gitcode.com/GitHub_Trending/we/wezterm本文围绕 WezTerm 的 Lua 配置 API 函数wezterm.color.get_default_colors()展开讲解如何读取终端内置的默认调色板、将其作为自定义配色方案的基础进行继承与改写并结合wezterm.color模块的配套函数实现「默认配色 局部覆写」的可维护配色工作流。读完本文你将掌握该函数的返回值结构、默认配色在源码中的具体构成以及如何在wezterm.lua中落地一套可运行的配色方案定义。wezterm.color.get_default_colors()是 WezTerm 在wezterm.color模块自版本20220807-113146-c2fee766起提供对应 docs/config/lua/wezterm.color/index.markdown中提供的一个颜色工具函数。它的作用是返回终端在未应用任何配色方案时即保持内置默认外观所使用的整组颜色。官方文档对它的定位非常明确当你需要在某个自定义配色方案定义中引用这些默认颜色时它是最直接的取数入口。一、函数签名与版本要求wezterm.color.get_default_colors()返回值一个 Lua 表table结构等价于一份配色方案定义即Palette其中包含前景色、背景色、光标颜色、选区颜色以及完整的 ANSI 调色板等字段。版本要求自20220807-113146-c2fee766版本起可用该版本号也是wezterm.color模块整体的引入版本。适用场景在自定义配色方案定义color_schemes表中的条目中以默认颜色为基底覆写其中部分颜色项。二、返回值结构一份完整的Palette定义从源码实现看get_default_colors()返回的并不是某个临时构造的简单颜色对象而是完整的调色板。其实现位于 lua-api-crates/color-funcs/src/lib.rs#L121-L127color.set( get_default_colors, lua.create_function(|_, _: ()| { let palette: Palette wezterm_term::color::ColorPalette::default().into(); Ok(palette) })?, )?;它首先取得终端内部默认调色板ColorPalette::default()在 term/src/color.rs#L94-L99 中通过惰性静态单例DEFAULT_PALETTE缓存再转换为配置层的Palette结构返回。也就是说你在 Lua 中拿到的表与一份标准配色方案定义拥有完全一致的字段。Palette结构的字段定义在 config/src/color.rs#L130-L179主要包括字段含义默认值来源foreground复位属性后的默认文本颜色256 色表中的 Grey70索引 249background默认背景色ANSI 黑索引 0即#000000cursor_bg/cursor_fg光标背景色 / 前景色背景色为#52ad70前景色为黑色cursor_border光标描边颜色#52ad70selection_fg/selection_bg选中文本的前景色 / 背景色半透明紫rgba(128, 102, 153, 0.5)等ansi8 个基础 ANSI 颜色XTerm ANSI 16 色中的前 8 个brights8 个亮色 ANSI 颜色XTerm ANSI 16 色中的后 8 个indexed16256 号自定义调色板索引256 色表216 色立方体 24 级灰度scrollbar_thumb/split滚动条滑块 / 窗格分隔线颜色深灰#222222/#444444visual_bell、compose_cursor等视觉响铃、组合键光标等场景色可选字段其中ansi与brights的具体取值可在 term/src/color.rs#L105-L141 的compute_default()中逐一核对基础 8 色黑#000000、栗色#cc5555、绿#55cc55、橄榄#cdcd55、藏青#5455cb、紫#cc55cc、青#7acaca、银灰#cccccc亮色 8 色灰#555555、红#ff5555、亮绿#55ff55、黄#ffff55、蓝#5555ff、品红#ff55ff、亮青#55ffff、白#ffffff索引 16231 为 xterm 兼容的 216 色立方体色阶0x00/0x5f/0x87/0xaf/0xd7/0xff见 term/src/color.rs#L143-L153索引 232255 为 24 级灰度0x08至0xee见 term/src/color.rs#L155-L165。这解释了为什么文档说该函数「返回默认情况下会使用的那组颜色」——它本质上就是终端渲染时兜底使用的整份调色板快照。三、核心用法基于默认配色创建自定义方案文档给出的典型场景是把默认颜色当做一个「可改写的基底」配合color_schemes配置项注册自定义配色。原文档的完整示例为local wezterm require wezterm local my_gruvbox wezterm.color.get_builtin_schemes()[Gruvbox Light] my_gruvbox.background red local my_default wezterm.color.get_default_colors() my_default.background red return { color_schemes { [My Gruvbox] my_gruvbox, [My Default] my_default, }, color_scheme My Gruvbox, }这段配置做了三件事可以逐行拆解取得一个内置配色wezterm.color.get_builtin_schemes()返回以方案名为键、以方案定义为值的 Lua 表从中取出内置的Gruvbox Light旧版本可用wezterm.get_builtin_color_schemes()见 docs/config/lua/wezterm.color/get_builtin_schemes.md取得默认配色wezterm.color.get_default_colors()返回默认调色板随后同样把background覆写为red注册到配置把两个改写过的新方案放入color_schemes表键为方案名值为方案定义并设置当前生效方案color_scheme。注意这里的覆写方式get_default_colors()返回的表是可变 Lua 表直接对my_default.background赋值即可完成局部修改其余字段foreground、ansi、brights、光标色、选区色等会全部保留默认值。这正是该函数的核心价值——你只需要关心想改的颜色其余交给默认值兜底而不必手工把整份调色板抄写进配置。四、实战扩展与wezterm.color其他函数组合get_default_colors()的返回值与任何标准配色方案定义结构一致因此可以无缝衔接wezterm.color模块的其余工具函数组合出更灵活的配色工作流。4.1 用parse()做颜色换算后覆写配合 docs/config/lua/wezterm.color/parse.md 中的wezterm.color.parse()可以先把颜色字符串解析为颜色对象再提取 HSLA 信息做程序化处理。例如把默认配色的背景改为「更深的暗色」local wezterm require wezterm local colors wezterm.color.get_default_colors() -- 解析为颜色对象提取 HSLA 通道 local bg wezterm.color.parse(colors.background) local h, s, l, a bg:hsla() -- 将亮度压到原来的 70%获得更暗的背景 local darker wezterm.color.from_hsla(h, s, l * 0.7, a) return { color_schemes { [My Default Darker] { background tostring(darker), foreground colors.foreground, ansi colors.ansi, brights colors.brights, }, }, color_scheme My Default Darker, }hsla()、from_hsla()等方法由wezterm.color模块的颜色包装类型ColorWrap提供方法清单见 lua-api-crates/color-funcs/src/lib.rs#L48-L106支持lighten、darken、saturate、adjust_hue_fixed、complement等常见色彩变换。4.2 与内置方案列表结合从默认配色做差异化定制如果需要为同一份默认配色派生多个变体可以配合get_builtin_schemes()的「取方案 → 改字段 → 注册」模式参考 docs/config/lua/wezterm.color/get_builtin_schemes.md 中的随机换肤示例。核心模式始终一致任意方案定义包括默认配色都是一张可覆写的表改完放进color_schemes即可。4.3 配合save_scheme()落地为配色文件对默认配色完成改造后如果希望把它固化成独立的 TOML 配色文件长期使用可借助wezterm.color.save_scheme()实现见 lua-api-crates/color-funcs/src/lib.rs#L140-L150local wezterm require wezterm local colors wezterm.color.get_default_colors() colors.background red wezterm.color.save_scheme(colors, { name My Default }, my-default.toml)生成的 TOML 文件与 docs/config/lua/wezterm.color/load_scheme.md 中描述的load_scheme()可读格式一致之后既能用load_scheme()重新加载也能直接放入color_schemes表使用。五、底层原理默认调色板是如何生成的理解返回值背后的生成逻辑有助于判断哪些字段会被填充、哪些字段可能为空。从源码看终端侧的默认调色板由ColorPalette::compute_default()一次性计算term/src/color.rs#L101-L192并通过DEFAULT_PALETTE惰性静态单例缓存ColorPalette::default()每次返回克隆保证多次调用get_default_colors()结果一致且互不影响转换到配置层时通过FromColorPalette for Palette把每个非可选字段包装为Option并填充config/src/color.rs#L236-L249因此你在 Lua 中读到的ansi、brights等字段都是完整可用的数组配色方案在应用时会经过overlay_with()的覆写合并逻辑config/src/color.rs#L182-L233你注册的自定义方案字段优先未指定的字段回退到默认方案——这与「从get_default_colors()取值再局部覆写」的思路在语义上是一致的两者可以互为印证。六、完整可运行示例一套「默认底 多方案」配置综合以上内容下面给出一份可直接放入wezterm.lua的完整配置它基于默认配色派生出深浅两套方案并提供一个仅修改背景色的精简变体local wezterm require wezterm -- 1. 以默认配色为基底派生「默认-红底」方案 local my_default wezterm.color.get_default_colors() my_default.background #300a0a -- 2. 以默认配色为基底派生「默认-蓝底」方案 local my_default_blue wezterm.color.get_default_colors() my_default_blue.background #0a0a30 -- 3. 仅修改前景色的精简写法其余颜色由默认兜底 local my_default_fg wezterm.color.get_default_colors() my_default_fg.foreground #d7d7ff return { color_schemes { [Default Red] my_default, [Default Blue] my_default_blue, [Default Blue FG] my_default_fg, }, -- 支持通过 --config 或运行时覆写切换 color_scheme Default Red, }由于每次调用都会返回一份独立的默认调色板副本你可以放心地为每个变体分别获取基底再各自覆写不会互相污染。七、小结wezterm.color.get_default_colors()返回完整的内置默认调色板字段结构与配色方案定义Palette完全一致它的核心用途是作为自定义配色方案的「继承基底」配合color_schemes配置实现局部覆写避免手工维护整份配色返回值可自由赋值、可读取能与parse()、from_hsla()、save_scheme()等wezterm.color模块函数组合完成解析、变换、固化的完整工作流底层默认值来自 term/src/color.rs 的compute_default()XTerm ANSI 16 色 216 色立方体 24 级灰度转换与覆写逻辑分别位于 config/src/color.rs 与 lua-api-crates/color-funcs/src/lib.rs如需精确核对某个默认色值可直接查阅这些文件。【免费下载链接】weztermA GPU-accelerated cross-platform terminal emulator and multiplexer written by wez and implemented in Rust项目地址: https://gitcode.com/GitHub_Trending/we/wezterm创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考