docs: add PowerShell terminal enhancement guide with PSFzf and Starship
补充完整的PowerShell终端增强配置教程，包括PSFzf安装配置、分版本的PS7+/5.1终端配置、Starship Catppuccin主题配置、快捷键速查和常见问题解答
This commit is contained in:
parent
c8369483b3
commit
a12e1365d6
@ -121,6 +121,730 @@ PowerShellGet\Install-Module posh-git -Scope CurrentUser -Force
|
|||||||
Install-Module PSReadLine -Force
|
Install-Module PSReadLine -Force
|
||||||
```
|
```
|
||||||
|
|
||||||
|
### [PSFzf](https://github.com/kelleymaureen/PSFzf)
|
||||||
|
|
||||||
|
> [PSFzf](https://github.com/kelleymaureen/PSFzf) 是 fzf 的 PowerShell 集成模块，提供模糊搜索历史命令和文件功能。
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
# 安装 PSFzf 模块
|
||||||
|
Install-Module PSFzf -Scope CurrentUser -Force
|
||||||
|
|
||||||
|
# 安装 fzf 本体（PSFzf 的底层依赖）
|
||||||
|
winget install junegunn.fzf
|
||||||
|
```
|
||||||
|
|
||||||
|
## 终端增强配置（Starship + PSReadLine）
|
||||||
|
|
||||||
|
> 参考：[PowerShell 终端增强配置指南](https://mp.weixin.qq.com/s/DV-T4Tr4KaonFdgutuzhQQ)
|
||||||
|
|
||||||
|
### 前置准备
|
||||||
|
|
||||||
|
#### 确认 PowerShell 版本
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
$PSVersionTable.PSVersion
|
||||||
|
```
|
||||||
|
|
||||||
|
- 主版本号为 `5` → 使用 **PS5.1 方案**
|
||||||
|
- 主版本号为 `7` → 使用 **PS7+ 方案**
|
||||||
|
|
||||||
|
#### 确认 Profile 文件路径
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
# 查看路径
|
||||||
|
echo $PROFILE
|
||||||
|
|
||||||
|
# 若文件不存在则创建
|
||||||
|
if (!(Test-Path $PROFILE)) {
|
||||||
|
New-Item -ItemType File -Path $PROFILE -Force
|
||||||
|
}
|
||||||
|
|
||||||
|
# 用 VSCode 打开编辑
|
||||||
|
code $PROFILE
|
||||||
|
```
|
||||||
|
|
||||||
|
> PS5.1 的 Profile 路径通常为：`C:\Users\<用户名>\Documents\WindowsPowerShell\Microsoft.PowerShell_profile.ps1`
|
||||||
|
>
|
||||||
|
> PS7+ 的 Profile 路径通常为：`C:\Users\<用户名>\Documents\PowerShell\Microsoft.PowerShell_profile.ps1`
|
||||||
|
>
|
||||||
|
> 两个版本的 Profile **互相独立**，需分别配置。
|
||||||
|
|
||||||
|
#### 设置执行策略（如遇权限报错）
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
|
||||||
|
```
|
||||||
|
|
||||||
|
### 一次性安装依赖
|
||||||
|
|
||||||
|
#### PowerShell 7+ 安装依赖
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
# 1. 信任 PSGallery
|
||||||
|
Set-PSRepository -Name PSGallery -InstallationPolicy Trusted
|
||||||
|
|
||||||
|
# 2. 安装最新版 PSReadLine
|
||||||
|
Install-Module PSReadLine -Force -Scope CurrentUser
|
||||||
|
|
||||||
|
# 3. 安装 posh-git
|
||||||
|
Install-Module posh-git -Scope CurrentUser -Force
|
||||||
|
|
||||||
|
# 4. 安装 PSFzf
|
||||||
|
Install-Module PSFzf -Scope CurrentUser -Force
|
||||||
|
|
||||||
|
# 5. 安装 fzf 本体
|
||||||
|
winget install junegunn.fzf
|
||||||
|
```
|
||||||
|
|
||||||
|
#### PowerShell 5.1 安装依赖
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
# 1. 信任 PSGallery
|
||||||
|
Set-PSRepository -Name PSGallery -InstallationPolicy Trusted
|
||||||
|
|
||||||
|
# 2. 安装 PSReadLine（PS5.1 最高兼容 2.3.x，必须指定版本）
|
||||||
|
Install-Module PSReadLine -RequiredVersion 2.3.4 -Force -Scope CurrentUser -SkipPublisherCheck
|
||||||
|
|
||||||
|
# 3. 安装 posh-git
|
||||||
|
Install-Module posh-git -Scope CurrentUser -Force
|
||||||
|
|
||||||
|
# 4. 安装 PSFzf
|
||||||
|
Install-Module PSFzf -Scope CurrentUser -Force
|
||||||
|
|
||||||
|
# 5. 安装 fzf 本体
|
||||||
|
winget install junegunn.fzf
|
||||||
|
```
|
||||||
|
|
||||||
|
### Starship 配置
|
||||||
|
|
||||||
|
Starship 是跨平台的提示符工具，支持 Windows、Linux、macOS。
|
||||||
|
|
||||||
|
#### 安装 Starship
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
winget install --id Starship.Starship
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 配置文件位置
|
||||||
|
|
||||||
|
Windows 下配置文件路径：`~/.config/starship.toml`
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
# 创建配置目录和文件
|
||||||
|
mkdir -p ~/.config
|
||||||
|
New-Item -Path ~/.config/starship.toml -ItemType File -Force
|
||||||
|
|
||||||
|
# 用 VSCode 打开编辑
|
||||||
|
code ~/.config/starship.toml
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 完整配置（Catppuccin Mocha 主题）
|
||||||
|
|
||||||
|
将以下内容粘贴到 `starship.toml` 文件中：
|
||||||
|
|
||||||
|
```toml
|
||||||
|
"$schema" = 'https://starship.rs/config-schema.json'
|
||||||
|
|
||||||
|
format = """
|
||||||
|
[](red)\
|
||||||
|
$os\
|
||||||
|
$username\
|
||||||
|
[](bg:peach fg:red)\
|
||||||
|
$directory\
|
||||||
|
[](bg:yellow fg:peach)\
|
||||||
|
$git_branch\
|
||||||
|
$git_status\
|
||||||
|
[](fg:yellow bg:green)\
|
||||||
|
$c\
|
||||||
|
$rust\
|
||||||
|
$golang\
|
||||||
|
$nodejs\
|
||||||
|
$bun\
|
||||||
|
$php\
|
||||||
|
$java\
|
||||||
|
$kotlin\
|
||||||
|
$haskell\
|
||||||
|
$python\
|
||||||
|
[](fg:green bg:sapphire)\
|
||||||
|
$conda\
|
||||||
|
[](fg:sapphire bg:lavender)\
|
||||||
|
$time\
|
||||||
|
[ ](fg:lavender)\
|
||||||
|
$cmd_duration\
|
||||||
|
$line_break\
|
||||||
|
$character"""
|
||||||
|
|
||||||
|
palette = 'catppuccin_mocha'
|
||||||
|
|
||||||
|
[os]
|
||||||
|
disabled = false
|
||||||
|
style = "bg:red fg:crust"
|
||||||
|
|
||||||
|
[os.symbols]
|
||||||
|
Windows = ""
|
||||||
|
Ubuntu = ""
|
||||||
|
SUSE = ""
|
||||||
|
Raspbian = ""
|
||||||
|
Mint = ""
|
||||||
|
Macos = ""
|
||||||
|
Manjaro = ""
|
||||||
|
Linux = ""
|
||||||
|
Gentoo = ""
|
||||||
|
Fedora = ""
|
||||||
|
Alpine = ""
|
||||||
|
Amazon = ""
|
||||||
|
Android = ""
|
||||||
|
AOSC = ""
|
||||||
|
Arch = ""
|
||||||
|
Artix = ""
|
||||||
|
CentOS = ""
|
||||||
|
Debian = ""
|
||||||
|
Redhat = ""
|
||||||
|
RedHatEnterprise = ""
|
||||||
|
|
||||||
|
[username]
|
||||||
|
show_always = true
|
||||||
|
style_user = "bg:red fg:crust"
|
||||||
|
style_root = "bg:red fg:crust"
|
||||||
|
format = '[ $user]($style)'
|
||||||
|
|
||||||
|
[directory]
|
||||||
|
style = "bg:peach fg:crust"
|
||||||
|
format = "[ $path ]($style)"
|
||||||
|
truncation_length = 3
|
||||||
|
truncation_symbol = "…/"
|
||||||
|
|
||||||
|
[directory.substitutions]
|
||||||
|
"Documents" = " "
|
||||||
|
"Downloads" = " "
|
||||||
|
"Music" = " "
|
||||||
|
"Pictures" = " "
|
||||||
|
"Developer" = " "
|
||||||
|
|
||||||
|
[git_branch]
|
||||||
|
symbol = ""
|
||||||
|
style = "bg:yellow"
|
||||||
|
format = '[[ $symbol $branch ](fg:crust bg:yellow)]($style)'
|
||||||
|
|
||||||
|
[git_status]
|
||||||
|
style = "bg:yellow"
|
||||||
|
format = '[[($all_status$ahead_behind )](fg:crust bg:yellow)]($style)'
|
||||||
|
|
||||||
|
[nodejs]
|
||||||
|
symbol = ""
|
||||||
|
style = "bg:green"
|
||||||
|
format = '[[ $symbol( $version) ](fg:crust bg:green)]($style)'
|
||||||
|
|
||||||
|
[bun]
|
||||||
|
symbol = ""
|
||||||
|
style = "bg:green"
|
||||||
|
format = '[[ $symbol( $version) ](fg:crust bg:green)]($style)'
|
||||||
|
|
||||||
|
[c]
|
||||||
|
symbol = " "
|
||||||
|
style = "bg:green"
|
||||||
|
format = '[[ $symbol( $version) ](fg:crust bg:green)]($style)'
|
||||||
|
|
||||||
|
[rust]
|
||||||
|
symbol = ""
|
||||||
|
style = "bg:green"
|
||||||
|
format = '[[ $symbol( $version) ](fg:crust bg:green)]($style)'
|
||||||
|
|
||||||
|
[golang]
|
||||||
|
symbol = ""
|
||||||
|
style = "bg:green"
|
||||||
|
format = '[[ $symbol( $version) ](fg:crust bg:green)]($style)'
|
||||||
|
|
||||||
|
[php]
|
||||||
|
symbol = ""
|
||||||
|
style = "bg:green"
|
||||||
|
format = '[[ $symbol( $version) ](fg:crust bg:green)]($style)'
|
||||||
|
|
||||||
|
[java]
|
||||||
|
symbol = " "
|
||||||
|
style = "bg:green"
|
||||||
|
format = '[[ $symbol( $version) ](fg:crust bg:green)]($style)'
|
||||||
|
|
||||||
|
[kotlin]
|
||||||
|
symbol = ""
|
||||||
|
style = "bg:green"
|
||||||
|
format = '[[ $symbol( $version) ](fg:crust bg:green)]($style)'
|
||||||
|
|
||||||
|
[haskell]
|
||||||
|
symbol = ""
|
||||||
|
style = "bg:green"
|
||||||
|
format = '[[ $symbol( $version) ](fg:crust bg:green)]($style)'
|
||||||
|
|
||||||
|
[python]
|
||||||
|
symbol = ""
|
||||||
|
style = "bg:green"
|
||||||
|
format = '[[ $symbol( $version)(\(#$virtualenv\)) ](fg:crust bg:green)]($style)'
|
||||||
|
|
||||||
|
[docker_context]
|
||||||
|
symbol = ""
|
||||||
|
style = "bg:sapphire"
|
||||||
|
format = '[[ $symbol( $context) ](fg:crust bg:sapphire)]($style)'
|
||||||
|
|
||||||
|
[conda]
|
||||||
|
symbol = " "
|
||||||
|
style = "fg:crust bg:sapphire"
|
||||||
|
format = '[$symbol$environment ]($style)'
|
||||||
|
ignore_base = false
|
||||||
|
|
||||||
|
[time]
|
||||||
|
disabled = false
|
||||||
|
time_format = "%R"
|
||||||
|
style = "bg:lavender"
|
||||||
|
format = '[[ $time ](fg:crust bg:lavender)]($style)'
|
||||||
|
|
||||||
|
[line_break]
|
||||||
|
disabled = false
|
||||||
|
|
||||||
|
[character]
|
||||||
|
disabled = false
|
||||||
|
success_symbol = '[❯](bold fg:green)'
|
||||||
|
error_symbol = '[❯](bold fg:red)'
|
||||||
|
vimcmd_symbol = '[❮](bold fg:green)'
|
||||||
|
vimcmd_replace_one_symbol = '[❮](bold fg:lavender)'
|
||||||
|
vimcmd_replace_symbol = '[❮](bold fg:lavender)'
|
||||||
|
vimcmd_visual_symbol = '[❮](bold fg:yellow)'
|
||||||
|
|
||||||
|
[cmd_duration]
|
||||||
|
show_milliseconds = true
|
||||||
|
format = " in $duration "
|
||||||
|
style = "bg:lavender"
|
||||||
|
disabled = false
|
||||||
|
show_notifications = true
|
||||||
|
min_time_to_notify = 45000
|
||||||
|
|
||||||
|
[palettes.catppuccin_mocha]
|
||||||
|
rosewater = "#f5e0dc"
|
||||||
|
flamingo = "#f2cdcd"
|
||||||
|
pink = "#f5c2e7"
|
||||||
|
mauve = "#cba6f7"
|
||||||
|
red = "#f38ba8"
|
||||||
|
maroon = "#eba0ac"
|
||||||
|
peach = "#fab387"
|
||||||
|
yellow = "#f9e2af"
|
||||||
|
green = "#a6e3a1"
|
||||||
|
teal = "#94e2d5"
|
||||||
|
sky = "#89dceb"
|
||||||
|
sapphire = "#74c7ec"
|
||||||
|
blue = "#89b4fa"
|
||||||
|
lavender = "#b4befe"
|
||||||
|
text = "#cdd6f4"
|
||||||
|
subtext1 = "#bac2de"
|
||||||
|
subtext0 = "#a6adc8"
|
||||||
|
overlay2 = "#9399b2"
|
||||||
|
overlay1 = "#7f849c"
|
||||||
|
overlay0 = "#6c7086"
|
||||||
|
surface2 = "#585b70"
|
||||||
|
surface1 = "#45475a"
|
||||||
|
surface0 = "#313244"
|
||||||
|
base = "#1e1e2e"
|
||||||
|
mantle = "#181825"
|
||||||
|
crust = "#11111b"
|
||||||
|
|
||||||
|
[palettes.catppuccin_frappe]
|
||||||
|
rosewater = "#f2d5cf"
|
||||||
|
flamingo = "#eebebe"
|
||||||
|
pink = "#f4b8e4"
|
||||||
|
mauve = "#ca9ee6"
|
||||||
|
red = "#e78284"
|
||||||
|
maroon = "#ea999c"
|
||||||
|
peach = "#ef9f76"
|
||||||
|
yellow = "#e5c890"
|
||||||
|
green = "#a6d189"
|
||||||
|
teal = "#81c8be"
|
||||||
|
sky = "#99d1db"
|
||||||
|
sapphire = "#85c1dc"
|
||||||
|
blue = "#8caaee"
|
||||||
|
lavender = "#babbf1"
|
||||||
|
text = "#c6d0f5"
|
||||||
|
subtext1 = "#b5bfe2"
|
||||||
|
subtext0 = "#a5adce"
|
||||||
|
overlay2 = "#949cbb"
|
||||||
|
overlay1 = "#838ba7"
|
||||||
|
overlay0 = "#737994"
|
||||||
|
surface2 = "#626880"
|
||||||
|
surface1 = "#51576d"
|
||||||
|
surface0 = "#414559"
|
||||||
|
base = "#303446"
|
||||||
|
mantle = "#292c3c"
|
||||||
|
crust = "#232634"
|
||||||
|
|
||||||
|
[palettes.catppuccin_latte]
|
||||||
|
rosewater = "#dc8a78"
|
||||||
|
flamingo = "#dd7878"
|
||||||
|
pink = "#ea76cb"
|
||||||
|
mauve = "#8839ef"
|
||||||
|
red = "#d20f39"
|
||||||
|
maroon = "#e64553"
|
||||||
|
peach = "#fe640b"
|
||||||
|
yellow = "#df8e1d"
|
||||||
|
green = "#40a02b"
|
||||||
|
teal = "#179299"
|
||||||
|
sky = "#04a5e5"
|
||||||
|
sapphire = "#209fb5"
|
||||||
|
blue = "#1e66f5"
|
||||||
|
lavender = "#7287fd"
|
||||||
|
text = "#4c4f69"
|
||||||
|
subtext1 = "#5c5f77"
|
||||||
|
subtext0 = "#6c6f85"
|
||||||
|
overlay2 = "#7c7f93"
|
||||||
|
overlay1 = "#8c8fa1"
|
||||||
|
overlay0 = "#9ca0b0"
|
||||||
|
surface2 = "#acb0be"
|
||||||
|
surface1 = "#bcc0cc"
|
||||||
|
surface0 = "#ccd0da"
|
||||||
|
base = "#eff1f5"
|
||||||
|
mantle = "#e6e9ef"
|
||||||
|
crust = "#dce0e8"
|
||||||
|
|
||||||
|
[palettes.catppuccin_macchiato]
|
||||||
|
rosewater = "#f4dbd6"
|
||||||
|
flamingo = "#f0c6c6"
|
||||||
|
pink = "#f5bde6"
|
||||||
|
mauve = "#c6a0f6"
|
||||||
|
red = "#ed8796"
|
||||||
|
maroon = "#ee99a0"
|
||||||
|
peach = "#f5a97f"
|
||||||
|
yellow = "#eed49f"
|
||||||
|
green = "#a6da95"
|
||||||
|
teal = "#8bd5ca"
|
||||||
|
sky = "#91d7e3"
|
||||||
|
sapphire = "#7dc4e4"
|
||||||
|
blue = "#8aadf4"
|
||||||
|
lavender = "#b7bdf8"
|
||||||
|
text = "#cad3f5"
|
||||||
|
subtext1 = "#b8c0e0"
|
||||||
|
subtext0 = "#a5adcb"
|
||||||
|
overlay2 = "#9399b7"
|
||||||
|
overlay1 = "#8087a2"
|
||||||
|
overlay0 = "#6e738d"
|
||||||
|
surface2 = "#5b6078"
|
||||||
|
surface1 = "#494d64"
|
||||||
|
surface0 = "#363a4f"
|
||||||
|
base = "#24273a"
|
||||||
|
mantle = "#1e2030"
|
||||||
|
crust = "#181926"
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 切换主题
|
||||||
|
|
||||||
|
修改 `palette` 字段即可切换主题：
|
||||||
|
|
||||||
|
```toml
|
||||||
|
# 可选值：catppuccin_mocha（默认）、catppuccin_frappe、catppuccin_latte、catppuccin_macchiato
|
||||||
|
palette = 'catppuccin_mocha'
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 验证配置
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
# 检查 Starship 版本
|
||||||
|
starship --version
|
||||||
|
|
||||||
|
# 测试配置是否正确
|
||||||
|
starship config
|
||||||
|
```
|
||||||
|
|
||||||
|
### 完整 Profile 配置
|
||||||
|
|
||||||
|
#### PowerShell 7+ Profile
|
||||||
|
|
||||||
|
将以下内容完整粘贴到 `$PROFILE` 文件中：
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
# ════════════════════════════════════════════════════════════
|
||||||
|
# PowerShell 7+ Profile
|
||||||
|
# 功能：动态窗口标题 + 智能自动补全 + Starship 集成
|
||||||
|
# ════════════════════════════════════════════════════════════
|
||||||
|
|
||||||
|
# ── 模块导入 ─────────────────────────────────────────────────
|
||||||
|
Import-Module PSReadLine
|
||||||
|
Import-Module posh-git -ErrorAction SilentlyContinue
|
||||||
|
Import-Module PSFzf -ErrorAction SilentlyContinue
|
||||||
|
|
||||||
|
# ── PSReadLine 配置 ──────────────────────────────────────────
|
||||||
|
# PS7+ 支持 HistoryAndPlugin（结合历史和插件两种来源预测）
|
||||||
|
Set-PSReadLineOption -PredictionSource HistoryAndPlugin
|
||||||
|
|
||||||
|
# PS7+ 支持 ListView（下拉候选列表，比 InlineView 更直观）
|
||||||
|
Set-PSReadLineOption -PredictionViewStyle ListView
|
||||||
|
|
||||||
|
Set-PSReadLineOption -HistorySearchCursorMovesToEnd
|
||||||
|
Set-PSReadLineOption -MaximumHistoryCount 10000
|
||||||
|
|
||||||
|
Set-PSReadLineOption -Colors @{
|
||||||
|
Command = 'Cyan'
|
||||||
|
Parameter = 'DarkCyan'
|
||||||
|
String = 'Yellow'
|
||||||
|
Operator = 'Magenta'
|
||||||
|
Variable = 'Green'
|
||||||
|
Comment = 'DarkGray'
|
||||||
|
InlinePrediction = 'DarkGray'
|
||||||
|
ListPrediction = 'DarkCyan'
|
||||||
|
}
|
||||||
|
|
||||||
|
# ── 快捷键绑定 ───────────────────────────────────────────────
|
||||||
|
Set-PSReadLineKeyHandler -Key Tab -Function MenuComplete
|
||||||
|
Set-PSReadLineKeyHandler -Key Shift+Tab -Function MenuComplete
|
||||||
|
Set-PSReadLineKeyHandler -Key Ctrl+Spacebar -Function PossibleCompletions
|
||||||
|
Set-PSReadLineKeyHandler -Key UpArrow -Function HistorySearchBackward
|
||||||
|
Set-PSReadLineKeyHandler -Key DownArrow -Function HistorySearchForward
|
||||||
|
Set-PSReadLineKeyHandler -Key Ctrl+r -Function ReverseSearchHistory
|
||||||
|
# F2 可在 InlineView 和 ListView 之间实时切换（PS7+ 专属）
|
||||||
|
Set-PSReadLineKeyHandler -Key F2 -Function SwitchPredictionView
|
||||||
|
|
||||||
|
# ── PSFzf 配置 ───────────────────────────────────────────────
|
||||||
|
if (Get-Module PSFzf -ErrorAction SilentlyContinue) {
|
||||||
|
Set-PSFzfOption -PSReadLineChordProvider 'Ctrl+t'
|
||||||
|
Set-PSFzfOption -PSReadLineChordReverseHistory 'Ctrl+r'
|
||||||
|
}
|
||||||
|
|
||||||
|
# ── WinGet 补全 ──────────────────────────────────────────────
|
||||||
|
if (Get-Command winget -ErrorAction SilentlyContinue) {
|
||||||
|
Register-ArgumentCompleter -Native -CommandName winget -ScriptBlock {
|
||||||
|
param($wordToComplete, $commandAst, $cursorPosition)
|
||||||
|
# PS7+ 推荐显式设置编码，避免中文路径乱码
|
||||||
|
[Console]::InputEncoding = [System.Text.Utf8Encoding]::new()
|
||||||
|
[Console]::OutputEncoding = [System.Text.Utf8Encoding]::new()
|
||||||
|
$word = $wordToComplete.Replace('"', '""')
|
||||||
|
$ast = $commandAst.ToString().Replace('"', '""')
|
||||||
|
winget complete --word="$word" --commandline "$ast" --position $cursorPosition |
|
||||||
|
ForEach-Object {
|
||||||
|
[System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
# ── 动态窗口标题（Starship 钩子）────────────────────────────
|
||||||
|
# Starship 会在每次渲染 Prompt 前自动调用此函数
|
||||||
|
function Invoke-Starship-PreCommand {
|
||||||
|
$dirName = Split-Path -Leaf $PWD.Path
|
||||||
|
$branch = ""
|
||||||
|
if (Test-Path ".git" -PathType Container) {
|
||||||
|
try {
|
||||||
|
$b = git branch --show-current 2>$null
|
||||||
|
if ($b) { $branch = " [$b]" }
|
||||||
|
} catch {}
|
||||||
|
}
|
||||||
|
$isAdmin = ([Security.Principal.WindowsPrincipal] `
|
||||||
|
[Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole(
|
||||||
|
[Security.Principal.WindowsBuiltInRole]::Administrator)
|
||||||
|
$adminTag = if ($isAdmin) { " ⚡ADMIN" } else { "" }
|
||||||
|
$host.UI.RawUI.WindowTitle = "PS · $dirName$branch$adminTag"
|
||||||
|
}
|
||||||
|
|
||||||
|
# ── PowerToys CommandNotFound ────────────────────────────────
|
||||||
|
Import-Module -Name Microsoft.WinGet.CommandNotFound
|
||||||
|
#f45873b3-b655-43a6-b217-97c00aa0db58
|
||||||
|
|
||||||
|
# ── Starship 初始化（必须放最后）────────────────────────────
|
||||||
|
Invoke-Expression (&starship init powershell)
|
||||||
|
```
|
||||||
|
|
||||||
|
#### PowerShell 5.1 Profile
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
# ════════════════════════════════════════════════════════════
|
||||||
|
# PowerShell 5.1 Profile
|
||||||
|
# 功能：动态窗口标题 + 智能自动补全 + Starship 集成
|
||||||
|
# ════════════════════════════════════════════════════════════
|
||||||
|
|
||||||
|
# ── 模块导入 ─────────────────────────────────────────────────
|
||||||
|
Import-Module PSReadLine
|
||||||
|
Import-Module posh-git -ErrorAction SilentlyContinue
|
||||||
|
Import-Module PSFzf -ErrorAction SilentlyContinue
|
||||||
|
|
||||||
|
# ── PSReadLine 配置 ──────────────────────────────────────────
|
||||||
|
# PS5.1 仅支持 History，不支持 HistoryAndPlugin
|
||||||
|
Set-PSReadLineOption -PredictionSource History
|
||||||
|
|
||||||
|
# PS5.1 仅支持 InlineView，不支持 ListView
|
||||||
|
Set-PSReadLineOption -PredictionViewStyle InlineView
|
||||||
|
|
||||||
|
Set-PSReadLineOption -HistorySearchCursorMovesToEnd
|
||||||
|
Set-PSReadLineOption -MaximumHistoryCount 10000
|
||||||
|
|
||||||
|
Set-PSReadLineOption -Colors @{
|
||||||
|
Command = 'Cyan'
|
||||||
|
Parameter = 'DarkCyan'
|
||||||
|
String = 'Yellow'
|
||||||
|
Operator = 'Magenta'
|
||||||
|
Variable = 'Green'
|
||||||
|
Comment = 'DarkGray'
|
||||||
|
InlinePrediction = 'DarkGray'
|
||||||
|
}
|
||||||
|
|
||||||
|
# ── 快捷键绑定 ───────────────────────────────────────────────
|
||||||
|
Set-PSReadLineKeyHandler -Key Tab -Function MenuComplete
|
||||||
|
Set-PSReadLineKeyHandler -Key Shift+Tab -Function MenuComplete
|
||||||
|
Set-PSReadLineKeyHandler -Key Ctrl+Spacebar -Function PossibleCompletions
|
||||||
|
Set-PSReadLineKeyHandler -Key UpArrow -Function HistorySearchBackward
|
||||||
|
Set-PSReadLineKeyHandler -Key DownArrow -Function HistorySearchForward
|
||||||
|
Set-PSReadLineKeyHandler -Key Ctrl+r -Function ReverseSearchHistory
|
||||||
|
|
||||||
|
# ── PSFzf 配置 ───────────────────────────────────────────────
|
||||||
|
if (Get-Module PSFzf -ErrorAction SilentlyContinue) {
|
||||||
|
Set-PSFzfOption -PSReadLineChordProvider 'Ctrl+t'
|
||||||
|
Set-PSFzfOption -PSReadLineChordReverseHistory 'Ctrl+r'
|
||||||
|
}
|
||||||
|
|
||||||
|
# ── WinGet 补全 ──────────────────────────────────────────────
|
||||||
|
if (Get-Command winget -ErrorAction SilentlyContinue) {
|
||||||
|
Register-ArgumentCompleter -Native -CommandName winget -ScriptBlock {
|
||||||
|
param($wordToComplete, $commandAst, $cursorPosition)
|
||||||
|
$word = $wordToComplete.Replace('"', '""')
|
||||||
|
$ast = $commandAst.ToString().Replace('"', '""')
|
||||||
|
winget complete --word="$word" --commandline "$ast" --position $cursorPosition |
|
||||||
|
ForEach-Object {
|
||||||
|
[System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
# ── 动态窗口标题（Starship 钩子）────────────────────────────
|
||||||
|
function Invoke-Starship-PreCommand {
|
||||||
|
$dirName = Split-Path -Leaf $PWD.Path
|
||||||
|
$branch = ""
|
||||||
|
if (Test-Path ".git" -PathType Container) {
|
||||||
|
try {
|
||||||
|
$b = git branch --show-current 2>$null
|
||||||
|
if ($b) { $branch = " [$b]" }
|
||||||
|
} catch {}
|
||||||
|
}
|
||||||
|
$isAdmin = ([Security.Principal.WindowsPrincipal] `
|
||||||
|
[Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole(
|
||||||
|
[Security.Principal.WindowsBuiltInRole]::Administrator)
|
||||||
|
$adminTag = if ($isAdmin) { " ⚡ADMIN" } else { "" }
|
||||||
|
$host.UI.RawUI.WindowTitle = "PS · $dirName$branch$adminTag"
|
||||||
|
}
|
||||||
|
|
||||||
|
# ── Starship 初始化（必须放最后）────────────────────────────
|
||||||
|
Invoke-Expression (&starship init powershell)
|
||||||
|
```
|
||||||
|
|
||||||
|
### 功能说明
|
||||||
|
|
||||||
|
#### 动态窗口标题
|
||||||
|
|
||||||
|
标题由以下三部分拼接而成：
|
||||||
|
|
||||||
|
```
|
||||||
|
PS · <当前目录名> [<Git分支>] <管理员标识>
|
||||||
|
```
|
||||||
|
|
||||||
|
**示例效果：**
|
||||||
|
|
||||||
|
| 场景 | 窗口标题 |
|
||||||
|
|------|----------|
|
||||||
|
| 普通目录 | `PS · Downloads` |
|
||||||
|
| Git 仓库 | `PS · my-project [main]` |
|
||||||
|
| 管理员身份 | `PS · System32 ⚡ADMIN` |
|
||||||
|
| 管理员 + Git | `PS · infra [feat/deploy] ⚡ADMIN` |
|
||||||
|
|
||||||
|
**实现原理：** 利用 Starship 预留的 `Invoke-Starship-PreCommand` 钩子函数，在每次渲染 Prompt 之前执行，与 Starship 完全兼容，无冲突。
|
||||||
|
|
||||||
|
#### 自动补全配置
|
||||||
|
|
||||||
|
配置分为四个层次，可按需选择叠加：
|
||||||
|
|
||||||
|
| 层次 | 功能 | 说明 |
|
||||||
|
|------|------|------|
|
||||||
|
| Layer 1 | PSReadLine 历史预测 | 输入部分命令后，灰色文字实时预测完整命令，按 `→` 接受 |
|
||||||
|
| Layer 2 | Tab 菜单补全 | 按 `Tab` 弹出候选菜单，上下键选择，`Enter` 确认 |
|
||||||
|
| Layer 3 | posh-git 补全 | 为 `git` 命令提供子命令、分支名、远程名等补全 |
|
||||||
|
| Layer 4 | PSFzf 模糊搜索 | `Ctrl+R` 调出交互式历史命令搜索窗口，支持模糊匹配 |
|
||||||
|
|
||||||
|
### 快捷键速查
|
||||||
|
|
||||||
|
| 快捷键 | 功能 | PS5.1 | PS7+ |
|
||||||
|
|--------|------|-------|------|
|
||||||
|
| `→` | 接受行内预测 | ✅ | ✅ |
|
||||||
|
| `Tab` | 菜单补全，循环切换候选 | ✅ | ✅ |
|
||||||
|
| `Shift+Tab` | 反向切换候选 | ✅ | ✅ |
|
||||||
|
| `Ctrl+Space` | 显示所有候选项 | ✅ | ✅ |
|
||||||
|
| `↑ / ↓` | 按前缀过滤历史记录 | ✅ | ✅ |
|
||||||
|
| `Ctrl+R` | fzf 模糊历史搜索 | ✅ | ✅ |
|
||||||
|
| `Ctrl+T` | fzf 模糊文件查找 | ✅ | ✅ |
|
||||||
|
| `F2` | 切换 InlineView / ListView | ❌ | ✅ |
|
||||||
|
|
||||||
|
### 版本功能对照
|
||||||
|
|
||||||
|
| 功能 | PS5.1 | PS7+ | 说明 |
|
||||||
|
|------|-------|------|------|
|
||||||
|
| `PredictionSource History` | ✅ | ✅ | 基于历史命令预测 |
|
||||||
|
| `PredictionSource HistoryAndPlugin` | ❌ | ✅ | 额外加入插件预测源 |
|
||||||
|
| `PredictionViewStyle InlineView` | ✅ | ✅ | 行内灰字预测 |
|
||||||
|
| `PredictionViewStyle ListView` | ❌ | ✅ | 下拉候选列表 |
|
||||||
|
| `F2` 切换预测视图 | ❌ | ✅ | 实时切换两种视图 |
|
||||||
|
| PSReadLine 最高版本 | 2.3.x | 最新版 | 安装时需注意 |
|
||||||
|
| posh-git | ✅ | ✅ | 版本一致 |
|
||||||
|
| PSFzf | ✅ | ✅ | 版本一致 |
|
||||||
|
| WinGet 补全 | ✅ | ✅ | 编码处理略有差异 |
|
||||||
|
| Starship 钩子 | ✅ | ✅ | 函数名一致 |
|
||||||
|
| 动态窗口标题 | ✅ | ✅ | 实现方式一致 |
|
||||||
|
|
||||||
|
> PS5.1 缺少的 `ListView` 和 `HistoryAndPlugin` 可通过 PSFzf 的 `Ctrl+R` 模糊搜索弥补，日常体验差距不大。
|
||||||
|
|
||||||
|
### 常见问题
|
||||||
|
|
||||||
|
#### 执行 `. $PROFILE` 报执行策略错误
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 模块安装报 NuGet 错误
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
Install-PackageProvider -Name NuGet -MinimumVersion 2.8.5.201 -Force
|
||||||
|
```
|
||||||
|
|
||||||
|
#### PSReadLine 安装后不生效
|
||||||
|
|
||||||
|
PS5.1 系统自带一个旧版 PSReadLine，新版安装在用户目录下，需确认加载的是新版：
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
Get-Module PSReadLine | Select-Object Name, Version, Path
|
||||||
|
# Path 应包含 CurrentUser 路径，而非 System32
|
||||||
|
```
|
||||||
|
|
||||||
|
如果仍加载旧版，在 Profile 最顶部显式指定：
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
Remove-Module PSReadLine -ErrorAction SilentlyContinue
|
||||||
|
Import-Module PSReadLine -RequiredVersion 2.3.4
|
||||||
|
```
|
||||||
|
|
||||||
|
#### fzf / PSFzf 的 Ctrl+R 不弹出窗口
|
||||||
|
|
||||||
|
确认 fzf 本体已安装且在 PATH 中：
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
fzf --version
|
||||||
|
```
|
||||||
|
|
||||||
|
如果命令不存在，重新安装并重启终端：
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
winget install junegunn.fzf
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 窗口标题不更新
|
||||||
|
|
||||||
|
确认 `Invoke-Starship-PreCommand` 函数定义在 `Invoke-Expression (&starship init powershell)` **之前**，因为 Starship init 会注册对该钩子的调用，函数本身需要提前存在。
|
||||||
|
|
||||||
|
#### posh-git 导致启动变慢
|
||||||
|
|
||||||
|
posh-git 在大型仓库中可能扫描较慢，可设置跳过未跟踪文件统计：
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
$GitPromptSettings.EnableFileStatus = $false
|
||||||
|
```
|
||||||
|
|
||||||
## 编辑oh-my-posh配置文件
|
## 编辑oh-my-posh配置文件
|
||||||
|
|
||||||
打开**PowerShell**终端，执行以下命令编辑配置文件 `code $PROFILE`：
|
打开**PowerShell**终端，执行以下命令编辑配置文件 `code $PROFILE`：
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user