Xin Zhao
6aa90e750d
Self-Review Checklist: - [ ] I've reviewed my own diff for quality, security, and reliability - [ ] Unsafe blocks (if any) have justifying comments - [ ] The content is consistent with the [UI/UX checklist](https://github.com/zed-industries/zed/blob/main/CONTRIBUTING.md#uiux-checklist) - [ ] Tests cover the new/changed behavior - [ ] Performance impact has been considered and is acceptable Change the actions in docs to adopt the right format. Release Notes: - N/A
124 lines
3.5 KiB
Markdown
124 lines
3.5 KiB
Markdown
---
|
|
title: Zed on macOS
|
|
description: "Zed is developed primarily on macOS, making it a first-class platform with full feature support."
|
|
---
|
|
|
|
# Zed on macOS
|
|
|
|
Zed is developed primarily on macOS, making it a first-class platform with full feature support.
|
|
|
|
## Installing Zed
|
|
|
|
Download Zed from the [download page](https://zed.dev/download). The download is a `.dmg` file—open it and drag Zed to your Applications folder.
|
|
|
|
For the preview build, which receives updates about a week ahead of stable, visit the [preview releases page](https://zed.dev/releases/preview).
|
|
|
|
After installation, Zed checks for updates automatically and prompts you when a new version is available.
|
|
|
|
### Homebrew
|
|
|
|
You can also install Zed using Homebrew:
|
|
|
|
```sh
|
|
brew install --cask zed
|
|
```
|
|
|
|
For the preview version:
|
|
|
|
```sh
|
|
brew install --cask zed@preview
|
|
```
|
|
|
|
### Building from Source
|
|
|
|
To build Zed from source, see the [macOS development documentation](./development/macos.md).
|
|
|
|
## System Requirements
|
|
|
|
- macOS 10.15.7 (Catalina) or later
|
|
- Apple Silicon (M1/M2/M3/M4) or Intel processor
|
|
|
|
Zed uses Metal for GPU-accelerated rendering, which is available on all supported macOS versions.
|
|
|
|
## Installing the CLI
|
|
|
|
Zed includes a command-line tool for opening files and projects from Terminal. To install it:
|
|
|
|
1. Open Zed
|
|
2. Open the command palette with `Cmd+Shift+P`
|
|
3. Run {#action cli::InstallCliBinary}
|
|
|
|
This creates a `zed` command in `/usr/local/bin`. You can then open files and folders:
|
|
|
|
```sh
|
|
zed . # Open current folder
|
|
zed file.txt # Open a file
|
|
zed project/ file.txt # Open a folder and a file
|
|
```
|
|
|
|
See the [CLI Reference](./reference/cli.md) for all available options.
|
|
|
|
## Uninstall
|
|
|
|
1. Quit Zed if it's running
|
|
2. Drag Zed from Applications to the Trash
|
|
3. Optionally, remove your settings and extensions:
|
|
|
|
```sh
|
|
rm -rf ~/.config/zed
|
|
rm -rf ~/Library/Application\ Support/Zed
|
|
rm -rf ~/Library/Caches/Zed
|
|
rm -rf ~/Library/Logs/Zed
|
|
rm -rf ~/Library/Saved\ Application\ State/dev.zed.Zed.savedState
|
|
```
|
|
|
|
If you installed the CLI, remove it with:
|
|
|
|
```sh
|
|
rm /usr/local/bin/zed
|
|
```
|
|
|
|
## Troubleshooting
|
|
|
|
### Zed won't open or shows "damaged" warning
|
|
|
|
If macOS reports that Zed is damaged or can't be opened, it's likely a Gatekeeper issue. Try:
|
|
|
|
1. Right-click (or Control-click) on Zed in Applications
|
|
2. Select "Open" from the context menu
|
|
3. Click "Open" in the dialog that appears
|
|
|
|
This tells macOS to trust the application.
|
|
|
|
If that doesn't work, remove the quarantine attribute:
|
|
|
|
```sh
|
|
xattr -cr /Applications/Zed.app
|
|
```
|
|
|
|
### CLI command not found
|
|
|
|
If the `zed` command isn't available after installation:
|
|
|
|
1. Check that `/usr/local/bin` is in your PATH
|
|
2. Try reinstalling the CLI via {#action cli::InstallCliBinary} in the command palette
|
|
3. Open a new terminal window to reload your PATH
|
|
|
|
### GPU or rendering issues
|
|
|
|
Zed uses Metal for rendering. If you experience graphical glitches:
|
|
|
|
1. Ensure macOS is up to date
|
|
2. Restart your Mac to reset the GPU state
|
|
3. Check Activity Monitor for GPU pressure from other apps
|
|
|
|
### High memory or CPU usage
|
|
|
|
If Zed uses more resources than expected:
|
|
|
|
1. Check for runaway language servers in the terminal output ({#action zed::OpenLog})
|
|
2. Try disabling extensions one by one to identify conflicts
|
|
3. For large projects, consider using [project settings](./reference/all-settings.md#file-scan-exclusions) to exclude unnecessary folders from indexing
|
|
|
|
For additional help, see the [Troubleshooting guide](./troubleshooting.md) or visit the [Zed Discord](https://discord.gg/zed-community).
|