期望状态配置

非官方测试版翻译

本页面由 PageTurner AI 翻译（测试版）。未经项目官方认可。 发现错误？ 报告问题 →

Oh My Posh 支持期望状态配置（DSC）实现声明式配置管理，可自动化部署并确保多系统间配置一致性。

设计理念

Oh My Posh DSC 在传统配置方案基础上增加了自动化与编排能力。您无需手动配置提示符，只需声明期望状态，DSC 将确保系统始终符合该状态。

DSC 通过资源管理 Oh My Posh 的各个组件：

• 配置资源：管理 Oh My Posh 配置文件

• Shell 资源：处理 Shell 初始化与集成

• 字体资源：追踪已安装的 Nerd Fonts

这些资源既可通过 CLI 独立使用，也可与 WinGet 和 Microsoft DSC 等编排工具集成实现自动化部署。

概览

Oh My Posh 的 DSC 支持提供：

• 声明式配置：定义 Oh My Posh 的期望状态

• 自动化部署：在系统预配流程中配置 Oh My Posh

• Shell 集成：自动配置 bash、zsh、fish、PowerShell 等 Shell 的初始化

• 字体管理：通过 DSC 状态追踪已安装的 Nerd Fonts

• 编排支持：与 WinGet 和 Microsoft DSC 工具集成

DSC 功能通过 oh-my-posh CLI 提供，可独立使用或结合编排工具。

DSC 资源

Oh My Posh 提供以下 DSC 资源：

配置资源

管理 Oh My Posh 配置文件。

操作指令：get、set、export、schema

# Get current configuration state
oh-my-posh config dsc get

# Apply a configuration
oh-my-posh config dsc set --state '{"states":[{"source":"~/mytheme.omp.json","format":"json"}]}'

# Get configuration schema
oh-my-posh config dsc schema

Shell 资源

管理 Shell 初始化与集成。

操作指令：get、set、export、schema

# Get current shell configurations
oh-my-posh init bash dsc get

# Configure shell initialization
oh-my-posh init bash dsc set --state '{"states":[{"name":"bash","command":"oh-my-posh init bash --config ~/mytheme.omp.json"}]}'

字体资源

追踪通过 Oh My Posh 安装的 Nerd Fonts。

操作指令：get、export、schema

# Get installed fonts
oh-my-posh font dsc get

# Get font schema
oh-my-posh font dsc schema

直接 CLI 使用

您可直接通过命令行使用 DSC 指令进行配置管理。

管理配置

获取状态

检索当前配置状态：

oh-my-posh config dsc get

示例输出：

{
  "states": [
    {
      "format": "json",
      "source": "~/mytheme.omp.json"
    }
  ]
}

设置状态

应用新配置状态：

oh-my-posh config dsc set --state '{"states":[{"source":"~/mytheme.omp.json","format":"json"}]}'

此操作将在指定位置按给定格式创建或更新配置文件。

架构

获取配置资源的 JSON 架构：

oh-my-posh config dsc schema

此架构可用于理解配置状态的结构与可用选项。

管理 Shell 集成

Bash

配置 bash 的 Oh My Posh 初始化：

# Get current state
oh-my-posh init bash dsc get

# Set initialization
oh-my-posh init bash dsc set --state '{"states":[{"name":"bash","command":"oh-my-posh init bash --config ~/mytheme.omp.json"}]}'

此操作将自动在 .bashrc 或 .bash_profile 中添加 Oh My Posh 初始化命令。

Zsh

配置 zsh 的 Oh My Posh 初始化：

# Get current state
oh-my-posh init zsh dsc get

# Set initialization
oh-my-posh init zsh dsc set --state '{"states":[{"name":"zsh","command":"oh-my-posh init zsh --config ~/mytheme.omp.json"}]}'

此操作将自动在 .zshrc 中添加 Oh My Posh 初始化命令。

PowerShell

配置 PowerShell 的 Oh My Posh 初始化：

