---
url: /zh/guide/extensions/theme-style.md
---

# 主题风格 {#theme-style}

## 切换主题 {#switch-theme}

如果用户不喜欢 xmake 默认的显示配色和风格，我们可以通过下面的全局配置命令，切换到 xmake 提供的其他一些配置主题，例如：

```sh
$ xmake g --theme=dark
```

默认的主题名为 default，这里我们通过切换到 dark 风格主题，来适配一些终端背景很浅的场景，提供更加深色的色彩输出，避免看不清。

如果我们要切回默认主题，可以直接输入：

```sh
$ xmake g -c
```

或者

```sh
$ xmake g --theme=default
```

另外，xmake 还提供了不少有趣实用的内置主题，大家可以试试，下面会详细讲解。

::: tip 注意
如果大家有更好的主题，也欢迎提pr贡献进来，非常感谢！
:::

## 内置主题 {#builtin-themes}

### 默认主题 {#default-theme}

这个也就是咱们安装xmake后默认的显示主题，主题名：default，它默认会提供色彩输出，适合一些深色背景的终端。

我们也可以通过下面的命令切回默认主题：

```sh
$ xmake g --theme=default
```

### Ninja 主题 {#ninja-theme}

这个是 v2.3.4 之后版本提供的主题，构建进度风格类似 ninja，采用单行进度条，不再回滚进度，用户可以根据自己的喜好设置。

除了进度展示不同外，其他都跟默认主题的配置相同。

```sh
$ xmake g --theme=ninja
```

### Emoji 主题 {#emoji-theme}

这个主题部分输出通过 emoji 字符代替之前的色彩输出。

```sh
$ xmake g --theme=emoji
```

### Dark 主题 {#dark-theme}

这个主题主要是针对一些终端背景为浅色系（比如淡黄色等），导致一些警告输出（默认也是黄色）重合不可见，所以把主题配色变成深色系，提高可见性。

```sh
$ xmake g --theme=dark
```

### Light 主题 {#light-theme}

这个主题主要是针对一些终端背景为深色系，导致一些输出重合不可见，所以把主题配色变成浅色系，提高可见性。

```sh
$ xmake g --theme=light
```

### Plain 主题 {#plain-theme}

这个主题，其实就是完全禁用色彩、emoji 输出，主要是应对一些不支持 colors code 的终端导致显示乱码的问题，也是最朴素的主题风格。

::: tip 注意
一些 Windows 终端可能不支持 colors，就可以设置这个主题来解决乱码显示问题。
:::

```sh
$ xmake g --theme=plain
```

### Powershell 主题 {#powershell-theme}

Windows 下 powershell 终端背景是蓝色的，而它的调色板配置似乎被改过，其中 magenta 色居然显示成背景蓝色，很诡异，导致 Xmake 的默认输出会有局部文本不可见（与背景色重叠了）。

所以，这个主题就是为了更好地适配 powershell 终端下的显示输出。

```sh
$ xmake g --theme=powershell
```