Starship 高级安装指南：Chocolatey、Termux、Funtoo Linux 与 Nix 平台实战

Starship 高级安装指南：Chocolatey、Termux、Funtoo Linux 与 Nix 平台实战

【免费下载链接】starship ☄🌌️ The minimal, blazing-fast, and infinitely customizable prompt for any shell! 项目地址: https://gitcode.com/GitHub_Trending/st/starship

安装 Starship 本质上只需要完成两件事：把 starship 二进制文件放到你的电脑上，然后修改对应 shell 的初始化脚本，让 shell 把提示符交给 starship 渲染。对于绝大多数用户，主安装指南（含 Linux、macOS、Windows、BSD、Android 的全平台步骤）已经足够；但 Chocolatey、Termux、Funtoo Linux、Nix 这类较特殊的平台往往需要额外的指令。读完本文，你将掌握这四类平台的完整安装流程、Nix 声明式配置的两种写法，以及安装后各 shell 的接入方式与验证方法。

安装前的总览：两个必要步骤

无论走哪条安装路径，Starship 的安装逻辑都统一为以下两步（见 docs/tr-TR/installing/README.md）：

1. 获取 starship 二进制文件：通过包管理器、官方安装脚本或直接下载 release 产物，把可执行文件放进系统 PATH。
2. 让 shell 调用 starship：在对应 shell 的初始化脚本末尾追加 starship init <shell> 的求值语句，使每次启动 shell 时 prompt 都由 starship 渲染。

值得注意的是，仓库内自带的 install/install.sh 安装脚本在完成二进制安装后，会在终端打印一份"按 shell 补全配置"的清单：Bash、Zsh、Ion、Tcsh、Xonsh、Fish 等每种 shell 对应哪个配置文件、追加什么命令，脚本末尾的 print_install 函数会逐一给出提示（见 install/install.sh），这与文档"两步安装"的说明完全对应。

主安装指南（docs/guide/README.md）已覆盖主流操作系统，本文只针对以下四类特殊平台展开，如果你的发行版不在这里，可以参照仓库 docs/installing/README.md 的说明自行补充。

Windows：通过 Chocolatey 安装

前置条件

Chocolatey 是 Windows 上的命令行包管理器。在安装 starship 之前，需要先前往 Chocolatey 安装页面，按照官方指引完成 Chocolatey 本身的安装。

安装命令

打开管理员权限的 PowerShell 或命令提示符，执行：

choco install starship

命令执行后，Chocolatey 会从官方源拉取 starship 包并静默安装。从仓库内的打包脚本 install/windows/choco/chocolateyInstall.install.ps1 可以看到，该包实际以 MSI 安装器的形式分发：脚本通过 Install-ChocolateyPackage 调用 fileType = 'msi'，以 /qn /norestart 静默参数完成安装，并对 x86_64 与 i686 两套架构分别传入 URL 与 sha256 校验和。包元数据定义在 starship.nuspec（id 为 starship，标签为 powershell prompt starship pwsh）。

安装完成后，脚本还会提示你向 PowerShell 配置文件追加初始化语句：

Invoke-Expression (&starship init powershell)

关于该行的位置，可以通过在 PowerShell 中执行 $PROFILE 查询配置文件路径。Windows 上典型路径为 ~\Documents\PowerShell\Microsoft.PowerShell_profile.ps1。

Android：通过 Termux 安装

Termux 是 Android 上的终端模拟器与 Linux 环境，包管理基于 apt 的 pkg 前端。安装命令为：

pkg install starship

安装完成后，在 Termux 中按你使用的 shell 类型配置初始化。若使用默认的 Bash：

eval "$(starship init bash)"

将上面一行追加到 ~/.bashrc 末尾并重启 Termux 会话即可生效。需要说明的是，Termux 官方源中的 starship 版本由 Termux 维护者负责同步，可能与最新 release 存在版本差。

Funtoo Linux：通过 Portage 安装

Funtoo Linux 的包管理基于 Gentoo 的 Portage。starship 已被收录在 core-kit 仓库的 app-shells/starship 中，直接执行：

emerge app-shells/starship

