Starship如何在Windows Terminal中使用_Starship Windows Terminal使用解析

需完成字体支持、Starship安装、Shell初始化及配置加载四环节：一、安装Nerd Font并设为Terminal默认字体；二、用winget等任一方式安装starship.exe；三、在$PROFILE末尾添加Invoke-Expression (&starship init powershell)；四、运行starship --version验证并生成~.config\starship.toml；五、在WT设置中添加STARSHIP_SHELL和STARSHIP_CONFIG环境变量。

如果您已安装Windows Terminal并希望在其中启用Starship作为提示符引擎，则需完成字体支持、Starship安装、Shell初始化及配置加载四个关键环节。以下是实现此目标的具体步骤：

一、安装兼容Nerd Font的等宽字体

Starship依赖Unicode扩展符号（如Git分支图标、语言标识符）显示状态信息，而Windows默认字体不包含这些字形。必须安装Nerd Fonts才能避免图标乱码或方块显示。

1、访问Nerd Fonts官网，在“Download”区域选择推荐字体，例如Fira Code Nerd Font或Cascadia Code PL。

2、下载对应版本的.zip压缩包，解压后全选所有.ttf文件，右键选择“为所有用户安装”。

3、打开Windows Terminal，点击下拉箭头→“设置”→左侧选择“默认值”→“外观”→在“字体”下拉菜单中选择刚安装的Nerd Font名称。

4、确认“字体大小”设置为10或以上，避免小字号导致图标渲染模糊。

二、安装Starship程序本体

Starship是独立可执行程序，不修改系统Shell核心，仅通过初始化脚本注入提示符逻辑。安装方式多样，任选其一即可生效。

1、使用winget（推荐，无需额外环境）：
以管理员权限打开PowerShell，执行：
winget install --id Starship.Starship

2、使用Scoop（适合已配置Scoop用户）：
在PowerShell中运行：
scoop install starship

3、使用Chocolatey（若已安装choco）：
执行：
choco install starship

4、手动安装（适用于离线或受限环境）：
前往GitHub发布页，下载最新版starship-x86_64-pc-windows-msvc.zip，解压后将starship.exe放入系统PATH目录（如C:\Windows\System32或自定义bin目录）。

三、配置PowerShell启动时加载Starship

PowerShell需在每次启动时执行Starship初始化指令，从而接管提示符渲染逻辑。该操作通过修改用户配置文件$PROFILE实现。

1、检查并创建PowerShell配置文件：
if (!(Test-Path $PROFILE)) { New-Item -Type File -Path $PROFILE -Force }

2、用记事本打开该文件：
notepad $PROFILE

3、在文件末尾添加以下初始化语句：
Invoke-Expression (&starship init powershell)

4、保存文件并关闭记事本。

5、在当前PowerShell窗口中执行：
.\$PROFILE 或重启终端使配置生效。

四、验证与基础配置生成

初始化成功后，PowerShell提示符将立即变化；若仍显示原始PS路径，说明初始化未触发或字体未生效。此时应优先验证Starship是否可调用，并生成默认配置供后续定制。

1、在PowerShell中运行：
starship --version，确认输出类似“starship 1.19.3”字样。

2、运行命令生成默认配置文件：
starship init powershell | Out-Null; starship config

3、该命令将自动打开默认文本编辑器（通常是记事本），显示位于%USERPROFILE%\.config\starship.toml的配置文件。

4、首次打开时文件为空或仅含注释，可暂不修改，保存退出后重新打开终端，即可看到基础Starship提示符（含主机名、路径、Git状态等默认模块）。

五、启用Windows Terminal专用适配（可选但推荐）

Windows Terminal提供更精细的渲染控制能力，Starship可通过环境变量告知其运行于该终端，从而启用亚克力背景兼容、高DPI优化等特性。

1、在Windows Terminal设置中，进入“配置文件”→选择“PowerShell”→“高级”→找到“环境变量”项。

2、点击“添加”，设置键名为STARSHIP_SHELL，值为powershell。

3、再添加一项，键名为STARSHIP_CONFIG，值为%USERPROFILE%\.config\starship.toml（确保路径存在且可读）。

4、保存设置，重启Windows Terminal，观察提示符右侧是否出现更精准的时间戳与执行时长标识。