starship/docs/zh-CN/guide

网站 · 安装 · 配置

                     

轻量级、反应迅速，可定制的高颜值终端！

• 快： 很快 —— 真的真的非常快！ 🚀
• 定制化： 可定制各种各样的提示符。
• 通用： 适用于任何 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	pkgsrc	pkgin install starship

Linux

安装最新版本：

sh -c "$(curl -fsSL https://starship.rs/install.sh)"

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

发行版	软件包来源	指令
任意发行版	crates.io	cargo install starship --locked
任意发行版	conda-forge	conda install -c conda-forge starship
任意发行版	Linuxbrew	brew install starship
任意发行版	Snapcraft	snap install starship
Alpine Linux 3.13+	Alpine Linux Packages	apk add starship
Arch Linux	Arch Linux Community	pacman -S starship
CentOS 7+	Copr	dnf copr enable atim/starship dnf install starship
Fedora 31+	Fedora Packages	dnf install starship
NixOS	nixpkgs	nix-env -iA nixos.starship
Gentoo	Gentoo Packages	emerge app-shells/starship
Manjaro		pacman -S starship
NixOS	nixpkgs	nix-env -iA nixpkgs.starship
Void Linux	Void Linux Packages	xbps-install -S starship

macOS

安装最新版本：

sh -c "$(curl -fsSL https://starship.rs/install.sh)"

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

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

Windows

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

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

步骤 2. 设置你的终端以使用 Starship

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

Bash

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

eval "$(starship init bash)"

Cmd

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

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

Elvish

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

eval (starship init elvish)

注意：仅支持 v0.17 及以上版本的 Elvish

Fish

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

starship init fish | source

Ion

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

eval $(starship init ion)

Nushell

将以下内容添加到您 Nushell 配置文件的末尾(通过运行 config path 来获取配置文件的路径)：

startup = [
  "mkdir ~/.cache/starship",
  "starship init nu | save ~/.cache/starship/init.nu",
  "source ~/.cache/starship/init.nu",
]
prompt = "starship_prompt"

PowerShell

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

Invoke-Expression (&starship init powershell)

Tcsh

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

eval `starship init tcsh`

Xonsh

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

execx($(starship init xonsh))

Zsh

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

eval "$(starship init zsh)"

步骤 3. 配置 StarShip

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

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

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

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

🤝 贡献

我们期待着 所有技能等级 的参与者！ 如果你想让自己参与项目的路径轻松一些，可以先试试某个 good first issue。

如果你熟练掌握某个非英语语言，我们非常感谢任何帮助翻译与同步文档到其他语言的贡献。 如果你想要帮忙，可以在 Starship Crowdin 上参与。

如果你有兴趣贡献 Starship 这个项目，请先看看我们的 贡献指南。 也欢迎加入我们的 Discord 服务器 和大家打个招呼。 👋

💭该项目受以下项目启发

请看看这些之前的项目，他们启发了 Starship 项目。 🙏

• denysdovhan/spaceship-prompt – A ZSH prompt for astronauts.

• denysdovhan/robbyrussell-node – Cross-shell robbyrussell theme written in JavaScript.

• reujab/silver – A cross-shell customizable powerline-like prompt with icons.

📝 License

Copyright © 2019-present, Starship Contributors.
This project is ISC licensed.