Oh-My-Posh 调教全记录：从报错到完美配置（附自动化脚本)

缘起：一场「看起来没事但用起来很烦」的故障

用户的 PowerShell 提示符配置了一片混乱——Oh-My-Posh 装上了，但主题加载总报找不到文件的警告。更要命的是，他想要三个核心功能：Git 分支显示、Python 版本显示、命令执行时长，但很多好看的主题偏偏缺胳膊少腿。

我接手了这个烂摊子，决定从根子上修好它，顺便把过程抽象成可复用的自动化脚本。

问题诊断：Windows Store 版 Oh-My-Posh 的隐藏陷阱

症状

[WARN] Theme 'powerlevel10k_rainbow' not found...

主题明明存在于系统里，但 Oh-My-Posh 就是找不到。

根因

Windows Store 安装的 Oh-My-Posh 把主题放在了这个鬼地方：

C:\Program Files\WindowsApps\ohmyposh.cli_<版本号>_x64__<哈希>\themes\

这个路径有三个问题：

版本号每次更新都变——配置文件里写死路径，更新后就失效
NTFS 权限锁死——普通用户无法直接读写这个目录
动态检测不准——PowerShell 的 Get-Command oh-my-posh 返回的是 symlink 路径，用 Get-Item .Target 去解析会得到空值

排查过程

# 这条命令不会给你真实路径
(Get-Command oh-my-posh).Source

# 在 WindowsApps 下 Get-ChildItem 会报权限错误
Get-ChildItem "C:\Program Files\WindowsApps" | Where-Object { $_.Name -like "ohmyposh*" }

# 只能用笨办法：已知版本号的情况下猜路径
"C:\Program Files\WindowsApps\ohmyposh.cli_0.21.1_x64__ohmyposh\themes"

解决方案一：把所有主题复制到用户目录

思路

与其和 WindowsApps 的权限斗智斗勇，不如一次性把所有主题复制到用户可控的稳定目录：

C:\Users\<用户名>\.config\oh-my-posh\themes\

这个路径：

永久存在，不受 Oh-My-Posh 更新影响
普通用户有完整读写权限
可以随意增删修改主题文件

实现

