PowerShell美化

20250701212448

前言

不知道从什么时候开始的呢？不满一点点的累积下来，终于有一天，觉得pwsh实在是太丑！于是决定花一点时间来美化，优化一下体验。

这篇blog中会使用scoop这里默认大家已经安装，有需要的话可以看一下教程-Scoop 超好用的Windows包管理器

优化用到的Tools如下：

美化：oh-my-posh, Nerd Font, PSReadLine, catppuccin
功能性：coreutils(rm), lsd and eza

美化

1
$PROFILE

通过这个command获取配置文件的路径，然后对配置文件进行修改，这里可能遇到由管理员权限也无法写入的问题，我本人是将文件复制出来，修改，再覆盖的做法。理论上只需要执行一次，后续就可以直接修改。

安装包

1
2
3
4
5
6
7
8
9
10
11
12
13
14
scoop install oh-my-posh 
scoop install nuget #可能用不到

Install-Module PSReadLine -Force -SkipPublisherCheck

# 下方这个包需要先手动下载，见后续教程
Import-Module Catppuccin

# 下方命令可能无法成功执行，可以手动安装，本人是选择不使用这个包
Install-Module -Name Terminal-Icons -Repository PSGallery
Import-Module Terminal-Icons

# 升级 PowerShellGet 模块，不必要，可能有助于解决一些问题
Install-Module PowerShellGet -Force -Scope CurrentUser

好的，命令列表给出来之后，就是讲解各个包了

oh-my-posh

最基础的包，直接上配置文件吧

1
oh-my-posh init pwsh --config "C:\Scoop\apps\oh-my-posh\26.5.0\themes\peru.omp.json" | Invoke-Expression

Invoke-Expression: 执行设置
peru.omp.json: 主题名称, themes文件夹下oh-my-posh自带有很多主题，可以自行选择喜欢的

Nerd Font

配置好oh-my-posh大家会发现很坏的事情，图标什么的根本渲染不出来，所以就需要好好的配置字体啦。
Nerd Font Project是个好平台，本人选用的是CaskaydiaCove Nerd Font Mono, 大家搜素CaskaydiaCove就好，Mono是文件夹内自带的系列，Mono是等宽的意思，适合code环境使用，还有非等宽的Propo，也许适合写文章

Nerd Font Project : https://www.nerdfonts.com/font-downloads

Catppuccin

PowerShell官方的配色是接受不了一点的，不好看，而且经常因为背景图片容易看不见，这肯定是你们配色调制的不好，怎么可能是吾辈的问题，所以需要Catppuccin的大驾光临

  1. Clone this repository locally.
  2. Place the contents of the repository in a folder named Catppuccin in a folder on your PowerShell Module Path. You can find your current PowerShell Module Path by running $env:PSModulePath in PowerShell.
  3. Import the module by running Import-Module Catppuccin in PowerShell. You can also add this to your PowerShell profile to automatically import the module when you start PowerShell. This may be useful if you want to use Catppuccin in your prompt.
  4. Start using the module! Help is available by running Get-Help Catppuccin.

上面贴出了官方README文件，简单来说，通过$env:PSModulePath命令获取Modules文件夹的可能位置，选择一个喜欢的（路径可能还未创建，那你就自行建立文件夹，包括ps配置文件也可能没有创建要自己建立）

然后clone代码库，将文件夹命名为Catppuccin, 随后执行:

1
Import-Module Catppuccin

再之后就是编写powershell配置文件了，因为很长，所以在文章末尾贴出。

这里说一下吾辈选择的配色方案吧，就是Official README里面的Mocha啦

VSCODE字体调整

美化终端之后，VSCODE是一定要调整字体的，不然图标会出问题的嘛，在json文件添加下面两行就好

1
2
"editor.fontFamily": "'CaskaydiaCove Nerd Font Mono', 'Cascadia Code', Consolas, monospace",
"editor.fontLigatures": true

fontFamily选择字体，逗号分隔，VS Code 会从左到右顺序寻找字体，让配置文件具有通用性
fontLigatures 用于字体美化

功能

安装包

1
2
3
4
5
# ls replacement
scoop install lsd
scoop install eza
# GNU Core Utilities
scoop install coreutils

lsd and eza

正是因为使用lsd and eza替代了pwsh自带的ls，所以才可以放弃Terminal-Icons, 不过根据Catppuccin的经验，配置一下也绝非难事

总之，lsd 和 eza 都是绝佳的 ls 工具，提供了不同方面的功能，具体配置详见末尾配置文件

这里介绍一下别名机制，function ls 会定义 ls 函数，不会触发错误，但是如果不事先移除默认内建别名，是不会起作用的，这里在AI的帮助下建立了使用lsd和eza的个人认为的合适时机

简单说一下，lsd上手容易，0配置，自带图标，很方便。eza更极简，主流？功能某方面也丰富一些

rm

吾辈还引入了coreutils工具集，主要就是rm库了，这里不推荐覆盖原本的rm指令，因为这样的功能性指令会被大量的，遵循pwsh规范的使用，会引发很多问题，五倍是通过Set-Alias nrm rm.exe定义了一个新命令

