Oh My Posh + 终端美化 安装文档【windows】

官方文档不太线性，看起来有点晕，弄通了总结下

Oh My Posh + 终端美化 安装文档

适用于 Windows + PowerShell，让终端提示符和文件列表带图标、更美观。

一、安装 Oh My Posh

在 PowerShell 中执行（任选一种）：

# 方式 1：winget（推荐）
winget install JanDeDobbeleer.OhMyPosh --source winget

# 方式 2：官方安装脚本
Set-ExecutionPolicy Bypass -Scope Process -Force; Invoke-Expression ((New-Object System.Net.WebClient).DownloadString('https://ohmyposh.dev/install.ps1'))

安装后关闭并重新打开终端，执行 oh-my-posh --version 确认安装成功。

二、配置 PowerShell 启动时加载 Oh My Posh

  1. 确认配置文件路径：

    $PROFILE
# 常见路径：C:\Users\你的用户名\Documents\WindowsPowerShell\Microsoft.PowerShell_profile.ps1

  2. 若文件不存在则创建：

    New-Item -Path $PROFILE -Type File -Force

  3. 用记事本打开并编辑：

    notepad $PROFILE

  4. 在文件中写入以下内容并保存：

    # Oh My Posh - 美化 PowerShell 提示符
# 主题可选: jandedobbeleer, atomic, powerlevel10k_rainbow, star, slimfat 等
oh-my-posh init pwsh --config "jandedobbeleer" | Invoke-Expression

# Terminal-Icons：让 ls 等命令显示文件类型图标
Import-Module -Name Terminal-Icons

  5. 安装 Terminal-Icons 模块，先执行：

    Install-Module -Name Terminal-Icons -Repository PSGallery -Scope CurrentUser

  6. 使配置生效：

    . $PROFILE

    或直接新开一个终端窗口。

三、安装 Nerd Font（解决图标方框/乱码）

Oh My Posh 和 Terminal-Icons 的图标依赖 Nerd Font，否则会显示为方框或乱码。

  1. 安装字体（任选一个）：

    oh-my-posh font install Meslo
# 或
oh-my-posh font install "FiraCode"
oh-my-posh font install "CaskaydiaCove"

    按提示选择字体并完成安装。

  2. 在终端中设置使用该字体：

    • Windows Terminal：设置 → 配置文件 → 默认值 → 外观 → 字体 → 选择刚安装的 Nerd Font（如 MesloLGM Nerd Font）。
    • Cursor / VS Code 内置终端：设置 → 搜索 Terminal › Integrated: Font Family → 填入 MesloLGM Nerd Font 或 FiraCode Nerd Font。

  3. 重新打开一个终端标签页，图标即可正常显示。

四、可选：更换 Oh My Posh 主题

编辑 $PROFILE，将 --config "jandedobbeleer" 中的主题名改为其他内置主题，例如：

主题名 风格说明
jandedobbeleer 经典默认
atomic 简洁
powerlevel10k_rainbow 彩色
star 星形风格
slimfat 紧凑

保存后执行 . $PROFILE 或新开终端即可生效。

五、流程小结

步骤 操作
1 用 winget 或安装脚本安装 Oh My Posh
2 创建/编辑 $PROFILE，写入 oh-my-posh init pwsh --config "jandedobbeleer" | Invoke-Expression 和 Import-Module Terminal-Icons
3 安装 Terminal-Icons：Install-Module -Name Terminal-Icons -Repository PSGallery -Scope CurrentUser
4 安装 Nerd Font：oh-my-posh font install Meslo（或 FiraCode 等）
5 在 Windows Terminal / Cursor 中把终端字体设为刚装的 Nerd Font
6 新开终端，完成

六、常见问题

  • 执行策略报错：以管理员身份打开 PowerShell，执行
    Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
  • 图标仍是方框：确认终端使用的字体名称里包含 “Nerd Font”，且已重启终端。
  • 不想用 Terminal-Icons：在 $PROFILE 里注释或删除 Import-Module -Name Terminal-Icons 即可。

文档版本：基于 Oh My Posh v29、Windows PowerShell 整理。

posted @ 2026-01-30 15:32  丘狸尾  阅读(19)  评论(0)    收藏  举报