安装与设置

相关源文件

• Makefile
• README.md
• font.md
• gitstatus/install

此页面介绍了安装 Powerlevel10k 的各种方法以及使其正常运行所需的初始设置过程。它涵盖了通过各种插件管理器、包管理器或手动安装，以及推荐的字体设置和初始配置。有关核心架构及其组件如何交互的详细信息，请参阅核心架构。

先决条件

在安装 Powerlevel10k 之前，请确保您已安装

1. Zsh（版本 5.1 或更高版本）
2. Git（用于大多数安装方法）
3. 支持 256 种颜色的终端模拟器

安装方法

Powerlevel10k 可以根据您现有的 Zsh 设置和偏好通过多种方法进行安装。

来源： README.md415-550

手动安装

安装 Powerlevel10k 的最简单方法

1. 克隆仓库

2. 将以下行添加到您的 ~/.zshrc 文件中

3. 重启 Zsh（关闭并重新打开您的终端或运行 exec zsh）

来源： README.md435-452

插件管理器安装

Oh My Zsh

1. 将仓库克隆到您的 Oh My Zsh 自定义主题目录

2. 在您的 ~/.zshrc 中设置 ZSH_THEME="powerlevel10k/powerlevel10k"

3. 重启 Zsh

来源： README.md456-466

其他插件管理器

插件管理器	安装命令/配置
Prezto	将 zstyle :prezto:module:prompt theme powerlevel10k 添加到 ~/.zpreztorc 文件中
Zim	将 zmodule romkatv/powerlevel10k --use degit 添加到 ~/.zimrc 文件中并运行 zimfw install
Antibody	将 antibody bundle romkatv/powerlevel10k 添加到 ~/.zshrc 文件中
Antidote	将 romkatv/powerlevel10k 添加到 ~/.zsh_plugins.txt 文件中
Antigen	将 antigen theme romkatv/powerlevel10k 添加到 ~/.zshrc 文件中
Zplug	将 zplug romkatv/powerlevel10k, as:theme, depth:1 添加到 ~/.zshrc 文件中
Zgen	将 zgen load romkatv/powerlevel10k powerlevel10k 添加到 ~/.zshrc 文件中
Zinit	将 zinit ice depth=1; zinit light romkatv/powerlevel10k 添加到 ~/.zshrc 文件中
Zi	将 zi ice depth=1; zi light romkatv/powerlevel10k 添加到 ~/.zshrc 文件中
Zap	将 plug "romkatv/powerlevel10k" 添加到 ~/.zshrc 文件中

来源： README.md468-521

通过包管理器安装

Homebrew (macOS/Linux)

Arch Linux

Alpine Linux

来源： README.md523-545

配置向导

安装 Powerlevel10k 并重启 shell 后，配置向导应在首次运行时自动启动。如果未启动，您可以通过输入以下命令手动启动：

配置向导通过询问您关于偏好和终端能力的问题来帮助您设置提示符。

来源： README.md48-64 README.md554-586

字体安装

Powerlevel10k 可与任何等宽字体配合使用，但当使用带有特殊字形的字体时，其全部功能才能得到释放。推荐的字体是为 Powerlevel10k 打包的 Meslo Nerd Font。

来源： README.md612-617 font.md1-180

推荐字体

为 Powerlevel10k 打包的 Meslo Nerd Font 是 Meslo 的定制版本，增加了 Powerlevel10k 可以用来增强提示符视觉效果的字形和符号。

自动字体安装

如果您使用的是 iTerm2 或 Termux，配置向导可以为您安装推荐的字体

1. 运行 p10k configure
2. 在被问及是否安装 Meslo Nerd Font 时回答 Yes

来源： README.md626-631 font.md11-15

手动字体安装

适用于 iTerm2 和 Termux 以外的终端

1. 下载以下字体文件

   • MesloLGS NF Regular
   • MesloLGS NF Bold
   • MesloLGS NF Italic
   • MesloLGS NF Bold Italic

2. 根据您的操作系统程序安装字体文件

3. 将您的终端配置为使用 MesloLGS NF 字体系列

具体的配置步骤因您的终端而异。完整文档列出了超过 30 种不同终端的配置，包括 iTerm2、Apple Terminal、Windows Terminal、VS Code、GNOME Terminal、Konsole、Alacritty、Kitty 等等。

来源： README.md633-792 font.md18-177

初始设置流程

安装后，您将经历典型的设置流程

来源： README.md26-33 README.md554-586

安装后步骤

安装 Powerlevel10k 并完成配置向导后

1. 向导会创建一个 ~/.p10k.zsh 文件，其中包含您的配置
2. 它还会将代码添加到您的 ~/.zshrc 文件中，以加载此文件
3. 为了实现即时提示符功能，它会在您的 ~/.zshrc 文件顶部添加代码

您可以通过编辑 ~/.p10k.zsh 文件来进一步自定义您的提示符，该文件包含丰富的注释以指导您完成各种选项。

更新 Powerlevel10k

要更新 Powerlevel10k，请使用适用于您安装方法的命令

安装方法	Update 命令
手动	git -C ~/powerlevel10k pull
Oh My Zsh	git -C "${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k" pull
插件管理器	使用插件管理器的更新命令（例如，zinit update）
包管理器	使用包管理器的更新命令（例如，brew update && brew upgrade）

更新后，重启您的 shell（不要使用 source ~/.zshrc）。

来源： README.md853-877

安装故障排除

常见的安装问题及解决方案

1. 配置向导未自动启动：手动运行 p10k configure
2. 配置向导中缺少提示样式：安装推荐的字体
3. 提示符中出现问号或图标缺失：安装推荐的字体并将您的终端配置为使用它
4. 插件管理器冲突：确保您已在插件管理器配置中禁用所有其他主题

对于没有互联网访问的机器，Powerlevel10k 提供了离线安装的详细说明。

来源： README.md934-958

在 Docker 中尝试

如果您想在安装 Powerlevel10k 之前尝试它，您可以使用 Docker

这为您提供了一个已安装 Powerlevel10k 的临时环境，供您进行实验。

来源： README.md797-815