Starship 跨 Shell 提示符实战指南全平台安装、Shell 集成与 init 初始化原理剖析【免费下载链接】starship☄️ The minimal, blazing-fast, and infinitely customizable prompt for any shell!项目地址: https://gitcode.com/GitHub_Trending/st/starship本文基于 Starship 仓库官方指南docs/ckb-IR/guide/README.md对应英文源文档整理成文覆盖其完整落地链路安装前置条件Nerd Font、Android/BSD/Linux/macOS/Windows 五大平台的包管理器安装矩阵、官方一键安装脚本install.sh的底层工作机制以及十个 ShellBash、Zsh、Fish、PowerShell、Elvish、Tcsh、Xonsh、Nushell、Ion、Cmd的集成配置。读完本文你可以从零在任意操作系统上完成 Starship 的安装与 Shell 接管并从源码层面理解starship init两阶段初始化、路径转义与--print-full-init的调用关系。一、Starship 是什么Starship 的自我定位是minimal, blazing-fast, and infinitely customizable prompt for any shell——一个极简、极快且可无限定制的跨 Shell 提示符工具。官方指南列出的核心特性Fast速度是其第一卖点really reallyfastCustomizable提示符的每一个方面都可以配置Universal任意 Shell、任意操作系统均可运行Intelligent根据当前目录/环境智能显示相关信息Feature rich内置对大量开发工具的探测支持git、rust、python、node 等见 src/configs/ 目录下的模块定义Easy几分钟即可完成安装。当前仓库版本为 1.26.0见 Cargo.toml构建要求 Rust ≥ 1.95Cargo.toml 中注明 MSRV 仅为提示官方仅支持最新 Rust 版本项目采用 ISC 许可证。二、前置条件安装并启用 Nerd Font在配置 Shell 之前官方指南明确要求终端中已安装并启用一款 Nerd Font指南以 FiraCode Nerd Font 为例。Starship 的默认提示符使用大量 Nerd Font 图标git 分支符号、语言版本图标等。若未安装 Nerd Font图标会显示为方块乱码。仓库为此提供了无图标方案预置配置no-nerd-font与plain-text-symbols对应 docs/public/presets/toml/no-nerd-font.toml且 docs/public/nerd-font.woff2 是文档站点为展示页面内嵌下载的字体文件。如果你不想折腾终端字体可以先用no-nerd-font预设过渡见第五节。三、Step 1安装 Starship3.1 官方一键脚本Linux / macOS / BSD / Git-Bash指南给出的最快安装方式是一行命令curl -sS https://starship.rs/install.sh | sh该脚本在仓库中即 docs/public/install.sh与 install/install.sh 完全一致diff结果相同前者是发布到站点供curl | sh使用的镜像。阅读源码可以发现几个值得注意的设计1. 强制 POSIX Shell 执行。脚本开头定义了verify_shell_is_posix_or_exit()docs/public/install.sh检测到在 zsh 或非 POSIX 模式的 bash 下运行会直接报错退出要求改用sh执行——这正是指南中命令统一写成| sh的原因。2. 目标平台白名单。脚本只下载预编译二进制支持的构建目标为docs/public/install.shx86_64-unknown-linux-gnu / x86_64-unknown-linux-musl i686-unknown-linux-musl / aarch64-unknown-linux-musl arm-unknown-linux-musleabihf x86_64-apple-darwin / aarch64-apple-darwin x86_64-pc-windows-msvc / i686-pc-windows-msvc / aarch64-pc-windows-msvc x86_64-unknown-freebsd riscv64gc-unknown-linux-musl3. 平台与架构自动探测。detect_platform()L217 起将uname -s的结果映射为 target 平台Linux 一律选用unknown-linux-musl静态链接版以避免 glibc 链接问题MSYS/Cygwin/MingwGit Bash统一映射为pc-windows-msvcdetect_arch()L239 起将amd64/armv*/arm64/riscv64规范化并用getconf LONG_BIT二次校验防止 32 位系统被误报为 64 位。4. 下载与提权策略。download()优先使用 curl并显式检测 snap 版 curl 的已知缺陷回退到 wget / fetchinstall()先通过test_writable试探 bin 目录是否可写不可写才通过sudo提权避免不必要的 root 安装。5. 完整命令行选项脚本usage()中定义选项作用-V, --verbose输出详细下载/解压日志-f, -y, --force, --yes跳过安装确认提示-p, --platform覆盖自动探测的平台-b, --bin-dir覆盖二进制安装目录-a, --arch覆盖自动探测的架构-B, --base-url覆盖 release 下载基址私有镜像场景-v, --version安装指定版本形如v1.2.3注意必须带v前缀3.2 各平台包管理器安装矩阵指南按操作系统给出了完整的包管理器对照表此处完整继承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 Packagesapk add starshipArch / ManjaroArch Extrapacman -S starshipCentOS 7 / Fedora 40Coprdnf copr enable atim/starship后dnf install starshipDebian 13 / Ubuntu 25.04官方仓库apt install starshipGentooGentoo Packagesemerge app-shells/starshipNixOSnixpkgsnix-env -iA nixpkgs.starshipopenSUSEOSSzypper in starshipVoid LinuxVoid Packagesxbps-install -S starshipmacOS仓库命令crates.iocargo install starship --lockedconda-forgeconda install -c conda-forge starshipHomebrewbrew install starshipMacPortsport install starshipWindows除 MSI 安装器随 release 发布外仓库命令crates.iocargo install starship --lockedChocolateychoco install starshipconda-forgeconda install -c conda-forge starshipScoopscoop install starshipwingetwinget install --id Starship.Starship使用cargo install starship --locked时请确认本机 Rust 工具链可用--locked保证依赖锁定文件生效构建产物与官方发布一致。四、Step 2让 Shell 使用 Starship安装完成后需要在各 Shell 的启动文件中加载 Starship。指南支持以下 10 种 Shell配置片段完整继承如下。4.1 各 Shell 的集成配置Bash—— 追加到~/.bashrc末尾eval $(starship init bash)Zsh—— 追加到~/.zshrc末尾eval $(starship init zsh)Fish—— 追加到~/.config/fish/config.fish末尾starship init fish | sourcePowerShell—— 追加到 PowerShell 配置文件运行$PROFILE查看路径末尾Invoke-Expression (starship init powershell)Elvish—— 追加到~/.config/elvish/rc.elvWindows 下为%AppData%\elvish\rc.elv末尾eval (starship init elvish)注意仅支持 Elvish v0.18v0.21.0 之前的版本配置文件可能是~/.elvish/rc.elv。Tcsh—— 追加到~/.tcshrc末尾eval starship init tcshXonsh—— 追加到~/.xonshrc末尾execx($(starship init xonsh))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。Ion—— 追加到~/.config/ion/initrc末尾eval $(starship init ion)CmdWindows 命令提示符—— 需要借助 Clinkv1.2.30在%LocalAppData%\clink\starship.lua创建文件内容为load(io.popen(starship init cmd):read(*a))()4.2 源码解析starship init的两阶段初始化为什么各 Shell 的写法如此不统一eval/source/execx/Invoke-Expression答案在 src/init/mod.rs 中。入口命令定义。Init子命令在 src/main.rs 中定义接收 shell 名与一个关键开关--print-full-init/// Prints the shell function used to execute starship Init { shell: String, #[clap(long)] print_full_init: bool, }两阶段设计。init_stub()src/init/mod.rs负责打印给 Shell 的“引导桩代码”init_main()L219 起在--print-full-init时打印完整初始化脚本。文件头部的注释解释了动机直接eval一段未加引号的脚本会被压成单行求值注释会吞掉整行、需到处加分号因此采用source 进程替换的两阶段方案使 init 脚本可以正常注释与调试。以 Bash 为例stub 实际输出L165为eval -- $(starship init bash --print-full-init)这段注释还记录了历史坑位macOS 默认 bash 3.2 不支持source (...)进程替换/dev/stdin技巧又与 Git Bash、Termux 的模拟 POSIX 环境不兼容最终eval -- $(...)写法从 bash 3.2 到最新版、含 POSIX 模式全兼容。二进制路径的 Shell 感知转义。init 脚本模板中的::STARSHIP::占位符会被替换为 starship 二进制的真实路径print_script()L242 起且路径转义按 Shell 定制StarshipPathL23 起sprint()POSIX 风格shell_words::quote引号处理sprint_posix()Windows 上额外调用cygpath将路径转换为 Unix 风格找不到cygpath时静默回退即非 Cygwin 环境sprint_pwsh()PowerShell 单引号包裹并将内部转义为sprint_elv()Elvish 前缀e:强制解释为可执行路径顺带规避E:\...盘符路径歧义sprint_cmdexe()CMD 双引号包裹。这些转义逻辑均有单元测试覆盖src/init/mod.rs如含空格的C:\Cool Tools\starship.exe用例。各 Shell 的完整 init 脚本以include_str!内嵌在二进制中starship.bash/starship.zsh/starship.fish/starship.ps1/starship.ion/starship.elv/starship.tcsh/starship.nu/starship.xsh/starship.luasrc/init/ 目录对应CMDEXE_INIT等常量L262-L280。init 脚本的工程细节。文件末尾的注释L247 起补充了一个性能考量--jobs参数带引号传入是因为 macOS 的wc输出会带空白因此把去空白的工作放到 Rust 端完成避免每次绘制 Shell 时多 fork 一个子进程——这也呼应了 Starship “快”的设计目标。4.3 验证安装开启一个新的 Shell 实例应当能看到 Starship 提示符。从 src/test/ 目录可见仓库用fixtures/下的测试包与jj_tester.rs等测试工具对提示符行为做集成验证本地快速自检可以直接在 Shell 中运行starship module list或starship explainexplain子命令用于解释当前提示符中各模块的显示原因见 src/main.rs。五、Step 3配置 Starship若默认提示符已满足需求到此即可。官方指南将深度定制分成两条路径对应仓库中的本地文档Configuration如何把提示符调整到你喜欢的一切细节参见 docs/config/README.md配置项总览、模块级参数如format、style、disabled等Presets从他人预构建的配置中获得灵感参见 docs/presets/README.md。仓库内预置了 12 份可直接取用的预设配置位于 docs/public/presets/toml/预设文件定位bracketed-segmentsbracketed-segments.toml方括号分段风格catppuccin-powerlinecatppuccin-powerline.tomlCatppuccin 配色 Powerlinegruvbox-rainbowgruvbox-rainbow.tomlGruvbox 彩虹配色jetpackjetpack.toml深色 Jetpack 风格nerd-font-symbolsnerd-font-symbols.toml全套 Nerd Font 符号no-empty-iconsno-empty-icons.toml隐藏空图标no-nerd-fontno-nerd-font.toml无 Nerd Font 环境替代方案no-runtime-versionsno-runtime-versions.toml不显示语言运行时版本pastel-powerlinepastel-powerline.toml柔和色 Powerlineplain-text-symbolsplain-text-symbols.toml纯文本符号pure-presetpure-preset.tomlPure 风格简洁提示符tokyo-nighttokyo-night.tomlTokyo Night 配色获取预设的方式是运行starship preset 名称并写入配置文件——Preset子命令src/main.rs支持--list列出全部预设名、-o/--output输出到文件、-f/--force覆盖已有文件这些预设正是从docs/public/presets/toml/内嵌进二进制的见 Cargo.toml 的include清单。六、注意事项默认分支已从 master 更名为 main官方指南保留了醒目警告默认分支由master更名为main。若你持有本地克隆仓库需执行git branch -m master main git fetch origin git branch -u origin/main main git remote set-head origin -a七、社区、许可与代码签名参与贡献项目欢迎所有技能级别的贡献者文档翻译可通过 Starship 的 Crowdin 项目提交仓库中的 crowdin.yml 即其配置docs/ 目录下已有 ar-SA、bn-BD、ckb-IR即本文对应目录、zh-CN、zh-TW 等十余种语言版本。贡献规范见 CONTRIBUTING.md灵感来源指南致谢了三个早期项目——denysdovhan 的 spaceship-promptZSH 提示符、denysdovhan 的 robbyrussell-nodeJS 版跨 Shell robbyrussell 主题、reujab/silver跨 Shell 的 powerline 风格提示符代码签名发布二进制由 SignPath.io 提供免费代码签名证书来自 SignPath FoundationReviewer 为 Astronauts 团队Approver/Author 为 Mission Control 团队声明该程序不会向任何网络系统传输信息除非用户显式要求许可Copyright © 2019-present, Starship ContributorsLICENSE 为 ISC 许可。八、小结环节命令/位置依据前置字体终端启用 Nerd Font指南“Prerequisites”节一键安装Linux/macOScurl -sS https://starship.rs/install.sh \| shdocs/public/install.sh从源码安装cargo install starship --locked需 Rust ≥ 1.95Cargo.tomlBash/Zsh 集成eval $(starship init shell)追加至 rc 文件src/init/mod.rs查看可用模块starship module listsrc/main.rs应用预设starship preset name -o ~/.config/starship.tomldocs/public/presets/toml/深度配置参照 docs/config/README.md配置文档按照“装字体 → 装二进制 → 配 Shell → 调配置”四步走任意平台都能在几分钟内得到一个信息密度高、跨 Shell 一致的提示符而starship init的两阶段 stub/脚本设计与按 Shell 定制的路径转义则是理解 Starship 为何能在 bash 3.2 到 Nushell v0.96 的跨度内保持“一行配置”体验的关键源码证据。【免费下载链接】starship☄️ The minimal, blazing-fast, and infinitely customizable prompt for any shell!项目地址: https://gitcode.com/GitHub_Trending/st/starship创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Starship 跨 Shell 提示符实战指南：全平台安装、Shell 集成与 init 初始化原理剖析
Starship 跨 Shell 提示符实战指南全平台安装、Shell 集成与 init 初始化原理剖析【免费下载链接】starship☄️ The minimal, blazing-fast, and infinitely customizable prompt for any shell!项目地址: https://gitcode.com/GitHub_Trending/st/starship本文基于 Starship 仓库官方指南docs/ckb-IR/guide/README.md对应英文源文档整理成文覆盖其完整落地链路安装前置条件Nerd Font、Android/BSD/Linux/macOS/Windows 五大平台的包管理器安装矩阵、官方一键安装脚本install.sh的底层工作机制以及十个 ShellBash、Zsh、Fish、PowerShell、Elvish、Tcsh、Xonsh、Nushell、Ion、Cmd的集成配置。读完本文你可以从零在任意操作系统上完成 Starship 的安装与 Shell 接管并从源码层面理解starship init两阶段初始化、路径转义与--print-full-init的调用关系。一、Starship 是什么Starship 的自我定位是minimal, blazing-fast, and infinitely customizable prompt for any shell——一个极简、极快且可无限定制的跨 Shell 提示符工具。官方指南列出的核心特性Fast速度是其第一卖点really reallyfastCustomizable提示符的每一个方面都可以配置Universal任意 Shell、任意操作系统均可运行Intelligent根据当前目录/环境智能显示相关信息Feature rich内置对大量开发工具的探测支持git、rust、python、node 等见 src/configs/ 目录下的模块定义Easy几分钟即可完成安装。当前仓库版本为 1.26.0见 Cargo.toml构建要求 Rust ≥ 1.95Cargo.toml 中注明 MSRV 仅为提示官方仅支持最新 Rust 版本项目采用 ISC 许可证。二、前置条件安装并启用 Nerd Font在配置 Shell 之前官方指南明确要求终端中已安装并启用一款 Nerd Font指南以 FiraCode Nerd Font 为例。Starship 的默认提示符使用大量 Nerd Font 图标git 分支符号、语言版本图标等。若未安装 Nerd Font图标会显示为方块乱码。仓库为此提供了无图标方案预置配置no-nerd-font与plain-text-symbols对应 docs/public/presets/toml/no-nerd-font.toml且 docs/public/nerd-font.woff2 是文档站点为展示页面内嵌下载的字体文件。如果你不想折腾终端字体可以先用no-nerd-font预设过渡见第五节。三、Step 1安装 Starship3.1 官方一键脚本Linux / macOS / BSD / Git-Bash指南给出的最快安装方式是一行命令curl -sS https://starship.rs/install.sh | sh该脚本在仓库中即 docs/public/install.sh与 install/install.sh 完全一致diff结果相同前者是发布到站点供curl | sh使用的镜像。阅读源码可以发现几个值得注意的设计1. 强制 POSIX Shell 执行。脚本开头定义了verify_shell_is_posix_or_exit()docs/public/install.sh检测到在 zsh 或非 POSIX 模式的 bash 下运行会直接报错退出要求改用sh执行——这正是指南中命令统一写成| sh的原因。2. 目标平台白名单。脚本只下载预编译二进制支持的构建目标为docs/public/install.shx86_64-unknown-linux-gnu / x86_64-unknown-linux-musl i686-unknown-linux-musl / aarch64-unknown-linux-musl arm-unknown-linux-musleabihf x86_64-apple-darwin / aarch64-apple-darwin x86_64-pc-windows-msvc / i686-pc-windows-msvc / aarch64-pc-windows-msvc x86_64-unknown-freebsd riscv64gc-unknown-linux-musl3. 平台与架构自动探测。detect_platform()L217 起将uname -s的结果映射为 target 平台Linux 一律选用unknown-linux-musl静态链接版以避免 glibc 链接问题MSYS/Cygwin/MingwGit Bash统一映射为pc-windows-msvcdetect_arch()L239 起将amd64/armv*/arm64/riscv64规范化并用getconf LONG_BIT二次校验防止 32 位系统被误报为 64 位。4. 下载与提权策略。download()优先使用 curl并显式检测 snap 版 curl 的已知缺陷回退到 wget / fetchinstall()先通过test_writable试探 bin 目录是否可写不可写才通过sudo提权避免不必要的 root 安装。5. 完整命令行选项脚本usage()中定义选项作用-V, --verbose输出详细下载/解压日志-f, -y, --force, --yes跳过安装确认提示-p, --platform覆盖自动探测的平台-b, --bin-dir覆盖二进制安装目录-a, --arch覆盖自动探测的架构-B, --base-url覆盖 release 下载基址私有镜像场景-v, --version安装指定版本形如v1.2.3注意必须带v前缀3.2 各平台包管理器安装矩阵指南按操作系统给出了完整的包管理器对照表此处完整继承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 Packagesapk add starshipArch / ManjaroArch Extrapacman -S starshipCentOS 7 / Fedora 40Coprdnf copr enable atim/starship后dnf install starshipDebian 13 / Ubuntu 25.04官方仓库apt install starshipGentooGentoo Packagesemerge app-shells/starshipNixOSnixpkgsnix-env -iA nixpkgs.starshipopenSUSEOSSzypper in starshipVoid LinuxVoid Packagesxbps-install -S starshipmacOS仓库命令crates.iocargo install starship --lockedconda-forgeconda install -c conda-forge starshipHomebrewbrew install starshipMacPortsport install starshipWindows除 MSI 安装器随 release 发布外仓库命令crates.iocargo install starship --lockedChocolateychoco install starshipconda-forgeconda install -c conda-forge starshipScoopscoop install starshipwingetwinget install --id Starship.Starship使用cargo install starship --locked时请确认本机 Rust 工具链可用--locked保证依赖锁定文件生效构建产物与官方发布一致。四、Step 2让 Shell 使用 Starship安装完成后需要在各 Shell 的启动文件中加载 Starship。指南支持以下 10 种 Shell配置片段完整继承如下。4.1 各 Shell 的集成配置Bash—— 追加到~/.bashrc末尾eval $(starship init bash)Zsh—— 追加到~/.zshrc末尾eval $(starship init zsh)Fish—— 追加到~/.config/fish/config.fish末尾starship init fish | sourcePowerShell—— 追加到 PowerShell 配置文件运行$PROFILE查看路径末尾Invoke-Expression (starship init powershell)Elvish—— 追加到~/.config/elvish/rc.elvWindows 下为%AppData%\elvish\rc.elv末尾eval (starship init elvish)注意仅支持 Elvish v0.18v0.21.0 之前的版本配置文件可能是~/.elvish/rc.elv。Tcsh—— 追加到~/.tcshrc末尾eval starship init tcshXonsh—— 追加到~/.xonshrc末尾execx($(starship init xonsh))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。Ion—— 追加到~/.config/ion/initrc末尾eval $(starship init ion)CmdWindows 命令提示符—— 需要借助 Clinkv1.2.30在%LocalAppData%\clink\starship.lua创建文件内容为load(io.popen(starship init cmd):read(*a))()4.2 源码解析starship init的两阶段初始化为什么各 Shell 的写法如此不统一eval/source/execx/Invoke-Expression答案在 src/init/mod.rs 中。入口命令定义。Init子命令在 src/main.rs 中定义接收 shell 名与一个关键开关--print-full-init/// Prints the shell function used to execute starship Init { shell: String, #[clap(long)] print_full_init: bool, }两阶段设计。init_stub()src/init/mod.rs负责打印给 Shell 的“引导桩代码”init_main()L219 起在--print-full-init时打印完整初始化脚本。文件头部的注释解释了动机直接eval一段未加引号的脚本会被压成单行求值注释会吞掉整行、需到处加分号因此采用source 进程替换的两阶段方案使 init 脚本可以正常注释与调试。以 Bash 为例stub 实际输出L165为eval -- $(starship init bash --print-full-init)这段注释还记录了历史坑位macOS 默认 bash 3.2 不支持source (...)进程替换/dev/stdin技巧又与 Git Bash、Termux 的模拟 POSIX 环境不兼容最终eval -- $(...)写法从 bash 3.2 到最新版、含 POSIX 模式全兼容。二进制路径的 Shell 感知转义。init 脚本模板中的::STARSHIP::占位符会被替换为 starship 二进制的真实路径print_script()L242 起且路径转义按 Shell 定制StarshipPathL23 起sprint()POSIX 风格shell_words::quote引号处理sprint_posix()Windows 上额外调用cygpath将路径转换为 Unix 风格找不到cygpath时静默回退即非 Cygwin 环境sprint_pwsh()PowerShell 单引号包裹并将内部转义为sprint_elv()Elvish 前缀e:强制解释为可执行路径顺带规避E:\...盘符路径歧义sprint_cmdexe()CMD 双引号包裹。这些转义逻辑均有单元测试覆盖src/init/mod.rs如含空格的C:\Cool Tools\starship.exe用例。各 Shell 的完整 init 脚本以include_str!内嵌在二进制中starship.bash/starship.zsh/starship.fish/starship.ps1/starship.ion/starship.elv/starship.tcsh/starship.nu/starship.xsh/starship.luasrc/init/ 目录对应CMDEXE_INIT等常量L262-L280。init 脚本的工程细节。文件末尾的注释L247 起补充了一个性能考量--jobs参数带引号传入是因为 macOS 的wc输出会带空白因此把去空白的工作放到 Rust 端完成避免每次绘制 Shell 时多 fork 一个子进程——这也呼应了 Starship “快”的设计目标。4.3 验证安装开启一个新的 Shell 实例应当能看到 Starship 提示符。从 src/test/ 目录可见仓库用fixtures/下的测试包与jj_tester.rs等测试工具对提示符行为做集成验证本地快速自检可以直接在 Shell 中运行starship module list或starship explainexplain子命令用于解释当前提示符中各模块的显示原因见 src/main.rs。五、Step 3配置 Starship若默认提示符已满足需求到此即可。官方指南将深度定制分成两条路径对应仓库中的本地文档Configuration如何把提示符调整到你喜欢的一切细节参见 docs/config/README.md配置项总览、模块级参数如format、style、disabled等Presets从他人预构建的配置中获得灵感参见 docs/presets/README.md。仓库内预置了 12 份可直接取用的预设配置位于 docs/public/presets/toml/预设文件定位bracketed-segmentsbracketed-segments.toml方括号分段风格catppuccin-powerlinecatppuccin-powerline.tomlCatppuccin 配色 Powerlinegruvbox-rainbowgruvbox-rainbow.tomlGruvbox 彩虹配色jetpackjetpack.toml深色 Jetpack 风格nerd-font-symbolsnerd-font-symbols.toml全套 Nerd Font 符号no-empty-iconsno-empty-icons.toml隐藏空图标no-nerd-fontno-nerd-font.toml无 Nerd Font 环境替代方案no-runtime-versionsno-runtime-versions.toml不显示语言运行时版本pastel-powerlinepastel-powerline.toml柔和色 Powerlineplain-text-symbolsplain-text-symbols.toml纯文本符号pure-presetpure-preset.tomlPure 风格简洁提示符tokyo-nighttokyo-night.tomlTokyo Night 配色获取预设的方式是运行starship preset 名称并写入配置文件——Preset子命令src/main.rs支持--list列出全部预设名、-o/--output输出到文件、-f/--force覆盖已有文件这些预设正是从docs/public/presets/toml/内嵌进二进制的见 Cargo.toml 的include清单。六、注意事项默认分支已从 master 更名为 main官方指南保留了醒目警告默认分支由master更名为main。若你持有本地克隆仓库需执行git branch -m master main git fetch origin git branch -u origin/main main git remote set-head origin -a七、社区、许可与代码签名参与贡献项目欢迎所有技能级别的贡献者文档翻译可通过 Starship 的 Crowdin 项目提交仓库中的 crowdin.yml 即其配置docs/ 目录下已有 ar-SA、bn-BD、ckb-IR即本文对应目录、zh-CN、zh-TW 等十余种语言版本。贡献规范见 CONTRIBUTING.md灵感来源指南致谢了三个早期项目——denysdovhan 的 spaceship-promptZSH 提示符、denysdovhan 的 robbyrussell-nodeJS 版跨 Shell robbyrussell 主题、reujab/silver跨 Shell 的 powerline 风格提示符代码签名发布二进制由 SignPath.io 提供免费代码签名证书来自 SignPath FoundationReviewer 为 Astronauts 团队Approver/Author 为 Mission Control 团队声明该程序不会向任何网络系统传输信息除非用户显式要求许可Copyright © 2019-present, Starship ContributorsLICENSE 为 ISC 许可。八、小结环节命令/位置依据前置字体终端启用 Nerd Font指南“Prerequisites”节一键安装Linux/macOScurl -sS https://starship.rs/install.sh \| shdocs/public/install.sh从源码安装cargo install starship --locked需 Rust ≥ 1.95Cargo.tomlBash/Zsh 集成eval $(starship init shell)追加至 rc 文件src/init/mod.rs查看可用模块starship module listsrc/main.rs应用预设starship preset name -o ~/.config/starship.tomldocs/public/presets/toml/深度配置参照 docs/config/README.md配置文档按照“装字体 → 装二进制 → 配 Shell → 调配置”四步走任意平台都能在几分钟内得到一个信息密度高、跨 Shell 一致的提示符而starship init的两阶段 stub/脚本设计与按 Shell 定制的路径转义则是理解 Starship 为何能在 bash 3.2 到 Nushell v0.96 的跨度内保持“一行配置”体验的关键源码证据。【免费下载链接】starship☄️ The minimal, blazing-fast, and infinitely customizable prompt for any shell!项目地址: https://gitcode.com/GitHub_Trending/st/starship创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考