# Appearance and Visual Customization - Zed

> Customize Zed's themes, fonts, icons, UI density, and other visual settings to match your preferences.

- 网址：https://funcoding.ai/agents/zed/appearance/
- 来源：Zed 官方文档原文（英文），Apache-2.0 / GPL-3.0 许可，同步于 2026-10-11
- 官方原文：https://zed.dev/docs/appearance

---
Customize Zed's visual appearance to match your preferences. This guide covers themes, fonts, icons, and other visual settings.

For information on how the settings system works, see [All Settings](https://funcoding.ai/agents/zed/reference/all-settings/).

## Customize Zed in 5 Minutes

Here's how to make Zed feel like home:

1. **Pick a theme**: Press `theme_selector::Toggle` to open the Theme Selector. Arrow through the list to preview themes in real time, and press Enter to apply.

2. **Toggle light/dark mode quickly**: Press `theme::ToggleMode`. If you currently use a static `"theme": "..."` value, the first toggle converts it to dynamic mode settings with default themes.

3. **Choose an icon theme**: Run `icon_theme_selector::Toggle` from the command palette to browse icon themes.

4. **Set your font**: Open the Settings Editor with `zed::OpenSettings` and search for `buffer_font_family`. Set it to your preferred coding font.

5. **Adjust font size**: In the same Settings Editor, search for `buffer_font_size` and `ui_font_size` to tweak the editor and interface text sizes.

That's it. You now have a personalized Zed setup.

## Themes

Install themes from the Extensions page (`zed::Extensions`), then switch between them with the Theme Selector (`theme_selector::Toggle`).

Zed supports separate themes for light and dark mode with automatic switching based on your system preference:

```json [settings]
{
  "theme": {
    "mode": "system",
    "light": "One Light",
    "dark": "One Dark"
  }
}
```

You can also override specific theme attributes for fine-grained control.

→ [Themes documentation](https://funcoding.ai/agents/zed/themes/)

## Icon Themes

Customize file and folder icons in the Project Panel and tabs. Browse available icon themes with the Icon Theme Selector (`icon_theme_selector::Toggle` in the command palette).

Like color themes, icon themes support separate light and dark variants:

```json [settings]
{
  "icon_theme": {
    "mode": "system",
    "light": "Zed (Default)",
    "dark": "Zed (Default)"
  }
}
```

→ [Icon Themes documentation](https://funcoding.ai/agents/zed/icon-themes/)

## Fonts

Zed uses three font settings and their fallback counterparts for different contexts:

| Setting                   | Used for                  |
| ------------------------- | ------------------------- |
| `buffer_font_family`      | Editor text               |
| `buffer_font_fallbacks`   | Editor text               |
| `ui_font_family`          | Interface elements        |
| `ui_font_fallbacks`       | Interface elements        |
| `terminal.font_family`    | [Terminal](https://funcoding.ai/agents/zed/terminal/) |
| `terminal.font_fallbacks` | [Terminal](https://funcoding.ai/agents/zed/terminal/) |

Example configuration:

```json [settings]
{
  "buffer_font_family": "JetBrains Mono",
  "buffer_font_fallbacks": ["Nerd Font"],
  "buffer_font_size": 14,
  "ui_font_family": "Inter",
  "ui_font_fallbacks": ["Nerd Font"],
  "ui_font_size": 16,
  "terminal": {
    "font_family": "JetBrains Mono",
    "font_fallbacks": ["Nerd Font"],
    "font_size": 14
  }
}
```

### Font Ligatures

To disable font ligatures:

```json [settings]
{
  "buffer_font_features": {
    "calt": false
  }
}
```

### Line Height

Adjust line spacing with `buffer_line_height`:

- `"comfortable"` — 1.618 ratio (default)
- `"standard"` — 1.3 ratio
- `{ "custom": 1.5 }` — Custom ratio

## UI Elements

Zed provides extensive control over UI elements including:

- **Tab bar** — Show/hide, navigation buttons, file icons, git status
- **Status bar** — Language selector, cursor position, line endings
- **Scrollbar** — Visibility, git diff indicators, search results
- **Minimap** — Code overview display
- **Gutter** — Line numbers, fold indicators, breakpoints
- **Panels** — Project Panel, Terminal, Agent Panel sizing and docking

→ [Visual Customization documentation](https://funcoding.ai/agents/zed/visual-customization/) for all UI element settings

## What's Next

- [All Settings](https://funcoding.ai/agents/zed/reference/all-settings/) — Complete settings reference
- [Key bindings](https://funcoding.ai/agents/zed/key-bindings/) — Customize keyboard shortcuts
- [Vim Mode](https://funcoding.ai/agents/zed/vim/) — Enable modal editing