README.md

网站 · 安装 · 配置

                       

Warning

The default branch has been renamed from master to main. If you have a local clone, update it by running:

git branch -m master main
git fetch origin
git branch -u origin/main main
git remote set-head origin -a

轻量、迅速、客制化的高颜值终端！

• 快： 很快 —— 真的真的非常快！ 🚀 🚀
• 客制化： 可定制各种各样的提示符。
• 通用： 适用于任何 Shell、任何操作系统。
• 智能： 一目了然地显示相关信息。
• 功能丰富： 支持所有你喜欢的工具。
• 易用： 安装快速 —— 几分钟就可上手。

探索 Starship 文档

🚀 安装

前置要求

• 安装并在终端启用 Nerd Font 字体（如 Fira Code Nerd Font ）。

步骤 1. 安装 Starship

从下面的列表中选择您的操作系统以查看安装指令：

Android

使用下列软件包管理器安装Starship：

软件包来源	指令
Termux	pkg install starship

BSD

使用下列软件包管理器安装Starship：

发行版	软件包来源	指令
任意发行版	crates.io	cargo install starship --locked
FreeBSD	FreshPorts	pkg install starship
NetBSD	任意发行版	pkgin install starship

Linux

安装最新版本：

curl -sS https://starship.rs/install.sh | sh

或者，使用以下任一软件包管理器安装Starship：

发行版	软件包来源	指令
任意发行版	任意发行版	cargo install starship --locked
Any	conda-forge	conda install -c conda-forge starship
Any	Linuxbrew	brew install starship
Alpine Linux 3.13+	软件包来源	apk add starship
Arch Linux	Arch Linux Extra	pacman -S starship
CentOS 7+	Copr	dnf copr enable atim/starship dnf install starship
Debian 13+	Debian Main	apt install starship
Fedora 40+	Copr	dnf copr enable atim/starship dnf install starship
Gentoo	软件包来源	emerge app-shells/starship
Manjaro		pacman -S starship
NixOS	nixpkgs	nix-env -iA nixpkgs.starship
openSUSE	OSS	zypper in starship
Ubuntu 25.04+	配置你的终端来初始化 starship。 请从下面列表选择你的终端：	apt install starship
Void Linux	Void Linux Packages	xbps-install -S starship

macOS

安装最新版本：

curl -sS https://starship.rs/install.sh | sh

或者，使用以下任一软件包管理器安装Starship：

软件包来源	指令
crates.io	cargo install starship --locked
conda-forge	conda install -c conda-forge starship
Homebrew	brew install starship
发行版	port install starship

Windows

在 发布页 下载 MSI 包来安装最新版。

使用下列软件包管理器安装Starship：

软件包来源	指令
crates.io	cargo install starship --locked
Chocolatey	choco install starship
Copr	conda install -c conda-forge starship
Scoop	scoop install starship
winget	winget install --id Starship.Starship

步骤 2. 设置您的 shell 以使用 Starship

配置你的终端来初始化 starship。 请从下面列表选择你的终端：

Bash

在 ~/.bashrc 的最后，添加以下内容：

eval "$(starship init bash)"

Cmd

您需要使用 Clink (v1.2.30+) 与 Cmd. 在路径 %LocalAppData%\clink\starship.lua 下创建文件，输入以下内容

load(io.popen('starship init cmd'):read("*a"))()

Elvish

Add the following to the end of ~/.config/elvish/rc.elv (%AppData%\elvish\rc.elv on Windows):

eval (starship init elvish)

注意：仅支持 v0.18 及以上版本的 Elvish. For elvish versions prior to v0.21.0 the config file might instead be ~/.elvish/rc.elv

Fish

在 ~/.config/fish/config.fish 的最后，添加以下内容：

starship init fish | source

Ion

在 ~/.config/ion/initrc 的最后，添加以下内容：

eval $(starship init ion)

Nushell

将以下内容添加到你的 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+

PowerShell

将以下内容添加到您 PowerShell 配置文件的末尾（通过运行 $PROFILE 来获取配置文件的路径）

Invoke-Expression (&starship init powershell)

Tcsh

在 ~/.tcshrc 的最后，添加以下内容：

eval `starship init tcsh`

Xonsh

在 ~/.xonshrc 的最后，添加以下内容：

execx($(starship init xonsh))

Zsh

在 ~/.zshrc 的最后，添加以下内容：

eval "$(starship init zsh)"

步骤 3. 配置 Starship

打开一个新的 Shell 实例，你应该就能看到漂亮的 Shell 新提示符了。 如果你对默认配置感到满意，那么开始使用吧！ 如果你对默认配置感到满意，那么开始使用吧！

如果你想进一步配置 Starship，查阅下列内容：

• 配置：学习如何配置 Starship 来调节提示符到你喜欢的样子。

• 预设：从其他构建好的配置中获取灵感。

🤝 贡献

We are always looking for contributors of all skill levels! 我们欢迎 任何水平 的参与者！ If you're looking to ease your way into the project, try out a good first issue.

如果你精通非英语语言，请协助我们翻译并更新文档，非常感谢！ 如果你精通非英语语言，请协助我们翻译并更新文档，非常感谢！ 你可以在 Starship Crowdin 上参与翻译。

If you are interested in helping contribute to starship, please take a look at our Contributing Guide. Also, feel free to drop into our Discord server and say hi. 👋

💭 该项目受以下项目启发

请查看这些曾经启发了 Starship 的项目。 🙏 🙏

• denysdovhan/spaceship-prompt – 为宇航员准备的 ZSH 提示符。

• denysdovhan/robbyrussell-node – 可用于所有 Shell 的 Robbyrussell 主题，使用 JavaScript 编写。

• reujab/silver – 带图标且可定制的类 Powerline 提示符，适用于所有 Shell。

❤️ 赞助商

通过 成为赞助商 来支持这个项目。 您的名字或 LOGO 将在此处显示，并链接到您的网站。 您的名字或 LOGO 将在此处显示，并链接到您的网站。

🔒 代码签名策略

Free code signing provided by SignPath.io, certificate by SignPath Foundation.

Code Signing Roles:

• Reviewers: Astronauts
• Approvers and Authors: Mission Control

This program will not transfer any information to other networked systems unless specifically requested by the user or the person installing or operating it.

📝 许可证

Copyright © 2019-present, Starship Contributors.
此项目使用 ISC 许可.