# 通过 bash 直接访问 WindowsApps（权限比 PowerShell 宽）
cp /mnt/c/Program\ Files/WindowsApps/ohmyposh.cli_*/themes/*.omp.json \
   ~/.config/oh-my-posh/themes/

结果：122 个内置主题全部就位，从此告别找不到主题的警告。

解决方案二：生成干净的主配置文件

旧配置的毛病

原始 $PROFILE 里可能塞了一堆过时代码、环境变量指向不存在的路径、多个 init 语句互相覆盖。

新架构：1_shell.ps1

把配置拆出来成一个独立文件，由 $PROFILE 引用它：

# $PROFILE 里只有这一行
. "$env:USERPROFILE\1_shell.ps1"

1_shell.ps1 的职责清晰划分：

# 1_shell.ps1 v5

# 1. 编码修复（解决中文乱码）
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8

# 2. Oh-My-Posh 初始化（硬编码稳定路径）
$ThemeDir = "$env:USERPROFILE\.config\oh-my-posh\themes"
$ThemeName = "powerlevel10k_rainbow"
oh-my-posh init pwsh --config "$ThemeDir\$ThemeName.omp.json" | Invoke-Expression

# 3. 运行时主题切换器
function omp-theme {
    param([string]$Name)
    $t = "$ThemeDir\$Name.omp.json"
    if (Test-Path $t) {
        oh-my-posh init pwsh --config $t | Invoke-Expression
    }
}

# 4. 辅助工具
# PSReadLine（预测补全）、Terminal-Icons（文件图标）、
# zoxide（智能 cd）、常用别名（ll、g、c）

效果

改动配置后无需动 $PROFILE——只改 1_shell.ps1
一条命令切换主题——omp-theme catppuccin_mocha，无需重开终端
职责单一——$PROFILE 变成了一个极简的 bootstrapper

解决方案三：增强高颜值主题

用户挑了三个「好看但功能残缺」的主题：

主题	原缺功能	增强方式
catppuccin_mocha	python + 执行时长	新增 right block，右侧显示
tokyonight_storm	执行时长	在已有 right block 末尾追加
dracula	python + 执行时长	在 rprompt block 用 diamond 风格追加

案例：给 catppuccin_mocha 加 Python 版本和执行时长

修改前：只有一个 left block，右侧空白

修改后：追加 right block

{
  "alignment": "right",
  "segments": [
    {
      "type": "python",
      "style": "plain",
      "foreground": "#A6E3A1",
      "template": "🐍 {{ .Full }} "
    },
    {
      "type": "executiontime",
      "style": "plain",
      "foreground": "#6C7086",
      "template": "{{ .FormattedMs }}"
    }
  ],
  "type": "prompt"
}

核心思路：Oh-My-Posh 的 block 是积木，新增一个 alignment: right 的 block 不会破坏原有样式，只会在右侧追加内容。颜色选用主题原有的调色板，保持视觉和谐。

自动化：Install-PoshSetup.ps1

把整个流程封装成一条命令，在新机器上 30 秒搞定一切：

功能清单

✅ 诊断 oh-my-posh 是否安装
✅ 自动定位 WindowsApps 下主题目录（支持 Windows Store / Chocolatey / 手动安装）
✅ 复制所有 122 个内置主题到用户目录
✅ 生成/更新 1_shell.ps1 主配置
✅ 确保 $PROFILE 正确引用 1_shell.ps1
✅ 增强三个高颜值主题（catppuccin_mocha、tokyonight_storm、dracula）

部署指南

第一步：在新机器安装 Oh-My-Posh

winget install JanDeDobbeleer.OhMyPosh

第二步：运行安装脚本

完整安装（指定默认主题）：

irm https://raw.githubusercontent.com/sysfox/posh-setup/main/Install-PoshSetup.ps1 | iex

或者本地运行：

# 把 Install-PoshSetup.ps1 下载到本地后
.\Install-PoshSetup.ps1 -Theme catppuccin_mocha

仅增强主题（跳过配置生成）：

.\Install-PoshSetup.ps1 -EnhanceOnly

第三步：重开 PowerShell

脚本执行完成后，关闭所有 PowerShell 窗口并重新打开，配置自动生效。

第四步：运行时切换主题

# 温柔莫卡色调
omp-theme catppuccin_mocha

# 深蓝东京夜
omp-theme tokyonight_storm

# 经典德古拉紫
omp-theme dracula

# 内置彩虹全家桶
omp-theme powerlevel10k_rainbow

# 查看所有带 git+python+exec 的主题
# （在 omp-theme 输错主题名时会自动列出）

完整文件清单

C:\Users\<用户名>\
├── 1_shell.ps1                          # 主配置文件
├── Documents\WindowsPowerShell\
│   └── Microsoft.PowerShell_profile.ps1  # $PROFILE（只一行引用）
└── .config\oh-my-posh\
    ├── Install-PoshSetup.ps1             # 安装脚本
    └── themes\
        ├── catppuccin_mocha.omp.json    # 增强版 ✓ python + exec
        ├── tokyonight_storm.omp.json    # 增强版 ✓ exec
        ├── dracula.omp.json             # 增强版 ✓ python + exec
        └── *.omp.json                   # 其他 119 个内置主题

经验总结

为什么这个方案比「改 $POSH_THEMES_PATH」更稳？

方案	优点	缺点
改 POSH_THEMES_PATH 环境变量	改动小	Windows Store 版路径含版本号，更新后失效
复制到用户目录 + 硬编码路径	永久生效、可编辑	首次需手动复制
动态检测 oh-my-posh 安装路径	自动化	WindowsApps 权限问题导致检测不准

Oh-My-Posh block 布局小技巧

alignment: left —— 在命令行左侧
alignment: right —— 在命令行右侧（超出宽度时会被截断）
type: "rprompt" —— 始终贴右对齐，不截断
invert_powerline: true —— 翻转 powerline 箭头方向，用于右侧钻石块

Python 版本显示的条件控制

如果不想在所有目录下都显示 Python 版本（没有 .py 文件也显示很烦），可以在段配置里加：

{
  "type": "python",
  "template": "{{ if .has_python }}🐍 {{ .Full }}{{ end }}",
  "type": "python",
  "style": "plain",
  "foreground": "#A6E3A1",
  "template": "{{ .Full }} "
}

这样只有在检测到 Python 项目（有 __pycache__、.venv、pyproject.toml 等）时才会显示。

写在最后

这次调教的核心收获是：Windows Store 应用的分发方式（版本化路径 + NTFS 限制）天然和「稳定配置」冲突。解决方案不是修修补补，而是绕过它——把主题复制出来，放到用户完全掌控的目录下。

从此 Oh-My-Posh 更新不影响配置，换机器跑一遍脚本秒恢复，多人协作时代码共享即可。这大概就是 DevOps 思维在桌面环境上的一个小小应用吧。

本文档由 Kimi 2.6 + MiniMax 辅助生成，脚本在 Windows 11 Pro + PowerShell 5.1 上验证通过。