Oh My Posh 终端提示符颜色配置完全指南

Oh My Posh 终端提示符颜色配置完全指南

oh-my-posh JanDeDobbeleer/oh-my-posh: Oh My Posh 是一个跨平台的终端定制工具，用于增强 PowerShell、Zsh 和 Fish Shell 等终端的视觉效果，提供丰富的主题和样式来显示命令提示符，让终端界面更个性化且信息丰富。 项目地址: https://gitcode.com/gh_mirrors/oh/oh-my-posh

前言

Oh My Posh 是一款强大的终端提示符定制工具，其颜色系统设计灵活且功能丰富。本文将全面解析其颜色配置机制，帮助用户打造个性化的终端体验。

基础颜色类型

Oh My Posh 支持多种颜色表示方式：

1. 真彩色(True Color)：使用十六进制格式，如 #CB4B16
2. ANSI 标准颜色：
   • 8种基础色：black、red、green、yellow、blue、magenta、cyan、white
   • 8种扩展色：darkGray、lightRed、lightGreen、lightYellow、lightBlue、lightMagenta、lightCyan、lightWhite
3. 256色模式：使用数字编号，如 0 表示黑色
4. 特殊关键字：
   • transparent：透明效果
   • foreground/background：引用当前段落的颜色
   • parentForeground/parentBackground：继承前一段落的颜色
   • accent：系统强调色(仅Windows/macOS)

动态颜色模板

通过模板系统，可以根据上下文动态设置颜色。模板基于Go的text/template语法，并扩展了Sprig函数库。

示例配置：

{
  "foreground_templates": [
    '{{if contains "default" .Profile}}#FFA400{{end}}',
    '{{if contains "jan" .Profile}}#f1184c{{end}}'
  ]
}

工作原理：系统会顺序检查模板数组，使用第一个返回非空字符串的模板结果作为颜色值。如果没有匹配，则回退到默认颜色。

内联颜色覆盖

可以在文本中直接指定颜色覆盖，语法为：

<前景色,背景色>文本</>

示例：

• <#CB4B16>红色文本</>
• <#CB4B16,#FFFFFF>红底白字文本</>
• <,#FFFFFF>仅设置背景色</>

调色板(Palette)系统

调色板定义

调色板是一组命名的标准颜色集合，在配置顶层定义：

{
  "palette": {
    "git-foreground": "#193549",
    "git": "#FFFB38",
    "git-modified": "#FF9248"
  }
}

调色板引用

使用 p:键名 格式引用调色板颜色：

{
  "foreground": "p:git-foreground",
  "background": "p:git"
}

高级特性

1. 错误处理：无效引用会回退到透明色
2. 递归解析：支持调色板颜色引用其他调色板颜色
3. 与标准颜色混用：可以在同一配置中混合使用调色板和标准颜色

多调色板系统

支持根据条件动态选择调色板，适合实现明暗主题切换：

{
  "palettes": {
    "template": '{{ if eq .Shell "pwsh" }}latte{{ else }}frappe{{ end }}',
    "list": {
      "latte": { "blue": "#7287fd" },
      "frappe": { "blue": "#4B95E9" }
    }
  }
}

颜色循环(Cycle)

当需要固定颜色序列循环时，可以使用cycle属性：

{
  "cycle": [
    { "background": "p:blue", "foreground": "p:white" },
    { "background": "p:green", "foreground": "p:black" }
  ]
}

最佳实践建议

1. 命名规范：为调色板颜色使用有意义的名称
2. 主题分离：将颜色定义与逻辑配置分离
3. 错误排查：检查无效的调色板引用
4. 性能考虑：复杂的模板逻辑可能影响提示符渲染速度

通过灵活运用这些颜色配置功能，可以打造出既美观又实用的终端提示符，完美适配各种工作场景和个人偏好。

oh-my-posh JanDeDobbeleer/oh-my-posh: Oh My Posh 是一个跨平台的终端定制工具，用于增强 PowerShell、Zsh 和 Fish Shell 等终端的视觉效果，提供丰富的主题和样式来显示命令提示符，让终端界面更个性化且信息丰富。 项目地址: https://gitcode.com/gh_mirrors/oh/oh-my-posh