疑难解答¶

此页面旨在帮助您修复在使用Spaceship提示符遇到的常见问题。

`git` 分支的奇怪符号是什么?¶

您需要有一个powerline的补丁字体才能正确显示 git 分支符号。

安装任何powerline兼容的字体，例如 Fira Code 或其他。
配置您的终端仿真器使用那个字体。

模块前面奇怪的字符是什么？¶

这并不是Spaceship提示符的问题。 Spaceship在模块中使用 Unicode 符号来代表 SPACESHIP_*_SYMBOL。要解决此问题：

使用此命令验证您的终端模拟器支持 Unicode 字符：

curl - L https://www.cl.cam.ac.uk/~mgk25/ucs/examples/UTF-8-demo.txt
# 或
wget -O - https://www.cl.cam.ac.uk/~mgk25/ucs/examples/UTF-8-demo.txt

配置您的终端模拟器使用UTF-8作为字符编码。

如果不支持 Unicode 符号，您可以用 SPACESHIP_*_SYMBOL 选项替换它们与您终端兼容。查看选项页面以获取更多信息。

提示符之前的 `[I]` 是什么？¶

那是 vi_mode 模块表示 插入 模式。您可以在您的配置中用以下行禁用此功能：

SPACESHIP_VI_MODE_SHOW=false

为什么我的提示符很慢？¶

由于状态检查是相当繁重的操作，空间飞船在大仓库中Spaceship可能较慢。在这种情况下，试图避免有许多未提交的文件。

使用 grep 获取软件包版本没有返回准确信息。所以我们现在使用 jq ，并且用 python 和 node作为备选。这可能会稍微影响性能。在这种情况下安装 jq (详情请 #439, #441)。

由于未使用的模块加载，提示符也可能变慢。 Spaceship只装载 SPACESHIP_PROPT_ORDER 或 SPACESHIP_RPROPT_ORDER 中提到的模块。如果你认为某些模块对你来说可能毫无用处，试图通过在排序选项中省略它们的名字来禁用它们。

在下面的示例中， time, package, xcode, julia, docker, ember 和 vi_mode 模块被禁用，根本不会被加载。

#  如果你想禁用仅仅需要将模块注释
SPACESHIP_PROMPT_ORDER=(
  # time        # Time stamps section (Disabled)
  user          # Username section
  dir           # Current directory section
  host          # Hostname section
  git           # Git section (git_branch + git_status)
  hg            # Mercurial section (hg_branch  + hg_status)
  # package     # Package version (Disabled)
  node          # Node.js section
  ruby          # Ruby section
  elixir        # Elixir section
  # xcode       # Xcode section (Disabled)
  swift         # Swift section
  golang        # Go section
  php           # PHP section
  rust          # Rust section
  haskell       # Haskell Stack section
  # julia       # Julia section (Disabled)
  # docker      # Docker section (Disabled)
  aws           # Amazon Web Services section
  gcloud        # Google Cloud Platform section
  venv          # virtualenv section
  conda         # conda virtualenv section
  pyenv         # Pyenv section
  dotnet        # .NET section
  # ember       # Ember.js section (Disabled)
  kubectl       # Kubectl context section
  terraform     # Terraform workspace section
  ibmcloud      # IBM Cloud section
  exec_time     # Execution time
  line_sep      # Line break
  battery       # Battery level and status
  # vi_mode     # Vi-mode indicator (Disabled)
  jobs          # Background jobs indicator
  exit_code     # Exit code section
  char          # Prompt character
)

禁用大量未使用的部分可能会实现显著的性能提升。下面是用上面示例的 SPACESHIP_PROPT_ORDER 和所有模块全部开启运行100次的渲染Spaceship的比较：

	所有模块	有禁用模块
在Git仓库内*	`23.5秒`	`21.3秒`
在Git仓库外*	`8.3秒`	`7.4秒`

* - spaceship-prompt 项目用于此测试。

某些模块图标相互重叠？¶

此问题与您的终端模拟器如何渲染Unicode 9字符有关。要解决此问题：

确保终端使用 Unicode 版本 9 宽度。
让您的终端以双宽度渲染不明确的字符。

在 iTerm 中，遵循这些指令：

转至 iTerm → Preferences… (⌘,) → Profiles → Text
检查 Unicode 版本 9 宽度。
检查 宽度模糊字符是否为双宽度。
重新装入终端标签页。

为什么我的提示符看起来不像预览？¶

预览显示 Spaceship 提示符设置为：

Hyper 作为终端仿真器。
One Dark 来自 Atom 编辑器的一个颜色主题。
Fira Code, 与ligatures 作为主字体 (16px size).
zsh-syntax-highlighting 让命令颜色化。
zsh-autosuggestions 类似浏览器的自动补全。

查看屏幕截图维基以了解更多的配色方案示例。

难道没有帮助吗？¶

请提出 issue，描述你的问题，我们将乐意帮助你。