# Get current state
oh-my-posh init pwsh dsc get

# Set initialization
oh-my-posh init pwsh dsc set --state '{"states":[{"name":"pwsh","command":"oh-my-posh init pwsh --config ~/mytheme.omp.json"}]}'

此操作将自动在 PowerShell 配置文件中添加 Oh My Posh 初始化命令。

Fish

为 fish shell 配置 Oh My Posh 初始化：

# Get current state
oh-my-posh init fish dsc get

# Set initialization
oh-my-posh init fish dsc set --state '{"states":[{"name":"fish","command":"oh-my-posh init fish --config ~/mytheme.omp.json"}]}'

该操作会自动在 fish 的 config.fish 文件中添加 Oh My Posh 初始化命令。

通过 WinGet 进行编排

WinGet 配置支持在单个声明式文件中安装 Oh My Posh 并应用配置。

基础 WinGet 配置

创建配置文件用于安装和配置 Oh My Posh：

oh-my-posh-setup.yaml

$schema: https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/v3/config/document.json
metadata:
  winget:
    processor: dscv3
resources:
  - name: Install Oh My Posh
    type: Microsoft.WinGet.DSC/WinGetPackage
    properties:
      id: JanDeDobbeleer.OhMyPosh
      source: winget

应用配置：

winget configure oh-my-posh-setup.yaml

包含配置和 shell 的完整设置

此示例安装 Oh My Posh、添加配置并初始化 PowerShell：

oh-my-posh-complete.yaml

$schema: https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/v3/config/document.json
metadata:
  winget:
    processor: dscv3
resources:
  - name: Install Oh My Posh
    type: Microsoft.WinGet.DSC/WinGetPackage
    properties:
      id: JanDeDobbeleer.OhMyPosh
      source: winget

  - name: Add Oh My Posh configuration
    type: OhMyPosh/Config
    properties:
      states:
        - source: ~/mytheme.omp.json
          format: json

  - name: Initialize PowerShell
    type: OhMyPosh/Shell
    properties:
      states:
        - name: pwsh
          command: oh-my-posh init pwsh --config ~/mytheme.omp.json

通过以下命令应用：

winget configure oh-my-posh-complete.yaml

多 shell 配置

使用不同配置初始化多个 shell：

oh-my-posh-multi-shell.yaml

$schema: https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/v3/config/document.json
metadata:
  winget:
    processor: dscv3
resources:
  - name: Install Oh My Posh
    type: Microsoft.WinGet.DSC/WinGetPackage
    properties:
      id: JanDeDobbeleer.OhMyPosh
      source: winget

  - name: Add work configuration
    type: OhMyPosh/Config
    properties:
      states:
        - source: ~/work-theme.omp.json
          format: json

  - name: Add personal configuration
    type: OhMyPosh/Config
    properties:
      states:
        - source: ~/personal-theme.omp.json
          format: json

  - name: Initialize PowerShell with work configuration
    type: OhMyPosh/Shell
    properties:
      states:
        - name: pwsh
          command: oh-my-posh init pwsh --config ~/work-theme.omp.json

  - name: Initialize Bash with personal configuration
    type: OhMyPosh/Shell
    properties:
      states:
        - name: bash
          command: oh-my-posh init bash --config ~/personal-theme.omp.json

通过 Microsoft DSC 进行编排

Microsoft DSC (dsc) 提供跨平台配置管理能力。Oh My Posh 提供原生 DSC 资源，可直接用于 DSC 配置文档。

DSC 配置示例

创建 Oh My Posh 的配置文档：

oh-my-posh-dsc.yaml

$schema: https://aka.ms/dsc/schemas/v3/bundled/config/document.json
resources:
  - name: Add Oh My Posh configuration
    type: OhMyPosh/Config
    properties:
      states:
        - source: ~/mytheme.omp.json
          format: json

  - name: Initialize PowerShell
    type: OhMyPosh/Shell
    properties:
      states:
        - name: pwsh
          command: oh-my-posh init pwsh --config ~/mytheme.omp.json