配置文件

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
Invoke-Expression (&scoop-search --hook)

$env:HTTP_PROXY = "http://127.0.0.1:7897"
$env:HTTPS_PROXY = "http://127.0.0.1:7897"
[System.Net.WebRequest]::DefaultWebProxy = New-Object System.Net.WebProxy("http://127.0.0.1:7897")
[System.Net.WebRequest]::DefaultWebProxy.Credentials = [System.Net.CredentialCache]::DefaultNetworkCredentials

Set-Alias nrm rm.exe

# --- Catppuccin for PowerShell 配置开始 ---

# 1. 导入 Catppuccin 模块
# 确保你已经按照说明正确安装了模块
Import-Module Catppuccin

# 2. 选择你喜欢的主题 (Flavor)
# Catppuccin 有四种主题: Latte, Frappe, Macchiato, Mocha
# 你可以把 'Mocha' 换成你喜欢的任何一个
$Flavor = $Catppuccin['Mocha']

# --- 以下是可选配置，你可以根据需要选择启用 ---

# 3. 配置 PSReadLine 的语法高亮颜色
# 这会让你的命令行输入变得五彩斑斓，强烈推荐！
$PSReadLineColors = @{
    # 命令，比如 Get-ChildItem
    Command          = $Flavor.Blue.Foreground()
    # 参数，比如 -Path
    Parameter        = $Flavor.Pink.Foreground()
    # 字符串，比如 "hello world"
    String           = $Flavor.Green.Foreground()
    # 操作符，比如 -eq, |
    Operator         = $Flavor.Sky.Foreground()
    # 类型，比如 [string]
    Type             = $Flavor.Yellow.Foreground()
    # 数字，比如 123
    Number           = $Flavor.Peach.Foreground()
    # 变量，比如 $myVariable
    Variable         = $Flavor.Lavender.Foreground()
    # 注释，比如 # 这是一个注释
    Comment          = $Flavor.Overlay0.Foreground()
    # 关键字，比如 function, if, else
    Keyword          = $Flavor.Mauve.Foreground()
    # 成员，比如 .Length
    Member           = $Flavor.Rosewater.Foreground()
    # 错误文本
    Error            = $Flavor.Red.Foreground()
    # 默认文本颜色
    Default          = $Flavor.Text.Foreground()
    # 行内预测文本颜色
    InlinePrediction = $Flavor.Overlay0.Foreground()
    # 选中时的背景色
    Selection        = $Flavor.Surface0.Background()
}
Set-PSReadLineOption -Colors $PSReadLineColors

# 4. 自定义你的命令提示符 (Prompt)
# 这会改变 "PS C:\>" 的样式
function prompt {
    # 如果在调试模式，显示红色的 [DBG]:
    $dbg = $(if (Test-Path variable:/PSDebugContext) { "$($Flavor.Red.Foreground())[DBG]: " } else { '' })
    
    # 主要提示符部分: "PS C:\"
    $mainPrompt = "$($Flavor.Teal.Foreground())PS $($Flavor.Yellow.Foreground())$(Get-Location)"
    
    # 结束符 "> "
    $endPrompt = "$($Flavor.Green.Foreground())> "
    
    # 组合起来并重置颜色
    # 注意: $PSStyle.Reset 需要 PowerShell 7.2+
    # 如果你的版本低于 7.2, 请用 "`e[0m" 替换 $PSStyle.Reset
    "$($dbg)$($mainPrompt)$($endPrompt)$($PSStyle.Reset)"
}

# 5. 配置 PowerShell 的内置格式化颜色 (如错误、警告信息)
# 注意: 这也需要 PowerShell 7.2+
$PSStyle.Formatting.FormatAccent = $Flavor.Teal.Foreground()
$PSStyle.Formatting.TableHeader = $Flavor.Rosewater.Foreground()
$PSStyle.Formatting.Error = $Flavor.Red.Foreground()
$PSStyle.Formatting.ErrorAccent = $Flavor.Blue.Foreground()
$PSStyle.Formatting.Warning = $Flavor.Peach.Foreground()
$PSStyle.Formatting.Verbose = $Flavor.Yellow.Foreground()
$PSStyle.Formatting.Debug = $Flavor.Sky.Foreground()

# --- Catppuccin for PowerShell 配置结束 ---

# 你可以在这下面添加其他你自己的 PowerShell 配置
# Clear-Host # 例如，每次启动时清屏
Write-Host "$($Flavor.Mauve.Foreground())Catppuccin theme loaded! Welcome back.$($PSStyle.Reset)"

oh-my-posh init pwsh --config "C:\Scoop\apps\oh-my-posh\26.5.0\themes\peru.omp.json" | Invoke-Expression

# 移除默认内建别名
if (Test-Path Alias:ls) {
    Remove-Item Alias:ls -Force
}
function ls {
    if (Test-Path .git) {
        eza --git --icons @args
    }
    else {
        lsd @args
    }
}