7485c90c9f
* feat(docs): move to vitepress * change up hero styles to match existing site * A bit more style tweaking * Replace stylus with plain CSS * improve unicode-range value for nerdfont --------- Co-authored-by: Matan Kushner <hello@matchai.dev> |
||
|---|---|---|
| .. | ||
| README.md | ||
常见问题
主页示例图中的效果用的是什么配置？
- 终端模拟器：iTerm2
- 主题：Minimal
- 颜色方案：Snazzy
- 字体：Fira Code Nerd Font
- Shell：Fish Shell
- fish 配置：matchai's Dotfiles
- 提示符工具：Starship
如何实现示例图中自动补全的功能？
命令自动补全功能是由您选择的 Shell 提供。 演示中的自动补全由 Fish Shell 完成，它默认开启自动补全。 若您使用 Z Shell (zsh)，推荐您查看 zsh-autosuggestions。
顶层配置 format 与 <module>.disabled 的功能是相同的吗？
是的，他们都可以用来禁用提示符中的组件。 如果你只是想禁用组件，推荐使用 <module>.disabled，原因如下：
- 在顶层配置
format里忽略组件与禁用组件相比较，后者更加明确 - 当 Starship 升级后，新组件将能够自动被加入提示符中
文档中写 Starship 适用于任何 Shell。 为什么我常用的 Shell 不支持？
Starship 的构建方式决定了它应当能够增加对几乎所有 shell 的支持。 Starship 的二进制文件是无状态、不知道当前 shell 的，所以只要你的 shell 支持自定义提示符和 shell 扩展，就能使用 Starship。
这是一个在 bash 上使用 Starship 的简单例子：
# 获取最后执行命令的返回值
STATUS=$?
# 获取运行后台程序的数量
NUM_JOBS=$(jobs -p | wc -l)
# 设置提示符为 `starship prompt` 的输出
PS1="$(starship prompt --status=$STATUS --jobs=$NUM_JOBS)"
内置于 Starship 的 Bash 适配 稍微复杂一些，实现了像 命令用时统计组件 这样的功能，还确保 Starship 能与之前设置的 Bash 配置相兼容。
使用以下命令了解 starship prompt 所能接受的所有参数：
starship prompt --help
Starship 会处理所提供的全部上下文参数并在提示符中显示，但没有参数是“必需”的。
我如何在 Linux 发行版上使用旧版本 glibc 运行 Starship？
若您在使用预构建的程序时，遇到类似“version 'GLIBC_2.18' not found (required by starship)”的错误（例如在 CentOS 6 或 7 里运行）您可以使用 musl 的编译版本，而非 glibc 版本。
curl -sS https://starship.rs/install.sh | sh -s -- --platform unknown-linux-musl
为什么我会遇到 Executing command "..." timed out. 警告？
Starship 会执行数个不同的命令来获取应该显示的信息，例如某个程序的版本号、现在 Git 的工作树状态。 为保证 Starship 不会在执行某条命令时卡住，Starship 会终止执行时间过长的命令并且输出以上警告。这是正常现象。 若希望增加时长限制，它可以在 command_timeout 设置 处自定义。 您也可以按照下文的调试步骤查看并优化运行慢的命令。 最后，您也可以设置环境变量 STARSHIP_LOG 为 error 来隐藏这些警告。
我不理解某些符号，它们是什么意思？
若您不清楚某些符号，可以使用 starship explain 查看正在显示的组件。
Starship 运行不正常，我该如何调试？
您可以使用环境变量 STARSHIP_LOG 来开启调试日志。 这些日志可能过于详细，所以更常使用 module 来调试特定的组件。例如要调试 rust 组件，您可以使用下列命令来获取它的日志和输出。
env STARSHIP_LOG=trace starship module rust
若 Starship 运行缓慢，您可以使用 timings 命令查看运行缓慢的组件或命令。
env STARSHIP_LOG=trace starship timings
它会输出日志，并且记录有输出的组件、运行时长超过 1 毫秒的组件。
最后，如果发现了 bug，请使用 bug-report 命令创建 GitHub 议题。
starship bug-report
为什么我在提示符中看不到某个字符？
最常见的原因是系统配置有问题。 有个别Linux发行版不自带对字体的支持。 请确保：
- 您的字符集应设置为 UTF-8，例如
de_DE.UTF-8或ja_JP.UTF-8。 若LC_ALL不是 UTF-8， 你需要手动设置它。 - 安装了 emoji 字体。 大部分系统都会自带 emoji 字体，但有些系统（例如 Arch Linux）则没有。 字体一般可以用系统的包管理器安装，常见的字体有 Noto emoji 等。
- 您正在使用 Nerd Font。
在终端内运行以下命令来测试：
echo -e "\xf0\x9f\x90\x8d"
echo -e "\xee\x82\xa0"
第一行应该显示出一个蛇的 emoji，第二行应该显示出 powerline 的分支符号（e0a0）。.
若任一符号显示错误，则您的系统配置不正确。 有些时候正确配置字体并不简单。 Discord 里的用户或许能提供帮助。 若两个字符显示正确，但您仍然不能在 Starship 中看到那个字符，请 提交错误报告！
如何卸载 Starship？
Starship 的卸载过程与安装过程一样简单。
- 将 shell 的配置文件（比如
~/.bashrc）中初始化 Starship 的部分全部删除。 - 删除 Starship 的二进制文件。
如果 Starship 是用包管理器安装的，请到包管理器的文档中查找卸载的步骤。
如果 Starship 是用安装脚本安装的，可以用以下命令删除二进制文件：
# 找到并且删除 Starship 二进制文件
sh -c 'rm "$(command -v 'starship')"'
我如何在没有 sudo 的情况下安装 Starship？
Shell 安装脚本(https://starship.rs/install) 只尝试使用 sudo当安装目录不可被当前用户写入 默认安装目录是环境变量 $BIN_DIR 的值或者 /usr/loca/bin 如果 if $BIN_DIR 未设置 如果你使用一个用户可写的安装目录替代, 你应该可以不使用 sudo 安装 Starship 例如, curl -sS https://starship.rs/install.sh | sh -s -- -b ~/.local/bin 使用 -b 选项设置安装目录到 ~/.local/bin
对于非交互 Starship 安装, 请添加 -y 以跳过确认 查看安装脚本源码以获取所有支持的选项
当使用包管理器时, 查询包管理器关于有无sudo安装的文档