Starship 跨 Shell 提示符的安装与 Shell 初始化配置指南以官方德语首页文档为基础【免费下载链接】starship☄️ The minimal, blazing-fast, and infinitely customizable prompt for any shell!项目地址: https://gitcode.com/GitHub_Trending/st/starshipStarship 是一个用 Rust 编写、可在任意 Shell 中运行的极简命令行提示符其定位是最小化、极致快速、无限可定制原文标语Der minimalistische, super schnelle und unendlich anpassbare Prompt für jede Shell。本指南以仓库内 docs/de-DE/README.md德语官方首页/快速上手为骨架逐条还原其安装与初始化步骤并结合仓库源码说明每条配置背后的执行原理。读完本文你将掌握如何安装 starship 二进制、如何为 Bash / Fish / Zsh / PowerShell / Ion / Elvish / Tcsh / Nushell / Xonsh / Cmd 等主流 Shell 注入初始化脚本以及安装完成后配置文件starship.toml放在哪里、如何开启第一次定制。前置条件Nerd Font 字体Starship 提示符默认依赖图标字形例如分支符号、状态符号等来渲染信息因此官方文档要求先安装一款Nerd Font并在终端中启用它否则提示符中的图标可能会显示为乱码方框。选择任意一款 Nerd Font 后需要在终端模拟器的字体设置中将其设为默认字体并重启终端会话使其生效。从源码结构看这一设计也体现在各 Shell 的初始化脚本与预置方案中仓库中 presets 下的nerd-font、no-nerd-font与bracketed-segments等预设即围绕是否使用 Nerd Font 图标 / 是否使用圆角括号段这一主题展开若终端环境无法安装 Nerd Font可在后续配置阶段切换到不使用图标的预设。快速安装两种主流途径方式一官方安装脚本Shell 一键安装在任何类 Unix 环境Linux、macOS 等的终端中执行curl -sS https://starship.rs/install.sh | sh这条命令会下载官方install.sh脚本并通过sh执行。仓库内保留了该脚本的实现副本 install/install.sh从中可以看到它的实际行为细节脚本用set -eu开启严格模式并校验调用方式它要求使用 POSIX 兼容的sh而非zsh或非 POSIX 模式的bash执行否则直接报错退出下载环节依次探测curl避开 snap 安装的 curl、wget、fetch并支持通过环境变量指定版本与安装目录如VERSION、安装路径参数内置的SUPPORTED_TARGETS列出了 x86_64 / aarch64 Linux、macOS、Windows 等预编译目标平台升级方式要更新 Starship 本身只需再次执行上面这条脚本即可。官方文档特别说明升级会用新版本替换现有二进制不会触碰你的 Starship 配置Die vorhandene Version wird ersetzt, ohne dass deine Starship-Konfiguration verloren geht。这得益于配置文件与二进制完全分离的存储设计。若所在系统恰好是 Windows 且希望在 Cmd/PowerShell 中使用类似体验仓库也提供了 install/install.sh 之外的原生安装方式见下文包管理器部分。方式二通过包管理器安装官方首页文档给出了两个典型包管理器示例可直接替换上文的二进制安装macOSHomebrewbrew install starshipWindowsWingetwinget install starship除这两者外德语版 guide 以及英文 docs/guide/README.md 还维护了覆盖 Linuxapt、dnf、pacman 等、BSD、AndroidTermux等更多平台的安装矩阵例如pkg install starshipTermux。无论通过哪种途径安装最终拿到的都是同一个starship可执行程序后续初始化逻辑完全一致。第二步为你的 Shell 接入初始化脚本Starship 的设计思路是提示符渲染完全由starship这一个外部进程完成Shell 侧只负责在每次显示提示符前调用它。因此安装二进制之后第二步是在各 Shell 自己的配置文件末尾追加一段初始化命令。从 src/init/mod.rs 的注释可知这里采用了一种两阶段初始化机制用户在 Shell 配置里写入的那行短命令本质是一个stub引导桩该 stub 调用starship init shell --print-full-init得到真正的完整脚本再通过进程替换 /source/eval等方式交给当前 Shell 执行src/main.rs 中的Commands::Init分支会在带--print-full-init参数时进入init_main否则输出 stub。两阶段方案的直接收益是完整初始化脚本可以多行、可注释、可调试避免了把超长脚本塞进单行eval后注释失灵的兼容性问题同时各语言版本如 bash 3.2 的 macOS 默认环境不支持进程替换都有针对性兜底。初始化正文脚本如 starship.bash、starship.zsh、starship.ps1 等以include_str!方式随二进制编译见 src/init/mod.rs 中const BASH_INIT等声明其中::STARSHIP::占位符会在输出时被替换为 starship 二进制的实际绝对路径。下面按官方文档的编排逐 Shell 给出需要追加到配置文件末尾的内容。Bash在~/.bashrc末尾追加# ~/.bashrc eval $(starship init bash)Bash 是目前唯一在 init 模块中直接走eval -- $(starship init bash --print-full-init)形态的 Shellsrc/init/mod.rs官方注释说明了这套引导在 Bash 3.2最新版本以及 POSIX 模式下均可工作。Fish在~/.config/fish/config.fish末尾追加# ~/.config/fish/config.fish starship init fish | sourceFish 侧对应的引导形态是source (starship init fish --print-full-init | psub)因为它使用自身的psub进程替换语法。Zsh在~/.zshrc末尾追加# ~/.zshrc eval $(starship init zsh)PowerShell在 PowerShell 中执行$PROFILE查看配置文件位置典型路径为 Windows 上的~\Documents\PowerShell\Microsoft.PowerShell_profile.ps1或类 Unix 系统上的~/.config/powershell/Microsoft.PowerShell_profile.ps1然后在该文件末尾追加Invoke-Expression (starship init powershell)对应的引导为Invoke-Expression ( starship init powershell --print-full-init | Out-String)。源码中专门为 PowerShell 提供了单引号转义逻辑sprint_pwsh将路径中的替换为并整体包单引号并有对应单元测试覆盖见 src/init/mod.rs 的escape_pwsh/escape_tick_pwsh测试。Ion在~/.config/ion/initrc末尾追加# ~/.config/ion/initrc eval $(starship init ion)Elvish注意仅支持 elvishv0.18 或更高版本。在~/.config/elvish/rc.elvWindows 为%AppData%\elvish\rc.elv末尾追加对 v0.21.0 之前的 elvish配置文件可能是~/.elvish/rc.elv# ~/.elvish/rc.elv eval (starship init elvish)源码为 Elvish 提供了sprint_elv路径处理给可执行路径加e:前缀强制 elvish 将其视为可执行路径从而规避E:这类盘符开头的路径被误解析。Tcsh在~/.tcshrc末尾追加# ~/.tcshrc eval starship init tcsh提示德语版首页文档在该小节正文误写成~/.bashrc但代码块注释与英文原版均为~/.tcshrc此处以~/.tcshrc为准。Nushell注意官方文档标注此方式未来可能变化且仅支持Nushell v0.96。首先在 Nushell 中执行$nu.config-path定位配置文件目录然后执行以下命令把 starship 初始化脚本安装到 Nushell 的自动加载目录mkdir ($nu.data-dir | path join vendor/autoload) starship init nu | save -f ($nu.data-dir | path join vendor/autoload/starship.nu)Nushell 的初始化走的是独立常量NU_INIT对应 starship.nu并以print_script形式整体输出。Xonsh在~/.xonshrc末尾追加# ~/.xonshrc execx($(starship init xonsh))CmdWindows 命令提示符Cmd 本身没有可执行脚本的机制官方要求搭配Clinkv1.2.30使用。新建一个名为starship.lua的文件写入下述内容并将它放到 Clink 的 Scripts 目录中-- starship.lua load(io.popen(starship init cmd):read(*a))()Cmd 对应的是CMDEXE_INITstarship.lua路径处理使用sprint_cmdexe直接把路径用双引号包裹并同样带有针对含空格路径的转义单测见 src/init/mod.rs 的escape_cmdexe/escape_space_cmdexe测试。支持的 Shell 一览与错误提示从 src/init/mod.rs 的init_stub分支可以看出当前内置初始化脚本的 Shell 集合为bash、elvish、fish、ion、powershell、tcsh、zsh、nu、xonsh、cmd。若传入未知 Shell 名称程序会输出一行错误信息并列出上述受支持列表is not yet supported by starship便于排查配置拼写问题。安装后的验证与首次定制验证提示符是否生效为 Shell 配置文件追加初始化行后需要重新加载配置或重开终端才能看到效果Bash / Zshsource ~/.bashrc或source ~/.zshrc或直接新开终端Fishsource ~/.config/fish/config.fishPowerShell. $PROFILE。若一切正常提示符会立即变为带模块分段的 Starship 风格若图标显示异常请回头检查 Nerd Font 是否安装并启用。配置文件位置与最小示例Starship 的所有外观定制都集中在一个 TOML 文件里。默认配置路径为~/.config/starship.toml可手动创建mkdir -p ~/.config touch ~/.config/starship.toml配置文件的完整说明见 docs/config/README.md其最小示例包含三个层面# Get editor completions based on the config schema $schema https://starship.rs/config-schema.json # Inserts a blank line between shell prompts add_newline true # Replace the ❯ symbol in the prompt with ➜ [character] # The name of the module we are configuring is character success_symbol ➜ # The success_symbol segment is being set to ➜ with the color bold green # Disable the package module, hiding it from the prompt completely [package] disabled true若希望把配置文件放到非默认位置可通过环境变量STARSHIP_CONFIG覆盖见 docs/config/README.md。例如类 Unix Shellexport STARSHIP_CONFIG~/example/non/default/path/starship.tomlPowerShell 中则在$PROFILE里追加$ENV:STARSHIP_CONFIG $HOME\example\non\default\path\starship.toml更快的尝鲜内置预设如果不想从零手写模块配置可以借助仓库维护的官方预设一步到位。在 docs/presets/README.md 中列出了tokyo-night、gruvbox-rainbow、nerd-font、no-nerd-font、plain-text、pure-preset等十多种方案对应可执行的 TOML 文件散落于 presets 目录并在 src/main.rs 中通过starship preset 名称子命令输出。德语版文档目录 docs/de-DE/presets/ 同样提供了这些方案的说明。安装完成后即可直接运行starship preset tokyo-night查看生成的配置内容再将其写入~/.config/starship.toml。常见问题排查要点图标显示为方框 / 乱码优先确认终端字体已切换为 Nerd Font 系列如果坚持使用普通字体可改用 no-nerd-font 之类不依赖图标的预设。运行starship init shell报 not yet supported对照上文列出的十种受支持 Shell 检查拼写或检查starship二进制是否已加入PATH。init 模块在定位自身时优先使用which查找starship失败时回退到std::env::current_exe()见 src/init/mod.rs。追加配置后提示符没变化确认追加行位于对应配置文件.bashrc、.zshrc、config.fish、$PROFILE、initrc、rc.elv、.tcshrc、.xonshrc、Clink 的starship.lua、Nushell 的 autoload末尾并已重新加载配置或重开终端会话。总结围绕 docs/de-DE/README.md 德语官方首页的内容本指南覆盖了 Starship 从安装二进制到注入 Shell 初始化脚本再到创建首个配置文件的完整闭环一条curl | sh或一行包管理器命令即可完成安装随后在各自 Shell 配置文件中追加对应的starship init引导行即可启用所有渲染与图标逻辑由 src/init 中随二进制编译的初始化脚本与 Rust 侧的两阶段引导机制承载。安装完成后把~/.config/starship.toml作为唯一定制入口配合 docs/config/README.md 与 docs/presets/README.md 即可开始打造属于你自己的跨 Shell 提示符。更完整的按系统安装矩阵与进阶说明可继续阅读德语版 快速上手指南。【免费下载链接】starship☄️ The minimal, blazing-fast, and infinitely customizable prompt for any shell!项目地址: https://gitcode.com/GitHub_Trending/st/starship创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Starship 跨 Shell 提示符的安装与 Shell 初始化配置指南（以官方德语首页文档为基础）
Starship 跨 Shell 提示符的安装与 Shell 初始化配置指南以官方德语首页文档为基础【免费下载链接】starship☄️ The minimal, blazing-fast, and infinitely customizable prompt for any shell!项目地址: https://gitcode.com/GitHub_Trending/st/starshipStarship 是一个用 Rust 编写、可在任意 Shell 中运行的极简命令行提示符其定位是最小化、极致快速、无限可定制原文标语Der minimalistische, super schnelle und unendlich anpassbare Prompt für jede Shell。本指南以仓库内 docs/de-DE/README.md德语官方首页/快速上手为骨架逐条还原其安装与初始化步骤并结合仓库源码说明每条配置背后的执行原理。读完本文你将掌握如何安装 starship 二进制、如何为 Bash / Fish / Zsh / PowerShell / Ion / Elvish / Tcsh / Nushell / Xonsh / Cmd 等主流 Shell 注入初始化脚本以及安装完成后配置文件starship.toml放在哪里、如何开启第一次定制。前置条件Nerd Font 字体Starship 提示符默认依赖图标字形例如分支符号、状态符号等来渲染信息因此官方文档要求先安装一款Nerd Font并在终端中启用它否则提示符中的图标可能会显示为乱码方框。选择任意一款 Nerd Font 后需要在终端模拟器的字体设置中将其设为默认字体并重启终端会话使其生效。从源码结构看这一设计也体现在各 Shell 的初始化脚本与预置方案中仓库中 presets 下的nerd-font、no-nerd-font与bracketed-segments等预设即围绕是否使用 Nerd Font 图标 / 是否使用圆角括号段这一主题展开若终端环境无法安装 Nerd Font可在后续配置阶段切换到不使用图标的预设。快速安装两种主流途径方式一官方安装脚本Shell 一键安装在任何类 Unix 环境Linux、macOS 等的终端中执行curl -sS https://starship.rs/install.sh | sh这条命令会下载官方install.sh脚本并通过sh执行。仓库内保留了该脚本的实现副本 install/install.sh从中可以看到它的实际行为细节脚本用set -eu开启严格模式并校验调用方式它要求使用 POSIX 兼容的sh而非zsh或非 POSIX 模式的bash执行否则直接报错退出下载环节依次探测curl避开 snap 安装的 curl、wget、fetch并支持通过环境变量指定版本与安装目录如VERSION、安装路径参数内置的SUPPORTED_TARGETS列出了 x86_64 / aarch64 Linux、macOS、Windows 等预编译目标平台升级方式要更新 Starship 本身只需再次执行上面这条脚本即可。官方文档特别说明升级会用新版本替换现有二进制不会触碰你的 Starship 配置Die vorhandene Version wird ersetzt, ohne dass deine Starship-Konfiguration verloren geht。这得益于配置文件与二进制完全分离的存储设计。若所在系统恰好是 Windows 且希望在 Cmd/PowerShell 中使用类似体验仓库也提供了 install/install.sh 之外的原生安装方式见下文包管理器部分。方式二通过包管理器安装官方首页文档给出了两个典型包管理器示例可直接替换上文的二进制安装macOSHomebrewbrew install starshipWindowsWingetwinget install starship除这两者外德语版 guide 以及英文 docs/guide/README.md 还维护了覆盖 Linuxapt、dnf、pacman 等、BSD、AndroidTermux等更多平台的安装矩阵例如pkg install starshipTermux。无论通过哪种途径安装最终拿到的都是同一个starship可执行程序后续初始化逻辑完全一致。第二步为你的 Shell 接入初始化脚本Starship 的设计思路是提示符渲染完全由starship这一个外部进程完成Shell 侧只负责在每次显示提示符前调用它。因此安装二进制之后第二步是在各 Shell 自己的配置文件末尾追加一段初始化命令。从 src/init/mod.rs 的注释可知这里采用了一种两阶段初始化机制用户在 Shell 配置里写入的那行短命令本质是一个stub引导桩该 stub 调用starship init shell --print-full-init得到真正的完整脚本再通过进程替换 /source/eval等方式交给当前 Shell 执行src/main.rs 中的Commands::Init分支会在带--print-full-init参数时进入init_main否则输出 stub。两阶段方案的直接收益是完整初始化脚本可以多行、可注释、可调试避免了把超长脚本塞进单行eval后注释失灵的兼容性问题同时各语言版本如 bash 3.2 的 macOS 默认环境不支持进程替换都有针对性兜底。初始化正文脚本如 starship.bash、starship.zsh、starship.ps1 等以include_str!方式随二进制编译见 src/init/mod.rs 中const BASH_INIT等声明其中::STARSHIP::占位符会在输出时被替换为 starship 二进制的实际绝对路径。下面按官方文档的编排逐 Shell 给出需要追加到配置文件末尾的内容。Bash在~/.bashrc末尾追加# ~/.bashrc eval $(starship init bash)Bash 是目前唯一在 init 模块中直接走eval -- $(starship init bash --print-full-init)形态的 Shellsrc/init/mod.rs官方注释说明了这套引导在 Bash 3.2最新版本以及 POSIX 模式下均可工作。Fish在~/.config/fish/config.fish末尾追加# ~/.config/fish/config.fish starship init fish | sourceFish 侧对应的引导形态是source (starship init fish --print-full-init | psub)因为它使用自身的psub进程替换语法。Zsh在~/.zshrc末尾追加# ~/.zshrc eval $(starship init zsh)PowerShell在 PowerShell 中执行$PROFILE查看配置文件位置典型路径为 Windows 上的~\Documents\PowerShell\Microsoft.PowerShell_profile.ps1或类 Unix 系统上的~/.config/powershell/Microsoft.PowerShell_profile.ps1然后在该文件末尾追加Invoke-Expression (starship init powershell)对应的引导为Invoke-Expression ( starship init powershell --print-full-init | Out-String)。源码中专门为 PowerShell 提供了单引号转义逻辑sprint_pwsh将路径中的替换为并整体包单引号并有对应单元测试覆盖见 src/init/mod.rs 的escape_pwsh/escape_tick_pwsh测试。Ion在~/.config/ion/initrc末尾追加# ~/.config/ion/initrc eval $(starship init ion)Elvish注意仅支持 elvishv0.18 或更高版本。在~/.config/elvish/rc.elvWindows 为%AppData%\elvish\rc.elv末尾追加对 v0.21.0 之前的 elvish配置文件可能是~/.elvish/rc.elv# ~/.elvish/rc.elv eval (starship init elvish)源码为 Elvish 提供了sprint_elv路径处理给可执行路径加e:前缀强制 elvish 将其视为可执行路径从而规避E:这类盘符开头的路径被误解析。Tcsh在~/.tcshrc末尾追加# ~/.tcshrc eval starship init tcsh提示德语版首页文档在该小节正文误写成~/.bashrc但代码块注释与英文原版均为~/.tcshrc此处以~/.tcshrc为准。Nushell注意官方文档标注此方式未来可能变化且仅支持Nushell v0.96。首先在 Nushell 中执行$nu.config-path定位配置文件目录然后执行以下命令把 starship 初始化脚本安装到 Nushell 的自动加载目录mkdir ($nu.data-dir | path join vendor/autoload) starship init nu | save -f ($nu.data-dir | path join vendor/autoload/starship.nu)Nushell 的初始化走的是独立常量NU_INIT对应 starship.nu并以print_script形式整体输出。Xonsh在~/.xonshrc末尾追加# ~/.xonshrc execx($(starship init xonsh))CmdWindows 命令提示符Cmd 本身没有可执行脚本的机制官方要求搭配Clinkv1.2.30使用。新建一个名为starship.lua的文件写入下述内容并将它放到 Clink 的 Scripts 目录中-- starship.lua load(io.popen(starship init cmd):read(*a))()Cmd 对应的是CMDEXE_INITstarship.lua路径处理使用sprint_cmdexe直接把路径用双引号包裹并同样带有针对含空格路径的转义单测见 src/init/mod.rs 的escape_cmdexe/escape_space_cmdexe测试。支持的 Shell 一览与错误提示从 src/init/mod.rs 的init_stub分支可以看出当前内置初始化脚本的 Shell 集合为bash、elvish、fish、ion、powershell、tcsh、zsh、nu、xonsh、cmd。若传入未知 Shell 名称程序会输出一行错误信息并列出上述受支持列表is not yet supported by starship便于排查配置拼写问题。安装后的验证与首次定制验证提示符是否生效为 Shell 配置文件追加初始化行后需要重新加载配置或重开终端才能看到效果Bash / Zshsource ~/.bashrc或source ~/.zshrc或直接新开终端Fishsource ~/.config/fish/config.fishPowerShell. $PROFILE。若一切正常提示符会立即变为带模块分段的 Starship 风格若图标显示异常请回头检查 Nerd Font 是否安装并启用。配置文件位置与最小示例Starship 的所有外观定制都集中在一个 TOML 文件里。默认配置路径为~/.config/starship.toml可手动创建mkdir -p ~/.config touch ~/.config/starship.toml配置文件的完整说明见 docs/config/README.md其最小示例包含三个层面# Get editor completions based on the config schema $schema https://starship.rs/config-schema.json # Inserts a blank line between shell prompts add_newline true # Replace the ❯ symbol in the prompt with ➜ [character] # The name of the module we are configuring is character success_symbol ➜ # The success_symbol segment is being set to ➜ with the color bold green # Disable the package module, hiding it from the prompt completely [package] disabled true若希望把配置文件放到非默认位置可通过环境变量STARSHIP_CONFIG覆盖见 docs/config/README.md。例如类 Unix Shellexport STARSHIP_CONFIG~/example/non/default/path/starship.tomlPowerShell 中则在$PROFILE里追加$ENV:STARSHIP_CONFIG $HOME\example\non\default\path\starship.toml更快的尝鲜内置预设如果不想从零手写模块配置可以借助仓库维护的官方预设一步到位。在 docs/presets/README.md 中列出了tokyo-night、gruvbox-rainbow、nerd-font、no-nerd-font、plain-text、pure-preset等十多种方案对应可执行的 TOML 文件散落于 presets 目录并在 src/main.rs 中通过starship preset 名称子命令输出。德语版文档目录 docs/de-DE/presets/ 同样提供了这些方案的说明。安装完成后即可直接运行starship preset tokyo-night查看生成的配置内容再将其写入~/.config/starship.toml。常见问题排查要点图标显示为方框 / 乱码优先确认终端字体已切换为 Nerd Font 系列如果坚持使用普通字体可改用 no-nerd-font 之类不依赖图标的预设。运行starship init shell报 not yet supported对照上文列出的十种受支持 Shell 检查拼写或检查starship二进制是否已加入PATH。init 模块在定位自身时优先使用which查找starship失败时回退到std::env::current_exe()见 src/init/mod.rs。追加配置后提示符没变化确认追加行位于对应配置文件.bashrc、.zshrc、config.fish、$PROFILE、initrc、rc.elv、.tcshrc、.xonshrc、Clink 的starship.lua、Nushell 的 autoload末尾并已重新加载配置或重开终端会话。总结围绕 docs/de-DE/README.md 德语官方首页的内容本指南覆盖了 Starship 从安装二进制到注入 Shell 初始化脚本再到创建首个配置文件的完整闭环一条curl | sh或一行包管理器命令即可完成安装随后在各自 Shell 配置文件中追加对应的starship init引导行即可启用所有渲染与图标逻辑由 src/init 中随二进制编译的初始化脚本与 Rust 侧的两阶段引导机制承载。安装完成后把~/.config/starship.toml作为唯一定制入口配合 docs/config/README.md 与 docs/presets/README.md 即可开始打造属于你自己的跨 Shell 提示符。更完整的按系统安装矩阵与进阶说明可继续阅读德语版 快速上手指南。【免费下载链接】starship☄️ The minimal, blazing-fast, and infinitely customizable prompt for any shell!项目地址: https://gitcode.com/GitHub_Trending/st/starship创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考