适用于 Windows 10/11，PowerShell 7.0 及以上版本
为什么终端环境如此重要
作为 PowerShell 用户，终端是每天打交道最多的工具。一个配置得当的终端环境不仅能让你心情愉悦，更能显著提升工作效率。试想一下：当你打开终端，迎接你的是清晰的配色、醒目的 Git 状态提示、智能的命令补全，和一系列顺手可用的自定义函数——是不是比面对默认的蓝底白字更有动力？
传统的 Windows PowerShell 5.1 控制台（conhost）功能有限，不支持多标签、缺乏自定义能力。而 Windows Terminal 的出现彻底改变了这一局面：它是开源的、高度可定制的、支持 GPU 加速渲染的现代终端应用。配合 PowerShell 7 和 Oh My Posh，我们可以打造一个不输 macOS/Linux 的终端体验。
本文将从 Windows Terminal 配置、PowerShell 7 Profile 定制、Oh My Posh 美化、PSReadLine 增强以及常用别名函数五个方面，带你一步步搭建理想的终端环境。
Windows Terminal 基础配置
Windows Terminal 的配置存储在一个 JSON 文件中，通过 Ctrl+Shift+, 可以快速打开。以下是一个经过优化的配置片段，涵盖默认配置文件、启动目录、字体和配色方案。
1
2
3
4
5
6
7
8
9
10
11
12
|
$settingsPath = "$env:LOCALAPPDATA\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\settings.json"
Write-Host "Windows Terminal 配置文件路径: $settingsPath"
if (Test-Path $settingsPath) {
$settings = Get-Content $settingsPath -Raw | ConvertFrom-Json
$defaultProfile = $settings.profiles.list | Where-Object { $_.guid -eq $settings.defaultProfile }
Write-Host "当前默认配置文件: $($defaultProfile.name)"
} else {
Write-Host "未找到 Windows Terminal 配置文件，请确认已安装 Windows Terminal"
}
|
执行结果示例：
1
2
| Windows Terminal 配置文件路径: C:\Users\dev\AppData\Local\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\settings.json
当前默认配置文件: PowerShell 7
|
在 settings.json 中，以下几项配置值得优先调整：
defaultProfile：设置为 PowerShell 7 的 GUID，确保默认打开的是 PS7startingDirectory：设定为你常用的工作目录font.face：推荐使用 Nerd Font，以支持 Oh My Posh 的图标显示colorScheme：选择一个护眼且对比度适中的配色方案
PowerShell 7 Profile 定制
PowerShell 的 Profile 文件类似于 bash 的 .bashrc，每次启动 PowerShell 时自动执行。PS7 的 Profile 路径与 PS5.1 不同，互不干扰。
1
2
|
$PROFILE | Format-List -Force
|
执行结果示例：
1
2
3
4
| AllUsersAllHosts : C:\Program Files\PowerShell\7\profile.ps1
AllUsersCurrentHost : C:\Program Files\PowerShell\7\Microsoft.PowerShell_profile.ps1
CurrentUserAllHosts : C:\Users\dev\Documents\PowerShell\profile.ps1
CurrentUserCurrentHost : C:\Users\dev\Documents\PowerShell\Microsoft.PowerShell_profile.ps1
|
最常用的是 CurrentUserCurrentHost，即当前用户、当前宿主的 Profile。我们来创建一个基础 Profile，包含环境变量设置和模块导入：
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
|
$profileDir = Split-Path $PROFILE -Parent
if (-not (Test-Path $profileDir)) {
New-Item -ItemType Directory -Path $profileDir -Force | Out-Null
Write-Host "已创建 Profile 目录: $profileDir"
}
$profileContent = @'
# === 环境变量 ===
$env:EDITOR = "code"
$env:PYTHONIOENCODING = "utf-8"
# === 编码设置 ===
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
[Console]::InputEncoding = [System.Text.Encoding]::UTF8
$OutputEncoding = [System.Text.Encoding]::UTF8
# === 常用模块自动导入 ===
$modulesToImport = @(
"PSReadLine",
"Terminal-Icons"
)
foreach ($mod in $modulesToImport) {
if (Get-Module -ListAvailable -Name $mod) {
Import-Module $mod -ErrorAction SilentlyContinue
}
}
Write-Host "Profile 加载完成 - $(Get-Date -Format 'HH:mm:ss')" -ForegroundColor DarkGray
'@
Set-Content -Path $PROFILE -Value $profileContent -Encoding UTF8
Write-Host "Profile 文件已写入: $PROFILE"
|
执行结果示例：
1
| Profile 文件已写入: C:\Users\dev\Documents\PowerShell\Microsoft.PowerShell_profile.ps1
|
这段 Profile 做了几件关键的事：统一了编码为 UTF-8（避免中文乱码）、设置了默认编辑器、自动导入常用模块。编码问题是 Windows 下开发最常遇到的坑之一，在 Profile 中统一处理可以省去大量排查时间。
Oh My Posh 终端美化
Oh My Posh 是 Windows 上最流行的终端提示符美化工具，它能为你的终端添加 Git 状态、语言版本、执行时间等信息。配合 Nerd Font，还可以显示丰富的图标。
1
2
3
4
5
6
7
8
9
|
winget install JanDeDobbeleer.OhMyPosh -s winget
oh-my-posh font install FiraCode
oh-my-posh get shell
Write-Host "可用主题数量: $((oh-my-posh get themes).Count)"
|
执行结果示例：
1
2
3
4
| 已成功安装 Oh My Posh
正在安装 FiraCode Nerd Font...
已完成字体安装
可用主题数量: 87
|
在 Profile 中初始化 Oh My Posh。注意不要在 here-string 中使用三反引号，我们用变量拼接的方式来设置主题路径：
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
|
$ompInit = @'
# === Oh My Posh 初始化 ===
if (Get-Command oh-my-posh -ErrorAction SilentlyContinue) {
$ompTheme = Join-Path $env:POSH_THEMES_PATH "jandebuhr.omp.json"
if (-not (Test-Path $ompTheme)) {
$ompTheme = "jandedeurbel"
}
oh-my-posh init pwsh --config $ompTheme | Invoke-Expression
}
'@
Add-Content -Path $PROFILE -Value "`n$ompInit" -Encoding UTF8
Write-Host "Oh My Posh 初始化代码已添加到 Profile"
|
执行结果示例：
1
| Oh My Posh 初始化代码已添加到 Profile
|
Oh My Posh 的主题文件是 JSON 格式，你也可以自定义主题。推荐先用内置主题找到喜欢的风格，再在此基础上微调颜色和段落的显示顺序。一个好主题应该在美观和信息密度之间取得平衡——信息太少不实用，太多则显得杂乱。
常用别名与自定义函数
Profile 中最实用的部分之一就是定义别名和函数，把日常高频操作压缩成简短的命令。以下是笔者常用的配置：
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
|
$aliasAndFuncs = @'
# === 常用别名 ===
Set-Alias -Name ll -Value Get-ChildItem
Set-Alias -Name which -Value Get-Command
Set-Alias -Name touch -Value New-Item
Set-Alias -Name cat -Value Get-Content
# === 自定义函数 ===
# 快速进入项目目录
function projects {
Set-Location "D:\Projects"
}
# 快速查看端口占用
function port {
param([int]$PortNumber)
Get-NetTCPConnection -LocalPort $PortNumber -ErrorAction SilentlyContinue |
Select-Object LocalPort, OwningProcess, State |
Format-Table -AutoSize
}
# 快速查看系统信息
function sysinfo {
$os = Get-CimInstance Win32_OperatingSystem
$cpu = Get-CimInstance Win32_Processor
$mem = [math]::Round($os.FreePhysicalMemory / 1MB, 2)
[PSCustomObject]@{
ComputerName = $env:COMPUTERNAME
OS = $os.Caption
CPU = $cpu.Name
FreeMem_GB = $mem
Uptime = (Get-Date) - $os.LastBootUpTime
} | Format-List
}
# Git 快捷操作
function gs { git status }
function gl { git log --oneline -15 }
function gp { git push }
function gd { git diff $args }
# Docker 快捷操作
function dps { docker ps --format "table {{.ID}}\t{{.Names}}\t{{.Status}}\t{{.Ports}}" }
function dex {
param([string]$ContainerName)
docker exec -it $ContainerName /bin/sh
}
'@
Add-Content -Path $PROFILE -Value "`n$aliasAndFuncs" -Encoding UTF8
Write-Host "别名和函数已添加到 Profile"
|
执行结果示例：
这些函数的设计原则是”短小精悍”：每个函数只做一件事，名字尽量简短但能望文生义。比如 port 8080 比输入完整的 Get-NetTCPConnection -LocalPort 8080 简洁得多，gs 则是 git status 的经典缩写。你可以根据自己的工作流继续扩展这个列表。
PSReadLine 增强补全
PSReadLine 是 PowerShell 的命令行编辑模块，PS7 已内置 2.x 版本。合理配置后，它能提供类似 fish shell 的自动补全体验——输入时实时预测、历史命令搜索、语法高亮一应俱全。
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
|
$psreadlineConfig = @'
# === PSReadLine 配置 ===
if ($host.Name -eq 'ConsoleHost') {
# 预测文本来源：历史记录 + 插件
Set-PSReadLineOption -PredictiveSource HistoryAndPlugin
# 预测文本显示方式：列表视图（类似 fish）
Set-PSReadLineOption -PredictiveStyle ListView
# 历史记录去重
Set-PSReadLineOption -HistoryNoDuplicates
# 保存历史记录条数
Set-PSReadLineOption -MaximumHistoryCount 10000
# 历史记录保存路径
Set-PSReadLineOption -HistorySavePath (Join-Path $env:USERPROFILE ".ps_history")
# 编辑模式设为 Emacs（更符合开发习惯）
Set-PSReadLineOption -EditMode Emacs
# 颜色主题
Set-PSReadLineOption -Colors @{
Command = 'Yellow'
Parameter = 'Green'
String = 'Cyan'
Comment = 'DarkGray'
Operator = 'Magenta'
Prediction = 'DarkGray'
InlinePrediction = 'DarkGray'
}
# Ctrl+d 删除字符（类似 bash）
Set-PSReadLineKeyHandler -Chord 'Ctrl+d' -Function DeleteChar
# Ctrl+w 删除前一个单词
Set-PSReadLineKeyHandler -Chord 'Ctrl+w' -Function BackwardKillWord
# 上下箭头在预测列表中导航
Set-PSReadLineKeyHandler -Chord UpArrow -Function HistorySearchBackward
Set-PSReadLineKeyHandler -Chord DownArrow -Function HistorySearchForward
# Tab 补全显示菜单
Set-PSReadLineKeyHandler -Chord Tab -Function MenuComplete
Set-PSReadLineKeyHandler -Chord Shift+Tab -Function Complete
}
'@
Add-Content -Path $PROFILE -Value "`n$psreadlineConfig" -Encoding UTF8
Write-Host "PSReadLine 配置已添加到 Profile"
|
执行结果示例：
1
| PSReadLine 配置已添加到 Profile
|
PSReadLine 的预测补全功能是提升效率的关键。当你开始输入命令时，它会根据历史记录实时显示匹配建议，按右箭头即可接受。ListView 模式下还会显示一个下拉列表供你选择，配合 HistoryAndPlugin 来源，补全的准确度非常高。
完整 Profile 模板
经过以上各部分的配置，下面给出一个完整的 Profile 模板，方便你一次性部署。建议按需修改目录路径和主题名称。
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
|
$templateContent = @'
# ============================================
# PowerShell 7 Profile - 完整模板
# 生成日期: 2025-04-25
# ============================================
# === 编码设置 ===
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
[Console]::InputEncoding = [System.Text.Encoding]::UTF8
$OutputEncoding = [System.Text.Encoding]::UTF8
# === 环境变量 ===
$env:EDITOR = "code"
# === Oh My Posh ===
if (Get-Command oh-my-posh -ErrorAction SilentlyContinue) {
$ompTheme = Join-Path $env:POSH_THEMES_PATH "jandebuhr.omp.json"
if (-not (Test-Path $ompTheme)) { $ompTheme = "jandedeurbel" }
oh-my-posh init pwsh --config $ompTheme | Invoke-Expression
}
# === 模块导入 ===
$autoModules = @("Terminal-Icons")
foreach ($m in $autoModules) {
if (Get-Module -ListAvailable -Name $m) {
Import-Module $m -ErrorAction SilentlyContinue
}
}
# === PSReadLine ===
if ($host.Name -eq 'ConsoleHost') {
Set-PSReadLineOption -PredictiveSource HistoryAndPlugin
Set-PSReadLineOption -PredictiveStyle ListView
Set-PSReadLineOption -HistoryNoDuplicates
Set-PSReadLineOption -MaximumHistoryCount 10000
Set-PSReadLineOption -HistorySavePath (Join-Path $env:USERPROFILE ".ps_history")
Set-PSReadLineOption -EditMode Emacs
Set-PSReadLineOption -Colors @{
Command = 'Yellow'
Parameter = 'Green'
String = 'Cyan'
Comment = 'DarkGray'
Prediction = 'DarkGray'
InlinePrediction = 'DarkGray'
}
Set-PSReadLineKeyHandler -Chord UpArrow -Function HistorySearchBackward
Set-PSReadLineKeyHandler -Chord DownArrow -Function HistorySearchForward
Set-PSReadLineKeyHandler -Chord Tab -Function MenuComplete
}
# === 别名 ===
Set-Alias ll Get-ChildItem
Set-Alias which Get-Command
Set-Alias touch New-Item
# === 自定义函数 ===
function projects { Set-Location "D:\Projects" }
function port([int]$p) { Get-NetTCPConnection -LocalPort $p -ErrorAction SilentlyContinue | Format-Table -AutoSize }
function sysinfo {
$os = Get-CimInstance Win32_OperatingSystem
[PSCustomObject]@{
Computer = $env:COMPUTERNAME
OS = $os.Caption
FreeMemGB = [math]::Round($os.FreePhysicalMemory / 1MB, 2)
Uptime = (Get-Date) - $os.LastBootUpTime
} | Format-List
}
# === Git 快捷命令 ===
function gs { git status }
function gl { git log --oneline -15 }
function gp { git push }
Write-Host "Profile loaded - $(Get-Date -Format 'HH:mm:ss')" -ForegroundColor DarkGray
'@
$profileDir = Split-Path $PROFILE -Parent
if (-not (Test-Path $profileDir)) {
New-Item -ItemType Directory -Path $profileDir -Force | Out-Null
}
Set-Content -Path $PROFILE -Value $templateContent -Encoding UTF8
Write-Host "完整 Profile 模板已写入: $PROFILE"
|
执行结果示例：
1
| 完整 Profile 模板已写入: C:\Users\dev\Documents\PowerShell\Microsoft.PowerShell_profile.ps1
|
部署完成后，重新打开 Windows Terminal 或执行 . $PROFILE 即可生效。首次加载时 Oh My Posh 会编译主题缓存，之后启动速度很快。如果遇到图标显示为方块，说明 Nerd Font 未正确安装或 Windows Terminal 未配置使用该字体。
注意事项
- Profile 加载顺序：Oh My Posh 初始化应放在 PSReadLine 配置之前，否则预测补全的颜色设置可能被覆盖。
- Nerd Font 必须在 Windows Terminal 中指定：仅安装字体不够，还需要在
settings.json 的 profile 中设置 "font": { "face": "FiraCode Nerd Font" }。
- Profile 修改后别忘重载：修改 Profile 后，在当前会话中执行
. $PROFILE 重新加载，避免关闭重开。
- 编码一致性：确保
settings.json、Profile 文件和系统区域设置都使用 UTF-8，否则中文可能显示为乱码。
- 备份你的配置：建议将 Profile 文件和
settings.json 纳入 Git 管理，换机器时一键恢复。
- PSReadLine 插件模式：
PredictiveSource HistoryAndPlugin 需要安装补全模块（如 CompletionPredictor），如果未安装则回退到纯历史记录模式，不会报错。