Windows PowerShell 终极美化与增强指南

本文档记录了如何将 Windows PowerShell 打造成一个类似 Oh My Zsh 的高效、美观的终端环境。

📦 1. 前置准备

确保已安装包管理器 Scoop（用于安装工具）和 PNPM（如果需要 Node 环境）。

# 检查 Scoop 是否安装
scoop --version

🛠️ 2. 核心工具安装

我们使用 Scoop 安装以下三大神器：

• Starship: 极速、可高度定制的终端提示符（Prompt）。
• Zoxide: 智能目录跳转工具（比 cd 更快）。
• Bat: 支持语法高亮的 cat 替代品。

scoop install starship zoxide bat

⌨️ 3. 智能补全与预测 (PSReadLine)

为了实现类似 zsh-autosuggestions 的灰色行内自动补全，我们需要升级 PSReadLine 到最新版。

# 安装最新稳定版
Install-Module PSReadLine -Force -SkipPublisherCheck -Scope CurrentUser

🎨 4. 解决图标乱码 (Nerd Fonts)

Starship 依赖 Nerd Fonts 来显示漂亮的图标（如 Git 分支、语言 Logo 等）。

1. 添加字体库并安装:

   scoop bucket add nerd-fonts
   scoop install Maple-Mono-NF-CN

2. 配置终端: 打开 Windows Terminal 设置 -> 外观 -> 字体，选择 Maple Mono NF CN。

⚙️ 5. 配置文件 ($PROFILE)

运行 code $PROFILE (如果已配置别名) 或 notepad $PROFILE，写入以下内容：

# ==============================
#  基本设置
# ==============================
$OutputEncoding = [console]::InputEncoding = [console]::OutputEncoding = New-Object System.Text.UTF8Encoding

# ==============================
#  常用别名 (Aliases)
# ==============================
Set-Alias p pnpm
Set-Alias dc docker-compose
Set-Alias which where.exe  # 模拟 Linux 'which'
Set-Alias code cursor      # 使用 'code' 打开 Cursor 编辑器

# 注意：PowerShell 内置了 'cat' 别名且无法覆盖，
# 请直接使用 'bat' 命令查看文件，或设置其他别名如 'b'。

# ==============================
#  PSReadLine 配置 (智能补全)
# ==============================
if ($host.Name -eq 'ConsoleHost' -or $host.Name -eq 'Visual Studio Code Host') {
    Import-Module PSReadLine
    # 启用历史记录预测
    Set-PSReadLineOption -PredictionSource History
    # 设置为行内视图 (灰色文字)
    Set-PSReadLineOption -PredictionViewStyle InlineView
    # 设置预测文字颜色
    Set-PSReadLineOption -Colors @{ "Prediction" = [ConsoleColor]::DarkGray }
    
    # 键位绑定：上下键搜索历史
    Set-PSReadLineKeyHandler -Key UpArrow -Function HistorySearchBackward
    Set-PSReadLineKeyHandler -Key DownArrow -Function HistorySearchForward
}

# ==============================
#  工具初始化
# ==============================

# 🚀 Starship Prompt
Invoke-Expression (&starship init powershell)

# 📂 Zoxide (智能跳转)
# 注意：PowerShell 5.1 需要添加 '--hook prompt'
Invoke-Expression (& { (zoxide init powershell --hook prompt | Out-String) })

💡 使用技巧

• 快速跳转: 经常访问目录 C:\Users\Name\Projects\web 后，只需输入 z web 即可瞬间跳转。
• 历史搜索: 输入 git 然后按 ↑ (上箭头)，只会翻阅以 git 开头的历史命令。
• 查看文件: 使用 bat README.md 替代 cat，享受语法高亮。
• 自动补全: 输入命令时看到灰色建议，按 → (右箭头) 即可采纳。

Created by Gemini CLI Assistant