OpenCode 打开后白屏怎么办？

今天我遇到了一个真实而且让人崩溃的问题：兴冲冲打开 Mac 上的 OpenCode，结果迎面而来的只有一个刺眼的白屏。不管等多久，它就是不加载任何内容。更气人的是，我把软件卸载了重新安装，白屏依然存在！

为什么"重装"没有用？

很多人遇到软件出问题，第一反应就是重装。但是，为什么这次重装 OpenCode 却解决不了白屏问题呢？这里就要明白一个重要的区别：

1. 软件本体（App）：这就像是买来的房子本身。当我们把它拖进废纸篓，或者用卸载命令时，我们只是把房子拆了。
2. 配置文件：这是你给房子定的装修图纸和家具摆放说明。
3. 缓存：这是日常生活中产生的垃圾或者临时存放的快递纸箱。
4. 应用数据（App Data）：这是你买来的家具和放在房子里的个人物品。

当我们只是简单地删除软件本体然后重装时，就像是拆了旧房子建了新房子，但是旧的装修说明书、垃圾和旧家具都还在原地。如果白屏是因为这些"旧家具"或"旧垃圾"坏了导致的，那不管换多少次新房子，只要你还把那些坏东西搬进去，白屏问题就依然存在。

这就是为什么我们需要手动清理这些残留数据的原因。

第一步：确认软件本体没有问题

首先，我们确保软件本身是完整安装的。如果你使用 Homebrew 安装，可以打开终端，运行以下命令确认安装正常：

brew install --cask opencode-desktop

你会看到什么： 如果安装成功，终端会显示下载进度，最后提示 opencode-desktop was successfully installed!。如果是重新安装，它可能会提示该软件已经安装。

第二步：寻找潜伏的残留配置

接下来，我们需要去用户的配置文件夹下查看是否有 OpenCode 的残留。

在终端中尝试输入：

ls ~/.config/opencode

你会看到什么： 如果你看到列出了一些文件，或者终端���么���没输出直接跳到了下一行，说明这个配置文件夹存在。如果提示 No such file or directory，说明没有配置残留，我们可以继续往下排查。

第三步：彻底清理"坏家具"和"旧垃圾"（终极解决办法）

既然排除了其他可能，那导致白屏的罪魁祸首基本可以锁定在缓存数据或者应用数据上了。我们需要把它们彻底清理干净。

在终端中依次输入以下两条命令：

rm -rf ~/Library/Application\ Support/ai.opencode.desktop

你会看到什么： 这是一个安静的命令。如果执行成功，终端不会显示任何报错信息，直接跳入新的一行。这代表位于 Application Support 目录下的应用数据（也就是我们的"坏家具"）已经被强制删除了。

接着输入：

rm -rf ~/.cache/opencode

你会看到什么： 同样，执行成功后没有任何输出。这代表缓存数据（"旧垃圾"）也被清空了。

注意： rm -rf 会直接删除文件且不提示确认，操作时一定要非常小心。请务必直接复制粘贴上面的代码，切勿自己随意敲错路径。

第四步：重新打开 OpenCode

做完上面的清理工作后，现在你可以重新打开 OpenCode 应用程序了。

你会发现，它就像第一次安装时那样呈现出正常的初始界面，那个让人抓狂的白屏终于消失了！

核心经验：不要只会重装

通过今天的折腾，我明白了一个重要的道理：遇到软件出问题，不要只会机械地重装。 了解软件在电脑里的运行机制，区分清楚"本体"和"数据"，才能真正做到药到病除。

下次再遇到类似"卸载重装也无法解决"的问题，记得先去查查如何清理这款软件的缓存和配置文件！

👉 下一步看什么