Starship 跨 Shell 提示符完整安装指南从零开始配置你的终端【免费下载链接】starship☄️ The minimal, blazing-fast, and infinitely customizable prompt for any shell!项目地址: https://gitcode.com/GitHub_Trending/st/starshipStarship 是一个用 Rust 编写、适用于任何 Shell 的最小化、极速且可无限定制的命令行提示符工具。本指南以 docs/pt-PT/guide/README.md其英文原版为 docs/guide/README.md为核心骨架完整覆盖从环境准备、多平台安装、Shell 初始化到进阶配置的每一步并结合当前仓库的 install/install.sh、src/init/mod.rs、src/main.rs 等源码说明底层工作原理。读完本文你将能在 Bash、Zsh、Fish、PowerShell 等主流 Shell 上完成 Starship 的安装与启用并掌握后续自定义提示符的入口。为什么选择 Starship设计定位与核心特性根据指南文档Starship 的定位是适用于任何 Shell 的最小化、极速、无限可定制的提示符其核心特性可以概括为六点快Fast提示符渲染性能极佳几乎不会拖慢终端响应可定制Customizable提示符的每一个细节都可以通过 TOML 配置文件调整通用Universal适用于任何 Shell、任何操作系统智能Intelligent一眼展示与当前工作目录相关的关键信息如 Git 分支、语言版本、命令耗时等功能丰富Feature rich为几乎所有主流开发工具提供内置支持易用Easy几分钟内即可完成安装并投入使用。从源码结构看这一设计承诺有着坚实的实现支撑仓库 src/modules 目录下包含 100 余个模块实现如git_branch.rs、nodejs.rs、python.rs、cmd_duration.rs等而 src/configs 目录则对应存放每个模块的配置结构定义二者一一对应这也是功能丰富与可定制的直接体现。安装前置条件Nerd Font在安装 Starship 之前唯一必须准备的环境是在终端中安装并启用一款 Nerd Font 字体。Starship 默认提示符大量使用图标与特殊符号如分支符号、语言 Logo 等普通等宽字体无法正确渲染这些字形。官方推荐从 Nerd Fonts 项目下载例如FiraCode Nerd Font。说明如果你的终端环境无法安装 Nerd FontStarship 也提供了纯文本plain-text与无 Nerd Fontno-nerd-font等预设方案相关内容可参考 docs/presets 目录下的文档。Step 1在各操作系统上安装 Starship指南文档按操作系统分平台给出了安装方式。最快捷的通用方式是使用官方安装脚本curl -sS https://starship.rs/install.sh | sh该命令适用于 Linux 与 macOS。仓库中保留了这份安装脚本的完整副本 install/install.sh从源码可以确认它的关键行为平台与架构自动检测脚本通过uname -s识别平台Linux 默认使用静态编译的 musl 版本以避免链接问题Windows 的 Git Bash/MSYS 环境识别为pc-windows-msvc通过uname -m识别架构并支持x86_64、i686、arm、aarch64、riscv64gc等目标支持的命令行参数--verbose/-V、--force/-y/--yes跳过确认提示、--platform、--bin-dir、--arch、--base-url、--version安装指定版本如v1.2.3、--help多下载工具回退依次尝试curl、wget、fetch若curl是通过 snap 安装的则会自动降级到其他工具权限自动提升目标目录不可写时自动调用sudo提权安装完成后脚本会打印针对 bash、zsh、fish、PowerShell 等各 Shell 的配置提示print_install函数。除了官方脚本各平台还有丰富的包管理器渠道完整整理如下。Android软件源安装命令Termuxpkg install starshipBSD发行版软件源安装命令任意crates.iocargo install starship --lockedFreeBSDFreshPortspkg install starshipNetBSDpkgsrcpkgin install starshipLinux优先推荐官方安装脚本也可使用以下任一包管理器发行版软件源安装命令任意crates.iocargo install starship --locked任意conda-forgeconda install -c conda-forge starship任意Linuxbrewbrew install starshipAlpine Linux 3.13Alpine Linux Packagesapk add starshipArch LinuxArch Linux Extrapacman -S starshipCentOS 7Coprdnf copr enable atim/starship然后dnf install starshipDebian 13Debian Mainapt install starshipFedora 40Coprdnf copr enable atim/starship然后dnf install starshipGentooGentoo Packagesemerge app-shells/starshipManjaro—pacman -S starshipNixOSnixpkgsnix-env -iA nixpkgs.starshipopenSUSEOSSzypper in starshipUbuntu 25.04Ubuntu Universeapt install starshipVoid LinuxVoid Linux Packagesxbps-install -S starshipmacOS同样优先推荐官方安装脚本也可使用软件源安装命令crates.iocargo install starship --lockedconda-forgeconda install -c conda-forge starshipHomebrewbrew install starshipMacPortsport install starshipWindows可通过官方 Release 页面下载 MSI 安装程序或使用以下包管理器软件源安装命令crates.iocargo install starship --lockedChocolateychoco install starshipconda-forgeconda install -c conda-forge starshipScoopscoop install starshipwingetwinget install --id Starship.StarshipStep 2为你的 Shell 启用 Starship安装完成后需要让 Shell 在启动时初始化 Starship。指南文档为 10 种主流 Shell 提供了对应的初始化配置其中starship init shell是核心命令。下面逐一列出官方推荐写法及其配置文件位置。Bash在~/.bashrc末尾追加eval $(starship init bash)CmdWindows 命令提示符需要搭配Clink v1.2.30使用。在%LocalAppData%\clink\starship.lua路径创建文件内容为load(io.popen(starship init cmd):read(*a))()Elvish在~/.config/elvish/rc.elvWindows 为%AppData%\elvish\rc.elv末尾追加eval (starship init elvish)注意仅支持 Elvish v0.18对于 v0.21.0 之前的版本配置文件可能位于~/.elvish/rc.elv。Fish在~/.config/fish/config.fish末尾追加starship init fish | sourceIon在~/.config/ion/initrc末尾追加eval $(starship init ion)Nushell在 Nushell 配置运行$nu.config-path可查看其路径中追加mkdir ($nu.data-dir | path join vendor/autoload) starship init nu | save -f ($nu.data-dir | path join vendor/autoload/starship.nu)注意仅支持 Nushell v0.96。PowerShell在 PowerShell 配置文件中追加运行$PROFILE可查看其位置Invoke-Expression (starship init powershell)Tcsh在~/.tcshrc末尾追加eval starship init tcshXonsh在~/.xonshrc末尾追加execx($(starship init xonsh))Zsh在~/.zshrc末尾追加eval $(starship init zsh)初始化机制源码剖析两阶段 init上述配置行看起来简单背后是一套精心设计的两阶段初始化机制实现在 src/init/mod.rs 中第一阶段init stubstarship init shell输出一小段引导代码stub该代码再调用starship init shell --print-full-init获取完整的初始化脚本并通过source与进程替换求值执行第二阶段init main--print-full-init分支输出真正的初始化脚本如starship.bash、starship.zsh、starship.ps1等均以include_str!内嵌进二进制见 src/init/starship.bash 等文件并把::STARSHIP::占位符替换为 starship 二进制文件的完整路径。之所以采用两阶段而非直接把脚本eval成单行源码注释解释得很清楚单行求值会让注释吞掉后续内容、被迫到处补分号而通过source 进程替换可以保留脚本的可注释、可调试性同时兼容eval $(starship init X)这种传统写法。以 Bash 为例src/init/starship.bash 的实现还展示了 Starship 计时与状态采集的精巧之处使用PROMPT_COMMAND挂载starship_precmd在每次绘制提示符前收集退出状态STARSHIP_CMD_STATUS、管道状态PIPESTATUS、后台任务数jobs、Shell 层级SHLVL与终端宽度COLUMNS通过 DEBUG trap或较新 Bash 的PS0机制记录命令开始时间命令结束后调用starship time计算耗时为cmd_duration模块提供数据命令开始时设置STARSHIP_PREEXEC_READY标志避免管道中slow | slow | fast这类场景产生错误的计时完整地保存用户已有的PROMPT_COMMAND与 DEBUG trap避免覆盖用户的既有配置。这也解释了为什么文档要求把eval $(starship init bash)追加到配置文件的末尾——确保环境变量与函数在正确时机就绪。Step 3验证安装并开始配置启动一个新的 Shell 实例如果一切正常你将看到全新的 Starship 提示符。若默认样式已经满足需求可以直接开始使用若想进一步定制指南文档提供了两个后续入口配置文档系统讲解 Starship 的 TOML 配置语法、模块选项与格式字符串是定制提示符的核心参考预设集社区预置的整套配置方案可直接借鉴使用仓库 docs/presets 下收录了如no-nerd-font无 Nerd Font 方案、nerd-font、bracketed-segmentsPowerline 风格、plain-text纯文本等多种预设的说明对应的 TOML 文件则位于 docs/public/presets。与配置相关的 CLI 辅助命令除手动编辑配置文件外Starship 还提供了一组由 src/main.rs 定义、实现在 src/configure.rs 的配置管理命令starship config key value直接更新某个配置项例如starship config character.symbol ➜支持用点号索引 TOML 嵌套表starship config不带参数打开系统默认编辑器非 Windows 为viWindows 为notepad.exe编辑配置文件starship print-config打印计算后的完整配置--default可输出默认配置而非用户配置starship toggle module [key]快速切换某模块的开关默认切换disabled键。从 src/config.rs 的源码可以看到配置加载的容错设计配置文件以 TOML 解析缺失的键自动回退到默认值若遇到未知键会打印警告并忽略该键继续解析from_config中Unknown key分支保证用户配置的向前兼容性。其他实用诊断命令指南文档虽未展开但同一 CLI 中还包含以下与安装、调试强相关的子命令见 src/main.rsstarship init --print-full-init查看某个 Shell 的完整初始化脚本便于排查初始化问题starship bug-report自动生成预填充了当前配置与环境信息的 GitHub Issue 模板方便报告问题starship timings打印各模块的渲染耗时用于定位提示符变慢的模块starship explain解释当前提示符中各模块的来源starship module name单独渲染并打印某个模块starship completions shell为 bash、zsh、fish、PowerShell、Elvish、Nushell 生成 Starship 自身的 Shell 补全脚本。参与贡献与许可证Starship 欢迎各种水平的贡献者。指南文档提到可以从标记为good first issue的入门问题入手如果你精通非英语语言也可以借助 Crowdin 平台帮助维护各语言文档的翻译详细的贡献规范可查阅仓库根目录的 CONTRIBUTING.md。项目采用ISC 许可证见 LICENSE版权归 2019 年至今的 Starship 贡献者所有。此外其 Windows 版本代码签名由 SignPath.io 免费提供程序不会在未经用户或安装者明确请求的情况下向其他网络系统传输任何信息。总结本指南以官方安装文档为主线完整覆盖了 Starship 的六项设计特性、Nerd Font 前置要求、Android/BSD/Linux/macOS/Windows 五大平台的全部安装方式、10 种 Shell 的初始化配置并通过 install/install.sh 与 src/init/mod.rs 等源码揭示了安装脚本与两阶段初始化机制的底层实现。安装完成只是开始接下来建议阅读 配置文档 与 预设集把提示符逐步调校成最适合自己工作流的样子。【免费下载链接】starship☄️ The minimal, blazing-fast, and infinitely customizable prompt for any shell!项目地址: https://gitcode.com/GitHub_Trending/st/starship创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Starship 跨 Shell 提示符完整安装指南：从零开始配置你的终端
Starship 跨 Shell 提示符完整安装指南从零开始配置你的终端【免费下载链接】starship☄️ The minimal, blazing-fast, and infinitely customizable prompt for any shell!项目地址: https://gitcode.com/GitHub_Trending/st/starshipStarship 是一个用 Rust 编写、适用于任何 Shell 的最小化、极速且可无限定制的命令行提示符工具。本指南以 docs/pt-PT/guide/README.md其英文原版为 docs/guide/README.md为核心骨架完整覆盖从环境准备、多平台安装、Shell 初始化到进阶配置的每一步并结合当前仓库的 install/install.sh、src/init/mod.rs、src/main.rs 等源码说明底层工作原理。读完本文你将能在 Bash、Zsh、Fish、PowerShell 等主流 Shell 上完成 Starship 的安装与启用并掌握后续自定义提示符的入口。为什么选择 Starship设计定位与核心特性根据指南文档Starship 的定位是适用于任何 Shell 的最小化、极速、无限可定制的提示符其核心特性可以概括为六点快Fast提示符渲染性能极佳几乎不会拖慢终端响应可定制Customizable提示符的每一个细节都可以通过 TOML 配置文件调整通用Universal适用于任何 Shell、任何操作系统智能Intelligent一眼展示与当前工作目录相关的关键信息如 Git 分支、语言版本、命令耗时等功能丰富Feature rich为几乎所有主流开发工具提供内置支持易用Easy几分钟内即可完成安装并投入使用。从源码结构看这一设计承诺有着坚实的实现支撑仓库 src/modules 目录下包含 100 余个模块实现如git_branch.rs、nodejs.rs、python.rs、cmd_duration.rs等而 src/configs 目录则对应存放每个模块的配置结构定义二者一一对应这也是功能丰富与可定制的直接体现。安装前置条件Nerd Font在安装 Starship 之前唯一必须准备的环境是在终端中安装并启用一款 Nerd Font 字体。Starship 默认提示符大量使用图标与特殊符号如分支符号、语言 Logo 等普通等宽字体无法正确渲染这些字形。官方推荐从 Nerd Fonts 项目下载例如FiraCode Nerd Font。说明如果你的终端环境无法安装 Nerd FontStarship 也提供了纯文本plain-text与无 Nerd Fontno-nerd-font等预设方案相关内容可参考 docs/presets 目录下的文档。Step 1在各操作系统上安装 Starship指南文档按操作系统分平台给出了安装方式。最快捷的通用方式是使用官方安装脚本curl -sS https://starship.rs/install.sh | sh该命令适用于 Linux 与 macOS。仓库中保留了这份安装脚本的完整副本 install/install.sh从源码可以确认它的关键行为平台与架构自动检测脚本通过uname -s识别平台Linux 默认使用静态编译的 musl 版本以避免链接问题Windows 的 Git Bash/MSYS 环境识别为pc-windows-msvc通过uname -m识别架构并支持x86_64、i686、arm、aarch64、riscv64gc等目标支持的命令行参数--verbose/-V、--force/-y/--yes跳过确认提示、--platform、--bin-dir、--arch、--base-url、--version安装指定版本如v1.2.3、--help多下载工具回退依次尝试curl、wget、fetch若curl是通过 snap 安装的则会自动降级到其他工具权限自动提升目标目录不可写时自动调用sudo提权安装完成后脚本会打印针对 bash、zsh、fish、PowerShell 等各 Shell 的配置提示print_install函数。除了官方脚本各平台还有丰富的包管理器渠道完整整理如下。Android软件源安装命令Termuxpkg install starshipBSD发行版软件源安装命令任意crates.iocargo install starship --lockedFreeBSDFreshPortspkg install starshipNetBSDpkgsrcpkgin install starshipLinux优先推荐官方安装脚本也可使用以下任一包管理器发行版软件源安装命令任意crates.iocargo install starship --locked任意conda-forgeconda install -c conda-forge starship任意Linuxbrewbrew install starshipAlpine Linux 3.13Alpine Linux Packagesapk add starshipArch LinuxArch Linux Extrapacman -S starshipCentOS 7Coprdnf copr enable atim/starship然后dnf install starshipDebian 13Debian Mainapt install starshipFedora 40Coprdnf copr enable atim/starship然后dnf install starshipGentooGentoo Packagesemerge app-shells/starshipManjaro—pacman -S starshipNixOSnixpkgsnix-env -iA nixpkgs.starshipopenSUSEOSSzypper in starshipUbuntu 25.04Ubuntu Universeapt install starshipVoid LinuxVoid Linux Packagesxbps-install -S starshipmacOS同样优先推荐官方安装脚本也可使用软件源安装命令crates.iocargo install starship --lockedconda-forgeconda install -c conda-forge starshipHomebrewbrew install starshipMacPortsport install starshipWindows可通过官方 Release 页面下载 MSI 安装程序或使用以下包管理器软件源安装命令crates.iocargo install starship --lockedChocolateychoco install starshipconda-forgeconda install -c conda-forge starshipScoopscoop install starshipwingetwinget install --id Starship.StarshipStep 2为你的 Shell 启用 Starship安装完成后需要让 Shell 在启动时初始化 Starship。指南文档为 10 种主流 Shell 提供了对应的初始化配置其中starship init shell是核心命令。下面逐一列出官方推荐写法及其配置文件位置。Bash在~/.bashrc末尾追加eval $(starship init bash)CmdWindows 命令提示符需要搭配Clink v1.2.30使用。在%LocalAppData%\clink\starship.lua路径创建文件内容为load(io.popen(starship init cmd):read(*a))()Elvish在~/.config/elvish/rc.elvWindows 为%AppData%\elvish\rc.elv末尾追加eval (starship init elvish)注意仅支持 Elvish v0.18对于 v0.21.0 之前的版本配置文件可能位于~/.elvish/rc.elv。Fish在~/.config/fish/config.fish末尾追加starship init fish | sourceIon在~/.config/ion/initrc末尾追加eval $(starship init ion)Nushell在 Nushell 配置运行$nu.config-path可查看其路径中追加mkdir ($nu.data-dir | path join vendor/autoload) starship init nu | save -f ($nu.data-dir | path join vendor/autoload/starship.nu)注意仅支持 Nushell v0.96。PowerShell在 PowerShell 配置文件中追加运行$PROFILE可查看其位置Invoke-Expression (starship init powershell)Tcsh在~/.tcshrc末尾追加eval starship init tcshXonsh在~/.xonshrc末尾追加execx($(starship init xonsh))Zsh在~/.zshrc末尾追加eval $(starship init zsh)初始化机制源码剖析两阶段 init上述配置行看起来简单背后是一套精心设计的两阶段初始化机制实现在 src/init/mod.rs 中第一阶段init stubstarship init shell输出一小段引导代码stub该代码再调用starship init shell --print-full-init获取完整的初始化脚本并通过source与进程替换求值执行第二阶段init main--print-full-init分支输出真正的初始化脚本如starship.bash、starship.zsh、starship.ps1等均以include_str!内嵌进二进制见 src/init/starship.bash 等文件并把::STARSHIP::占位符替换为 starship 二进制文件的完整路径。之所以采用两阶段而非直接把脚本eval成单行源码注释解释得很清楚单行求值会让注释吞掉后续内容、被迫到处补分号而通过source 进程替换可以保留脚本的可注释、可调试性同时兼容eval $(starship init X)这种传统写法。以 Bash 为例src/init/starship.bash 的实现还展示了 Starship 计时与状态采集的精巧之处使用PROMPT_COMMAND挂载starship_precmd在每次绘制提示符前收集退出状态STARSHIP_CMD_STATUS、管道状态PIPESTATUS、后台任务数jobs、Shell 层级SHLVL与终端宽度COLUMNS通过 DEBUG trap或较新 Bash 的PS0机制记录命令开始时间命令结束后调用starship time计算耗时为cmd_duration模块提供数据命令开始时设置STARSHIP_PREEXEC_READY标志避免管道中slow | slow | fast这类场景产生错误的计时完整地保存用户已有的PROMPT_COMMAND与 DEBUG trap避免覆盖用户的既有配置。这也解释了为什么文档要求把eval $(starship init bash)追加到配置文件的末尾——确保环境变量与函数在正确时机就绪。Step 3验证安装并开始配置启动一个新的 Shell 实例如果一切正常你将看到全新的 Starship 提示符。若默认样式已经满足需求可以直接开始使用若想进一步定制指南文档提供了两个后续入口配置文档系统讲解 Starship 的 TOML 配置语法、模块选项与格式字符串是定制提示符的核心参考预设集社区预置的整套配置方案可直接借鉴使用仓库 docs/presets 下收录了如no-nerd-font无 Nerd Font 方案、nerd-font、bracketed-segmentsPowerline 风格、plain-text纯文本等多种预设的说明对应的 TOML 文件则位于 docs/public/presets。与配置相关的 CLI 辅助命令除手动编辑配置文件外Starship 还提供了一组由 src/main.rs 定义、实现在 src/configure.rs 的配置管理命令starship config key value直接更新某个配置项例如starship config character.symbol ➜支持用点号索引 TOML 嵌套表starship config不带参数打开系统默认编辑器非 Windows 为viWindows 为notepad.exe编辑配置文件starship print-config打印计算后的完整配置--default可输出默认配置而非用户配置starship toggle module [key]快速切换某模块的开关默认切换disabled键。从 src/config.rs 的源码可以看到配置加载的容错设计配置文件以 TOML 解析缺失的键自动回退到默认值若遇到未知键会打印警告并忽略该键继续解析from_config中Unknown key分支保证用户配置的向前兼容性。其他实用诊断命令指南文档虽未展开但同一 CLI 中还包含以下与安装、调试强相关的子命令见 src/main.rsstarship init --print-full-init查看某个 Shell 的完整初始化脚本便于排查初始化问题starship bug-report自动生成预填充了当前配置与环境信息的 GitHub Issue 模板方便报告问题starship timings打印各模块的渲染耗时用于定位提示符变慢的模块starship explain解释当前提示符中各模块的来源starship module name单独渲染并打印某个模块starship completions shell为 bash、zsh、fish、PowerShell、Elvish、Nushell 生成 Starship 自身的 Shell 补全脚本。参与贡献与许可证Starship 欢迎各种水平的贡献者。指南文档提到可以从标记为good first issue的入门问题入手如果你精通非英语语言也可以借助 Crowdin 平台帮助维护各语言文档的翻译详细的贡献规范可查阅仓库根目录的 CONTRIBUTING.md。项目采用ISC 许可证见 LICENSE版权归 2019 年至今的 Starship 贡献者所有。此外其 Windows 版本代码签名由 SignPath.io 免费提供程序不会在未经用户或安装者明确请求的情况下向其他网络系统传输任何信息。总结本指南以官方安装文档为主线完整覆盖了 Starship 的六项设计特性、Nerd Font 前置要求、Android/BSD/Linux/macOS/Windows 五大平台的全部安装方式、10 种 Shell 的初始化配置并通过 install/install.sh 与 src/init/mod.rs 等源码揭示了安装脚本与两阶段初始化机制的底层实现。安装完成只是开始接下来建议阅读 配置文档 与 预设集把提示符逐步调校成最适合自己工作流的样子。【免费下载链接】starship☄️ The minimal, blazing-fast, and infinitely customizable prompt for any shell!项目地址: https://gitcode.com/GitHub_Trending/st/starship创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
