Starship 高级安装指南Chocolatey、Termux、Funtoo 与 Nix 多平台部署实战【免费下载链接】starship☄️ The minimal, blazing-fast, and infinitely customizable prompt for any shell!项目地址: https://gitcode.com/GitHub_Trending/st/starship本篇技术指南以 Starship 仓库的「高级安装」文档docs/vi-VN/installing/README.md为核心讲解如何在 ChocolateyWindows、TermuxAndroid、Funtoo LinuxPortage与 NixNixOS / home-manager等特殊平台上完成 Starship 的安装与初始化同时结合仓库源码剖析starship init的底层机制帮助读者在任意平台上获得一套完整、可复现、可二次配置的跨 Shell 提示符环境。安装 Starship 的两个核心步骤无论使用哪个平台、哪种包管理器安装 Starship 本质上都只需要做两件事获取starship二进制文件把它下载到你的电脑上让它成为可执行命令让 Shell 使用它作为提示符通过修改对应 Shell 的初始化脚本init script将提示符渲染交给 Starship。对绝大多数用户而言docs/guide/README.md主页面上的安装说明即可满足需求。但对于一些更特殊、更小众的平台官方 README 无法逐一收纳因此仓库维护了独立的「高级安装」文档专门覆盖这些社区平台。如果你使用的平台不在其中也可以自行补充——这正是该文档持续演进的方式。从源码角度看第二步的实现位于 src/init/mod.rs 与 src/main.rsCLI 通过starship init shell命令输出一段初始化脚本再由 Shell 在启动时加载。下文会结合源码详细解释这一机制。通用平台快速安装背景铺垫在进入特殊平台之前先回顾主流的安装方式便于对照理解Linux / macOS 通用安装脚本curl -sS https://starship.rs/install.sh | sh仓库内对应的脚本实现在 docs/public/install.sh 与 install/install.sh脚本内部会检测平台目标如x86_64-unknown-linux-gnu、aarch64-apple-darwin、x86_64-pc-windows-msvc等并下载对应预编译产物重复执行该脚本即可完成升级且不会触碰已有配置。crates.io 源码安装cargo install starship --locked需要 Rust 工具链项目rust-version 1.95见 Cargo.toml。各发行版包管理器如apt install starshipDebian 13 / Ubuntu 25.04、pacman -S starshipArch / Manjaro、brew install starshipHomebrew、scoop install starship、winget install --id Starship.Starship等。Windows 还可以直接使用 release 附带的 MSI 安装包。下面进入本文主角高级安装文档覆盖的四类特殊平台。Windows通过 Chocolatey 安装前置要求Chocolatey 是 Windows 上的包管理器。使用前需要先前往 Chocolatey 的官方安装页面按其指引完成安装确保系统中有可用的choco命令。安装命令choco install starship仓库的install/windows/choco/目录下保留着 Chocolatey 打包相关的脚本与清单starship.nuspec及若干.ps1文件说明 Starship 官方持续维护着 Chocolatey 通道的包构建。安装后的 Shell 初始化Windows 注意点Windows 下常见的 Shell 初始化方式如下PowerShell在$PROFILE指向的配置文件中追加Invoke-Expression (starship init powershell)Cmd需要配合 Clinkv1.2.30在%LocalAppData%\clink\下创建starship.lua内容为load(io.popen(starship init cmd):read(*a))()值得一提的是源码对 Windows 路径做了专门处理在 src/init/mod.rs 中PowerShell 使用单引号包裹并转义路径sprint_pwshCmd 使用双引号包裹sprint_cmdexe模块内还有对应的单元测试如escape_pwsh、escape_cmdexe、escape_space_cmdexe来保证含空格、特殊字符的路径也能正确初始化。Android通过 Termux 安装Termux 是 Android 上的终端模拟器与 Linux 环境。在 Termux 中安装 Starship 非常简单pkg install starshippkg是 Termux 的包管理器Starship 已收录进 Termux 官方软件源直接安装即可。安装完成后在 Termux 的 Bash 配置~/.bashrc末尾追加eval $(starship init bash)从源码实现看Bash 的初始化引导经历了多轮兼容性修正早期的source (starship init bash --print-full-init)在 macOS 默认的 Bash 3.2 上因不支持进程替换而失效改用/dev/stdin方案后又在 Git BashWindows与 Termux 这类模拟 POSIX 环境中遇到/dev/stdin不可用的问题最终定稿为在所有 Bash 版本与 POSIX 模式下均可靠的eval -- $(starship init bash --print-full-init)详见 src/init/mod.rs 中的注释。Funtoo Linux通过 Portage 安装Funtoo Linux 是 Gentoo 的一个衍生发行版。在 Funtoo 上Starship 可以通过 Portage 从 core-kit 软件仓库安装emerge app-shells/starshipemerge是 Portage 的包管理命令app-shells/starship是 Starship 在 core-kit 中的软件包名称。安装完成后按你的 Shell 类型追加对应的初始化语句Bash 见上Zsh 见下# ~/.zshrc eval $(starship init zsh)Nix三种安装方式详解Nix 生态提供了三种安装 Starship 的路径覆盖「临时使用」与「声明式管理」两类场景。方式一命令式安装nix-env对于只想临时使用、不写入任何配置文件的用户直接执行nix-env -iA nixos.starship该命令从 nixos 频道安装starship到当前用户环境。需要注意NixOS 用户使用nixos.starship其他使用 nixpkgs 的发行版通常写作nix-env -iA nixpkgs.starship主页面文档即采用后者。方式二单用户声明式安装home-managerhome-manager 是 Nix 生态中管理用户级环境的工具。在home.nix中启用programs.starship模块并把你的配置写入settings{ programs.starship { enable true; # Configuration written to ~/.config/starship.toml settings { # add_newline false; # character { # success_symbol ➜; # error_symbol ➜; # }; # package.disabled true; }; }; }然后执行home-manager switch这段配置揭示了声明式管理的核心优势settings中的内容最终会被写入~/.config/starship.toml也就是说你完全可以在 Nix 声明中完成 Starship 的全部自定义而不必手动维护配置文件。add_newline、character.success_symbol、package.disabled等参数都是 Starship 配置项的真实示例完整的参数体系见 docs/config/README.md。方式三系统级声明式安装NixOS在 NixOS 的configuration.nix中把pkgs.starship加入environment.systemPackages{ pkgs, ... }: { environment.systemPackages with pkgs; [ starship # ...其他系统包 ]; }然后执行sudo nixos-rebuild switch该方式将 Starship 作为系统级软件包安装对所有用户生效个人化的提示符配置仍建议配合 home-manager 或~/.config/starship.toml进行。深入源码starship init 的两阶段初始化机制高级安装文档反复出现的starship init shell语句其底层实现值得展开。在 src/main.rs 中init子命令接受 Shell 名称与--print-full-init参数不带--print-full-init时调用init::init_stub(shell)输出一段简短的引导代码stub带--print-full-init时调用init::init_main(shell)输出完整的初始化脚本。init_stub为什么只输出一行短代码因为直接eval一长串脚本会让注释等结构失效整段被当作单行求值且不利于调试。于是源码采用「两阶段初始化」策略stub 通过source配合进程替换把完整脚本加载进当前 Shell。以 Bash 为例stub 输出的是eval -- $(starship init bash --print-full-init)而完整脚本BASH_INIT等通过include_str!宏在编译期嵌入二进制见 src/init/mod.rs 中的常量定义。各 Shell 的引导方式略有差异fishsource (starship init fish --print-full-init | psub)fish 用psub实现进程替换PowerShellInvoke-Expression ( starship init powershell --print-full-init | Out-String)Zsh / Tcsh / Xonsh同样基于--print-full-init的 eval 模式。初始化时StarshipPath::init()会通过which在PATH中定位 starship 二进制路径并将脚本中的::STARSHIP::占位符替换为真实路径确保即使二进制不在默认位置也能正确加载。安装后的验证与配置完成安装与初始化后打开一个新的 Shell 实例即可看到全新的提示符。如果希望进一步验证与定制验证版本starship --version确认安装成功当前仓库版本为 1.26.0见 Cargo.toml。查看当前生效配置starship print-config输出计算后的配置starship print-config --default输出默认配置。编辑配置starship config key value可快速修改配置项如starship config character.success_symbol ➜starship toggle module可开关某个模块。应用预设starship preset 名称可输出社区预设配置如tokyo-night、gruvbox-rainbow等配合--output写入配置文件完整的预设清单见 docs/presets/README.md 与 docs/public/presets/。手工配置直接编辑~/.config/starship.tomlWindows 为%USERPROFILE%\.config\starship.toml所有配置项说明见 docs/config/README.md。小结Starship 的高级安装文档覆盖了 Chocolatey、Termux、Funtoo Linux 与 Nix 四类特殊平台的完整部署路径Windows 用户通过choco install starship一键安装Android 用户通过 Termux 的pkg install starship获得支持Funtoo 用户通过emerge app-shells/starship纳入 Portage 管理Nix 用户则拥有命令式nix-env、用户级声明式home-manager与系统级声明式NixOS三种选择。配合 src/init/mod.rs 中两阶段初始化机制的理解无论平台与 Shell 如何组合都能快速获得一个可定制、可维护的现代化提示符环境。【免费下载链接】starship☄️ The minimal, blazing-fast, and infinitely customizable prompt for any shell!项目地址: https://gitcode.com/GitHub_Trending/st/starship创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Starship 高级安装指南：Chocolatey、Termux、Funtoo 与 Nix 多平台部署实战
Starship 高级安装指南Chocolatey、Termux、Funtoo 与 Nix 多平台部署实战【免费下载链接】starship☄️ The minimal, blazing-fast, and infinitely customizable prompt for any shell!项目地址: https://gitcode.com/GitHub_Trending/st/starship本篇技术指南以 Starship 仓库的「高级安装」文档docs/vi-VN/installing/README.md为核心讲解如何在 ChocolateyWindows、TermuxAndroid、Funtoo LinuxPortage与 NixNixOS / home-manager等特殊平台上完成 Starship 的安装与初始化同时结合仓库源码剖析starship init的底层机制帮助读者在任意平台上获得一套完整、可复现、可二次配置的跨 Shell 提示符环境。安装 Starship 的两个核心步骤无论使用哪个平台、哪种包管理器安装 Starship 本质上都只需要做两件事获取starship二进制文件把它下载到你的电脑上让它成为可执行命令让 Shell 使用它作为提示符通过修改对应 Shell 的初始化脚本init script将提示符渲染交给 Starship。对绝大多数用户而言docs/guide/README.md主页面上的安装说明即可满足需求。但对于一些更特殊、更小众的平台官方 README 无法逐一收纳因此仓库维护了独立的「高级安装」文档专门覆盖这些社区平台。如果你使用的平台不在其中也可以自行补充——这正是该文档持续演进的方式。从源码角度看第二步的实现位于 src/init/mod.rs 与 src/main.rsCLI 通过starship init shell命令输出一段初始化脚本再由 Shell 在启动时加载。下文会结合源码详细解释这一机制。通用平台快速安装背景铺垫在进入特殊平台之前先回顾主流的安装方式便于对照理解Linux / macOS 通用安装脚本curl -sS https://starship.rs/install.sh | sh仓库内对应的脚本实现在 docs/public/install.sh 与 install/install.sh脚本内部会检测平台目标如x86_64-unknown-linux-gnu、aarch64-apple-darwin、x86_64-pc-windows-msvc等并下载对应预编译产物重复执行该脚本即可完成升级且不会触碰已有配置。crates.io 源码安装cargo install starship --locked需要 Rust 工具链项目rust-version 1.95见 Cargo.toml。各发行版包管理器如apt install starshipDebian 13 / Ubuntu 25.04、pacman -S starshipArch / Manjaro、brew install starshipHomebrew、scoop install starship、winget install --id Starship.Starship等。Windows 还可以直接使用 release 附带的 MSI 安装包。下面进入本文主角高级安装文档覆盖的四类特殊平台。Windows通过 Chocolatey 安装前置要求Chocolatey 是 Windows 上的包管理器。使用前需要先前往 Chocolatey 的官方安装页面按其指引完成安装确保系统中有可用的choco命令。安装命令choco install starship仓库的install/windows/choco/目录下保留着 Chocolatey 打包相关的脚本与清单starship.nuspec及若干.ps1文件说明 Starship 官方持续维护着 Chocolatey 通道的包构建。安装后的 Shell 初始化Windows 注意点Windows 下常见的 Shell 初始化方式如下PowerShell在$PROFILE指向的配置文件中追加Invoke-Expression (starship init powershell)Cmd需要配合 Clinkv1.2.30在%LocalAppData%\clink\下创建starship.lua内容为load(io.popen(starship init cmd):read(*a))()值得一提的是源码对 Windows 路径做了专门处理在 src/init/mod.rs 中PowerShell 使用单引号包裹并转义路径sprint_pwshCmd 使用双引号包裹sprint_cmdexe模块内还有对应的单元测试如escape_pwsh、escape_cmdexe、escape_space_cmdexe来保证含空格、特殊字符的路径也能正确初始化。Android通过 Termux 安装Termux 是 Android 上的终端模拟器与 Linux 环境。在 Termux 中安装 Starship 非常简单pkg install starshippkg是 Termux 的包管理器Starship 已收录进 Termux 官方软件源直接安装即可。安装完成后在 Termux 的 Bash 配置~/.bashrc末尾追加eval $(starship init bash)从源码实现看Bash 的初始化引导经历了多轮兼容性修正早期的source (starship init bash --print-full-init)在 macOS 默认的 Bash 3.2 上因不支持进程替换而失效改用/dev/stdin方案后又在 Git BashWindows与 Termux 这类模拟 POSIX 环境中遇到/dev/stdin不可用的问题最终定稿为在所有 Bash 版本与 POSIX 模式下均可靠的eval -- $(starship init bash --print-full-init)详见 src/init/mod.rs 中的注释。Funtoo Linux通过 Portage 安装Funtoo Linux 是 Gentoo 的一个衍生发行版。在 Funtoo 上Starship 可以通过 Portage 从 core-kit 软件仓库安装emerge app-shells/starshipemerge是 Portage 的包管理命令app-shells/starship是 Starship 在 core-kit 中的软件包名称。安装完成后按你的 Shell 类型追加对应的初始化语句Bash 见上Zsh 见下# ~/.zshrc eval $(starship init zsh)Nix三种安装方式详解Nix 生态提供了三种安装 Starship 的路径覆盖「临时使用」与「声明式管理」两类场景。方式一命令式安装nix-env对于只想临时使用、不写入任何配置文件的用户直接执行nix-env -iA nixos.starship该命令从 nixos 频道安装starship到当前用户环境。需要注意NixOS 用户使用nixos.starship其他使用 nixpkgs 的发行版通常写作nix-env -iA nixpkgs.starship主页面文档即采用后者。方式二单用户声明式安装home-managerhome-manager 是 Nix 生态中管理用户级环境的工具。在home.nix中启用programs.starship模块并把你的配置写入settings{ programs.starship { enable true; # Configuration written to ~/.config/starship.toml settings { # add_newline false; # character { # success_symbol ➜; # error_symbol ➜; # }; # package.disabled true; }; }; }然后执行home-manager switch这段配置揭示了声明式管理的核心优势settings中的内容最终会被写入~/.config/starship.toml也就是说你完全可以在 Nix 声明中完成 Starship 的全部自定义而不必手动维护配置文件。add_newline、character.success_symbol、package.disabled等参数都是 Starship 配置项的真实示例完整的参数体系见 docs/config/README.md。方式三系统级声明式安装NixOS在 NixOS 的configuration.nix中把pkgs.starship加入environment.systemPackages{ pkgs, ... }: { environment.systemPackages with pkgs; [ starship # ...其他系统包 ]; }然后执行sudo nixos-rebuild switch该方式将 Starship 作为系统级软件包安装对所有用户生效个人化的提示符配置仍建议配合 home-manager 或~/.config/starship.toml进行。深入源码starship init 的两阶段初始化机制高级安装文档反复出现的starship init shell语句其底层实现值得展开。在 src/main.rs 中init子命令接受 Shell 名称与--print-full-init参数不带--print-full-init时调用init::init_stub(shell)输出一段简短的引导代码stub带--print-full-init时调用init::init_main(shell)输出完整的初始化脚本。init_stub为什么只输出一行短代码因为直接eval一长串脚本会让注释等结构失效整段被当作单行求值且不利于调试。于是源码采用「两阶段初始化」策略stub 通过source配合进程替换把完整脚本加载进当前 Shell。以 Bash 为例stub 输出的是eval -- $(starship init bash --print-full-init)而完整脚本BASH_INIT等通过include_str!宏在编译期嵌入二进制见 src/init/mod.rs 中的常量定义。各 Shell 的引导方式略有差异fishsource (starship init fish --print-full-init | psub)fish 用psub实现进程替换PowerShellInvoke-Expression ( starship init powershell --print-full-init | Out-String)Zsh / Tcsh / Xonsh同样基于--print-full-init的 eval 模式。初始化时StarshipPath::init()会通过which在PATH中定位 starship 二进制路径并将脚本中的::STARSHIP::占位符替换为真实路径确保即使二进制不在默认位置也能正确加载。安装后的验证与配置完成安装与初始化后打开一个新的 Shell 实例即可看到全新的提示符。如果希望进一步验证与定制验证版本starship --version确认安装成功当前仓库版本为 1.26.0见 Cargo.toml。查看当前生效配置starship print-config输出计算后的配置starship print-config --default输出默认配置。编辑配置starship config key value可快速修改配置项如starship config character.success_symbol ➜starship toggle module可开关某个模块。应用预设starship preset 名称可输出社区预设配置如tokyo-night、gruvbox-rainbow等配合--output写入配置文件完整的预设清单见 docs/presets/README.md 与 docs/public/presets/。手工配置直接编辑~/.config/starship.tomlWindows 为%USERPROFILE%\.config\starship.toml所有配置项说明见 docs/config/README.md。小结Starship 的高级安装文档覆盖了 Chocolatey、Termux、Funtoo Linux 与 Nix 四类特殊平台的完整部署路径Windows 用户通过choco install starship一键安装Android 用户通过 Termux 的pkg install starship获得支持Funtoo 用户通过emerge app-shells/starship纳入 Portage 管理Nix 用户则拥有命令式nix-env、用户级声明式home-manager与系统级声明式NixOS三种选择。配合 src/init/mod.rs 中两阶段初始化机制的理解无论平台与 Shell 如何组合都能快速获得一个可定制、可维护的现代化提示符环境。【免费下载链接】starship☄️ The minimal, blazing-fast, and infinitely customizable prompt for any shell!项目地址: https://gitcode.com/GitHub_Trending/st/starship创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考