ARTICLE DETAIL

建站实战干货

来自一线的建站与推广经验沉淀,每一条都经过真实交付验证。

Starship 高级安装指南:Windows、Termux、Funtoo 与 Nix 平台专项部署

2026/9/10 15:43:09 拓冰建站 浏览量
Starship 高级安装指南:Windows、Termux、Funtoo 与 Nix 平台专项部署 Starship 高级安装指南Windows、Termux、Funtoo 与 Nix 平台专项部署【免费下载链接】starship☄️ The minimal, blazing-fast, and infinitely customizable prompt for any shell!项目地址: https://gitcode.com/GitHub_Trending/st/starshipStarship 是一款用 Rust 编写的跨 shell 极简提示符prompt适用于 bash、zsh、fish、PowerShell 等几乎所有主流 shell。绝大多数用户只需按照主文档的安装章节执行即可但对于 WindowsChocolatey、AndroidTermux、Funtoo Linux 与 Nix 生态等特殊平台需要单独的部署方式。本文以 docs/no-NO/installing/README.md 的进阶安装说明为主线逐平台给出可直接复制的安装命令与配置片段并结合本仓库的安装脚本与源码说明其底层工作原理帮助你在这类平台上顺利跑起 Starship。安装的本质两步走无论使用哪种平台Starship 的安装都只包含两件事把starship可执行文件安装到你的机器上修改对应 shell 的初始化脚本让 shell 启动时加载 starship 作为提示符。对于大多数用户README.md 主文档中的安装步骤即可直接使用而本指南针对的是主文档未覆盖或需要特殊处理的平台这些安装方式大多来自社区维护的包管理器与仓库。仓库根目录的 install.sh 是官方通用安装脚本支持 Linux、macOS、WindowsGit Bash、FreeBSD 等平台可作为对照参考docs/installing/README.md保留了该指南的英文原版本文基于其挪威语译本docs/no-NO/installing/README.md展开两者内容一致。Windows 平台通过 Chocolatey 安装前置条件Chocolatey 是 Windows 上的包管理器。如果尚未安装请先前往 Chocolatey 官网的安装页面按其指引完成安装通常是在管理员 PowerShell 中执行一条安装命令。安装命令以管理员权限打开 PowerShell执行choco install starship该命令会从 Chocolatey 社区源拉取 starship 包并静默安装安装完成后按提示配置 PowerShell profile 即可。仓库源码佐证Chocolatey 包的结构本仓库的 install/windows/choco 目录维护着该包的构建源共 4 个文件starship.nuspec包元数据声明包名starship、作者、版本、标签powershell prompt starship pwsh等并指定把tools目录内容打入包内chocolateyInstall.install.ps1安装脚本通过Install-ChocolateyPackage安装 MSI 包。脚本中值得注意的细节区分 32 位url/checksum与 64 位url64bit/checksum64下载地址并使用sha256校验和验证包完整性静默参数为/qn /norestart可接受退出码0、3010、1641其中 3010/1641 表示成功但需重启安装完成后脚本会提示向 PowerShell profile 追加Invoke-Expression (starship init powershell)chocolateyInstall.portable.ps1便携版安装脚本改用Install-ChocolateyZipPackage下载 zip 压缩包并解压到包工具目录同样是 sha256 校验update.ps1包版本更新脚本。这解释了为什么choco install starship能一步到位包内已经内置了下载、校验、解压/静默安装乃至后续配置提示的完整流程。Android通过 Termux 安装在 Android 上Starship 通过 [Termux] 终端模拟器的包管理器安装pkg install starshipTermux 的软件源中已收录 starship安装后同样需要在 Termux 使用的 shell默认 bash初始化脚本中追加配置。Termux 也被收录在主文档 README.md 的 Android 安装表格中与这里给出的命令一致。Funtoo Linux通过 Portage 安装Funtoo Linux 是 Gentoo 的衍生发行版使用 Portage 包管理系统。Starship 已被收录在 core-kit 的app-shells/starship包中直接 emerge 即可emerge app-shells/starship主文档 README.md 的 Linux 安装表中同样列出了 Gentoo 的emerge app-shells/starship方式Funtoo 与其同源命令完全一致。Nix 生态三种安装方式Nix 用户有三种安装 Starship 的方式命令式安装、通过 home-manager 声明式安装单用户、以及通过 NixOS 系统级声明式安装。命令式安装Imperativenix-env -iA nixos.starship-A指定属性路径nixos.starship直接从 nixpkgs 中安装 starship无需修改任何配置文件适合快速试用。通过 home-manager 声明式安装单用户如果你使用 [home-manager] 管理家目录配置在home.nix中启用programs.starship模块并填写设置{ programs.starship { enable true; # 配置会写入 ~/.config/starship.toml settings { # add_newline false; # character { # success_symbol ➜; # error_symbol ➜; # }; # package.disabled true; }; }; }然后执行home-manager switchsettings中的内容会被 home-manager 渲染成~/.config/starship.toml因此这里直接写 TOML 风格的键值即可。示例中注释掉的character.success_symbol/error_symbol对应仓库 src/configs/character.rs 中字符模块的配置项package.disabled true则对应 src/configs/package.rs 的软件包模块开关——启用模块后你可以在~/.config/starship.toml里继续细化这些配置。通过 NixOS 系统级安装在 NixOS 的configuration.nix中把pkgs.starship加入environment.systemPackages{ pkgs, ... }: { environment.systemPackages with pkgs; [ starship # ... 其他软件包 ]; }然后重新构建系统sudo nixos-rebuild switch这种方式适合多用户系统所有登录用户都能直接使用starship命令。通用安装脚本解析install.sh 的进阶参数若你的发行版不在上述列表可以使用仓库根目录的官方安装脚本 install.shcurl -sS https://starship.rs/install.sh | sh从源码看该脚本实现了完整的平台/架构探测、下载与解压流程并支持以下参数见 install.sh 的usage()函数参数说明默认值-p, --platform覆盖自动探测的平台自动探测-b, --bin-dir覆盖二进制安装目录/usr/local/bin-a, --arch覆盖自动探测的架构自动探测-B, --base-url覆盖发布包下载基址GitHub releases-v, --version安装指定版本如v1.2.3latest-V, --verbose启用详细输出关闭-f, -y, --force, --yes跳过安装确认提示需交互确认-h, --help显示帮助—脚本内置的SUPPORTED_TARGETSinstall.sh列出了官方提供预编译包的平台三元组覆盖 x86_64/aarch64 的 Linuxglibc 与 musl、macOS、WindowsMSVC以及 FreeBSD、riscv64gc 等。几个值得注意的实现细节平台自动探测detect_platform基于uname -s将msys_nt*/cygwin_nt*/mingw*Git Bash识别为pc-windows-msvcLinux 统一使用静态编译的 musl 二进制以避免链接问题架构自动探测detect_arch基于uname -m映射amd64→x86_64、arm64→aarch64等并用getconf LONG_BIT修正 32 位系统误报下载工具选择download依次尝试curl→wget→fetch并专门检测 curl 是否为 snap 安装snap 版 curl 无法正常下载会给出告警并回退权限提升install/elevate_priv目标目录可写则直接安装否则自动使用sudo并先执行sudo -v验证授权包格式Windows 目标下载 zip其余平台下载 tar.gz解压时支持VERBOSE开关输出详细日志安装完成提示print_install脚本结束后会按当前 shell 打印对应的初始化配置方法。安装完成后配置你的 shell无论用哪种方式安装最后一步都是让 shell 启动时初始化 starship。仓库 src/init 目录下提供了各 shell 的初始化脚本实现starship.bash、starship.zsh、starship.fish、starship.ps1等而 install.sh 的print_install()函数会在安装成功后直接给出各 shell 的配置指引汇总如下Shell配置文件初始化命令bash~/.bashrceval $(starship init bash)zsh~/.zshrceval $(starship init zsh)fish~/.config/fish/config.fishstarship init fish \| sourceion~/.config/ion/initrceval $(starship init ion)tcsh~/.tcshrceval starship init tcshxonsh~/.xonshrcexecx($(starship init xonsh))elvish~/.config/elvish/rc.elveval (starship init elvish)需 elvish v0.17nushellnu 配置文件$nu.config-pathmkdir ($nu.data-dir \| path join vendor/autoload)并starship init nu \| save -f ...需 Nushell v0.96PowerShellMicrosoft.PowerShell_profile.ps1Invoke-Expression (starship init powershell)CmdClink 脚本目录下新建starship.luaload(io.popen(starship init cmd):read(*a))()需 Clink v1.2.30其中各 shell 初始化脚本的真实实现都位于 src/init 目录例如 starship.bash、starship.zsh、starship.fish 与 starship.ps1它们由starship init shell命令按需输出并注入当前 shell 会话。小结针对本文覆盖的四类平台安装命令速查如下Windows Chocolateychoco install starship需管理员权限先安装 ChocolateyAndroid Termuxpkg install starshipFuntoo Linuxemerge app-shells/starshipNix命令式nix-env -iA nixos.starshiphome-manager 声明式programs.starship模块NixOS 系统级加入environment.systemPackages。安装完成后统一根据上表向对应 shell 的初始化文件追加starship init shell配置并重开终端即可生效。若你的平台不在这份清单中可以查阅主文档 README.md 的安装章节或使用 install.sh 通用脚本安装仓库内的 docs/installing/README.md 也欢迎社区补充新的平台安装方式。【免费下载链接】starship☄️ The minimal, blazing-fast, and infinitely customizable prompt for any shell!项目地址: https://gitcode.com/GitHub_Trending/st/starship创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考