常见问题与排错

这一章解决什么问题

帮助你解决 Windows 下使用 Zed 时遇到的常见问题。

资料来源

• Zed Windows 官方文档 - Troubleshooting
• Zed GitHub Issues
• 社区经验

你会在什么时候用到它

• Zed 出现问题时
• 需要排查环境问题时

启动问题

Zed 无法启动 / 白窗口

根据 官方排错文档：

排查步骤：

1. 更新 GPU 驱动

   • NVIDIA：访问 NVIDIA 官网 下载最新驱动
   • AMD：访问 AMD 官网 下载最新驱动
   • Intel：访问 Intel 官网

2. 检查硬件加速

   • Windows 设置 → 系统 → 显示 → 图形设置
   • 确保硬件加速 GPU 调度已开启

3. 关闭冲突软件

   • 某些录屏软件、截图工具可能冲突
   • 尝试关闭后重新启动 Zed

4. 安全模式启动

   • 尝试不加载扩展和设置启动
   • 重命名配置文件夹 %LOCALAPPDATA%\Zed 为 Zed.backup
   • 重新启动 Zed

启动缓慢

1. 检查杀毒软件是否在扫描 Zed
2. 将 Zed 添加到杀毒软件白名单
3. 检查是否有大量文件的项目被自动打开

终端问题

终端无法打开

1. 检查默认 shell 路径是否正确
2. 在 settings.json 中显式指定 shell：

   {
     "terminal": {
       "shell": "system"
     }
   }

中文显示乱码

{
  "terminal": {
    "env": {
      "PYTHONIOENCODING": "utf-8",
      "LANG": "zh_CN.UTF-8"
    }
  }
}

PowerShell 执行策略

如果终端提示执行策略问题：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

性能问题

大文件卡顿

1. 禁用 minimap：

   {"minimap": {"show": "never"}}

2. 关闭不必要的诊断

内存占用高

1. 检查是否有大量文件的项目
2. 在 settings.json 中排除大文件夹：

   {"files": {"exclude": ["node_modules", ".git", "target"]}}

其他问题

快捷键不生效

1. 检查是否有其他软件占用快捷键
2. 查看 keymap.json 是否有冲突
3. 尝试重启 Zed

文件编码问题

状态栏显示文件编码，点击可切换。Windows 下建议统一使用 UTF-8。

获取帮助

渠道	链接	说明
GitHub Issues	https://github.com/zed-industries/zed/issues	提交 bug
Zed Discord	https://discord.gg/zed	实时讨论
官方文档	https://zed.dev/docs	查阅文档

本章小结

• 启动问题先检查 GPU 驱动和硬件加速
• 终端问题检查 shell 配置和编码
• 性能问题排除大文件和优化配置
• 遇到问题可查阅官方文档和社区

小练习

1. 查看 Zed 的日志文件（Ctrl+Shift+P → open log）
2. 检查你的 GPU 驱动是否最新