Capitulo 1: Instalacion y Configuracion de Zed
Capitulo 1: Instalacion y Configuracion
Aprende a instalar Zed en tu sistema operativo, configurar el editor y personalizar tu entorno de desarrollo.
Anterior: Indice | Siguiente: Capitulo 2: Atajos y Navegacion
Instalacion
macOS
Instala Zed con Homebrew:
# Version estable
brew install --cask zed
# Version preview (nuevas funcionalidades)
brew install --cask zed@preview
Tambien puedes descargar el .dmg desde zed.dev/download.
Linux
Usa el script oficial de instalacion:
# Version estable
curl -f https://zed.dev/install.sh | sh
# Version especifica
curl -f https://zed.dev/install.sh | ZED_VERSION=0.216.0 sh
# Canal preview
curl -f https://zed.dev/install.sh | ZED_CHANNEL=preview sh
En distribuciones como Arch Linux, Zed esta en los repositorios oficiales:
# Arch Linux / Manjaro
sudo pacman -S zed
Requisito: GPU compatible con Vulkan. Verifica con:
vulkaninfo --summary
Para desinstalar (si se instalo con el script):
zed --uninstall
Windows
Instala con Winget:
winget install -e --id ZedIndustries.Zed
O descarga el instalador desde zed.dev/download.
Primeros Pasos
Abrir un Proyecto
Desde la terminal:
# Abrir un directorio
zed ~/proyectos/mi-app
# Abrir el directorio actual
zed .
# Abrir un archivo especifico
zed archivo.rs
Desde el editor usa Cmd+O (macOS) o Ctrl+O (Linux/Windows) para abrir un directorio.
Migrar desde VS Code
Zed puede importar tu configuracion de VS Code en el primer inicio:
- Settings: Importa tus preferencias de formato, fuentes y temas
- Keybindings: Mapea tus atajos personalizados
- Temas: Importa temas compatibles
Configuracion con settings.json
Abre la configuracion con Cmd+, (macOS) o Ctrl+, (Linux/Windows). Tambien puedes abrir el archivo directamente con Cmd+Alt+, o Ctrl+Alt+,.
Ubicacion del Archivo
| Plataforma | Ruta |
|---|---|
| macOS | ~/Library/Application Support/Zed/settings.json |
| Linux | $XDG_CONFIG_HOME/zed/settings.json |
| Windows | %APPDATA%\Zed\settings.json |
Configuracion Basica Recomendada
{
"theme": {
"mode": "system",
"light": "One Light",
"dark": "One Dark"
},
"buffer_font_family": "JetBrains Mono",
"buffer_font_size": 14,
"buffer_line_height": "comfortable",
"ui_font_family": "Zed Plex Sans",
"ui_font_size": 16,
"tab_size": 2,
"format_on_save": "on",
"autosave": {
"after_delay": {
"milliseconds": 1000
}
},
"soft_wrap": "editor_width",
"show_whitespaces": "boundary",
"relative_line_numbers": false,
"cursor_blink": true,
"scrollbar": {
"show": "auto"
},
"indent_guides": {
"enabled": true,
"coloring": "indent_aware"
},
"inlay_hints": {
"enabled": true
}
}
Configuracion por Lenguaje
Define ajustes especificos para cada lenguaje:
{
"languages": {
"Python": {
"tab_size": 4,
"formatter": {
"external": {
"command": "black",
"arguments": ["-"]
}
}
},
"Rust": {
"tab_size": 4,
"format_on_save": "on",
"formatter": "language_server"
},
"JavaScript": {
"tab_size": 2,
"formatter": {
"external": {
"command": "prettier",
"arguments": ["--stdin-filepath", "{buffer_path}"]
}
}
},
"Go": {
"tab_size": 4,
"hard_tabs": true,
"formatter": "language_server"
}
}
}
Configuracion por Proyecto
Crea un archivo .zed/settings.json en la raiz de tu proyecto para configuraciones locales:
{
"tab_size": 4,
"formatter": "language_server",
"lsp": {
"rust-analyzer": {
"initialization_options": {
"check": {
"command": "clippy"
}
}
}
}
}
Temas
Cambiar Tema
Usa el selector de temas con Cmd+K Cmd+T (macOS) o Ctrl+K Ctrl+T (Linux/Windows). Navega con las flechas para previsualizar cada tema en tiempo real.
Temas Populares
Algunos temas incluidos y disponibles como extension:
- One Dark / One Light - Clasicos de Atom
- Gruvbox - Tonos calidos
- Catppuccin - Paleta pastel
- Rose Pine - Tonos suaves
- Ayu - Limpio y moderno
- Dracula - Oscuro vibrante
Instalar Temas desde Extensiones
Abre el panel de extensiones con Cmd+Shift+X (macOS) o Ctrl+Shift+X (Linux/Windows) y busca el tema deseado.
Personalizar Colores del Tema
Usa theme_overrides para ajustar colores sin cambiar de tema:
{
"theme_overrides": {
"background": "#1a1b26",
"editor.background": "#1a1b26",
"syntax": {
"comment": {
"font_style": "italic"
}
}
}
}
Configuracion de Keybindings
Abre el editor de keybindings con Cmd+K Cmd+S (macOS) o Ctrl+K Ctrl+S (Linux/Windows).
El archivo de keybindings esta en la misma carpeta que settings.json con el nombre keymap.json:
[
{
"context": "Workspace",
"bindings": {
"ctrl-shift-t": "terminal_panel::ToggleFocus"
}
},
{
"context": "Editor",
"bindings": {
"ctrl-d": "editor::SelectNext"
}
}
]
Modos de Edicion
Modo Vim
Activa el modo Vim en settings:
{
"vim_mode": true,
"vim": {
"use_system_clipboard": "always"
}
}
Zed soporta la mayoria de comandos Vim incluyendo macros, text objects y registros.
Verificar la Instalacion
Ejecuta estos pasos para verificar que todo funciona:
- Abre Zed desde la terminal:
zed . - Abre la paleta de comandos:
Cmd+Shift+P/Ctrl+Shift+P - Escribe “settings” y abre la configuracion
- Cambia el tema con
Cmd+K Cmd+T/Ctrl+K Ctrl+T - Abre un archivo y verifica el resaltado de sintaxis
Anterior: Indice | Siguiente: Capitulo 2: Atajos y Navegacion