即可完成编译安装。由于 Portage 采用源码构建模型，首次 emerge 会依据 USE 标志拉取依赖并编译，耗时取决于机器性能；安装完成后同样需要配置 shell 初始化（如 Bash 追加 eval "$(starship init bash)"）。

Nix：命令式与声明式两种安装方式

Nix 生态提供了两种安装哲学：命令式（imperative）与声明式（declarative）。本文档分别给出了对应方案，下面逐一展开。

命令式安装（Imperative）

在支持 nix 命令的环境中，直接执行：

nix-env -iA nixos.starship

该命令从 nixos channel 的 attrset 中按名字 starship 安装到当前用户环境。注意：attr 路径前缀（nixos 或 nixpkgs）取决于你订阅的 channel 名称。若你的 channel 名为 nixpkgs，应使用主安装指南中的写法 nix-env -iA nixpkgs.starship（见 docs/guide/README.md）。

声明式、单用户：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 switch

这段配置有几点值得说明：

• enable = true 会让 home-manager 自动把 starship init 注入到受管 shell（如 Bash/Zsh）的初始化脚本中，因此无需手动追加初始化语句；
• settings 属性会原样生成 ~/.config/starship.toml 的内容——注释里的 add_newline、character、package 都是真实的 starship 配置键，分别控制"每次命令后是否换行"、"成功/失败提示符符号"与"package 模块是否显示"。完整可配置模块可参阅 docs/config/README.md；
• 切换后若想验证效果，可运行 starship config 或在新的 shell 会话中直接观察 prompt 变化。

声明式、系统级：NixOS

在 NixOS 的 configuration.nix 中，把 pkgs.starship 加入 environment.systemPackages：

{ pkgs, ... }:
{
  environment.systemPackages = with pkgs; [
    starship
    # ... 其他系统包
  ];
}

然后执行：

sudo nixos-rebuild switch

该方案将 starship 以系统级包的形式安装到全局环境；与 home-manager 方案不同，NixOS 系统级安装不会自动改写用户 shell 的初始化脚本，你需要自己在 ~/.bashrc、~/.zshrc 等文件中手动追加 starship init 语句。

安装完成后的通用收尾：shell 接入与验证

无论通过哪种方式安装，安装脚本（install/install.sh）都会在结束时打印各类 shell 的接入指引。以最常见的几种为例：

Shell	配置文件	追加内容
Bash	~/.bashrc	eval "$(starship init bash)"
Zsh	~/.zshrc	eval "$(starship init zsh)"
Fish	~/.config/fish/config.fish	starship init fish \| source
PowerShell	$PROFILE 指向的文件	Invoke-Expression (&starship init powershell)
Nushell (v0.96+)	$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")

配置完成后，启动一个新的 shell 会话即可看到新的 prompt。如果对默认外观满意，直接使用即可；想进一步定制，可阅读配置文档或参考社区预置主题 docs/presets/README.md。另需注意，为了完整渲染图标，建议终端安装并启用 Nerd Font（主指南的前置条件中明确推荐了 FiraCode Nerd Font）。

排错与进阶提示

• 验证二进制是否就位：运行 starship --version 或 starship config，若命令找不到，检查对应包管理器的安装路径是否在 PATH 中；使用 install/install.sh 安装时，脚本会检测 BIN_DIR（默认 /usr/local/bin）是否可写，不可写则借助 sudo 提权（见 install/install.sh）。
• 安装脚本的参数化能力：若你不走包管理器而使用官方脚本，install/install.sh 支持 --version（指定版本，如 v1.2.3）、--bin-dir（指定安装目录）、--platform / --arch（覆盖自动检测的平台与架构）、--yes（跳过确认）等参数，可满足离线或定制化部署需求。
• 文档翻译与补充：本文对应的英文原版位于 docs/installing/README.md，如果你的平台不在上述列表中，可以参照该文档的格式把安装方法补充进对应语言的 docs 目录，方便社区共享。

【免费下载链接】starship ☄🌌️ The minimal, blazing-fast, and infinitely customizable prompt for any shell! 项目地址: https://gitcode.com/GitHub_Trending/st/starship