使用 dsc CLI 应用配置：

dsc config set --document oh-my-posh-dsc.yaml

包含多 shell 的完整配置

oh-my-posh-complete-dsc.yaml

$schema: https://aka.ms/dsc/schemas/v3/bundled/config/document.json
resources:
  - name: Add primary configuration
    type: OhMyPosh/Config
    properties:
      states:
        - source: ~/primary-theme.omp.json
          format: json

  - name: Add secondary configuration
    type: OhMyPosh/Config
    properties:
      states:
        - source: ~/secondary-theme.omp.json
          format: yaml

  - name: Initialize PowerShell
    type: OhMyPosh/Shell
    properties:
      states:
        - name: pwsh
          command: oh-my-posh init pwsh --config ~/primary-theme.omp.json

  - name: Initialize Bash
    type: OhMyPosh/Shell
    properties:
      states:
        - name: bash
          command: oh-my-posh init bash --config ~/primary-theme.omp.json

  - name: Initialize Zsh
    type: OhMyPosh/Shell
    properties:
      states:
        - name: zsh
          command: oh-my-posh init zsh --config ~/secondary-theme.omp.json

资源类型

Oh My Posh 提供以下 DSC 资源类型：

OhMyPosh/Config

管理 Oh My Posh 配置文件。

属性：

• states (数组): 配置状态列表
  • source (字符串): 配置文件路径
  • format (字符串): 配置文件格式 (json, yaml, toml)

OhMyPosh/Shell

管理 shell 初始化配置。

属性：

• states (数组): shell 配置列表
  • name (字符串): shell 名称 (bash, zsh, pwsh, fish 等)
  • command (字符串): Oh My Posh 初始化命令

OhMyPosh/Font

追踪已安装的 Nerd Fonts。该资源为只读类型，当通过 Oh My Posh 安装字体会自动更新。

配置状态管理

DSC 状态存储在 Oh My Posh 缓存中，跨会话持久化保存。这支持：

• 状态追踪: Oh My Posh 记录通过 DSC 设置的配置

• 幂等性: 多次执行相同 DSC 命令会获得相同结果

• 状态验证: 在变更前查询当前状态

高级用法

多配置文件管理

可管理多个配置文件：

oh-my-posh config dsc set --state '{
  "states": [
    {"source":"~/work.omp.json","format":"json"},
    {"source":"~/personal.omp.json","format":"json"}
  ]
}'

特定 shell 初始化

为不同 shell 使用不同配置进行初始化：

# Bash with one configuration
oh-my-posh init bash dsc set --state '{"states":[{"name":"bash","command":"oh-my-posh init bash --config ~/bash-theme.omp.json"}]}'

# PowerShell with another configuration
oh-my-posh init pwsh dsc set --state '{"states":[{"name":"pwsh","command":"oh-my-posh init pwsh --config ~/pwsh-theme.omp.json"}]}'

支持的 shell

DSC shell 配置支持以下 shell：

• bash: 配置 .bashrc 或 .bash_profile

• zsh: 配置 .zshrc

• fish: 配置 ~/.config/fish/config.fish

• pwsh: 配置 PowerShell 配置文件 ($PROFILE)

• nu: 配置 ~/.config/nushell/config.nu

• elvish: 配置 .elvish/rc.elv

• xonsh：配置 .xonshrc 文件

Shell 集成功能会自动执行以下操作：

• 若配置文件不存在则自动创建

• 更新现有的 Oh My Posh 初始化命令

• 保留 shell 特有的命令语法

• 维持正确的缩进和格式

相关阅读

• 通用配置 - 主配置文档

• 安装指南 - Oh My Posh 安装说明

• 主题库 - 可用主题预览

• WinGet 配置 - WinGet DSC 文档

• Microsoft DSC - Microsoft DSC 文档