故障排除：安装与构建

macOS："无法打开，因为无法验证开发者"

macOS 默认阻止从 App Store 外部下载的应用。这是 Gatekeeper 警告，不是 1DevTool 有问题的标志。

使用系统设置修复：

1. 打开 System Settings → Privacy & Security
2. 向下滚动到 Security 部分
3. 你应该看到一条消息说 "1DevTool was blocked from use because it is not from an identified developer"
4. 点击 Open Anyway
5. 在出现的对话框中确认

使用终端的替代修复：

xattr -d com.apple.quarantine /Applications/1DevTool.app

在终端中运行此命令一次，然后正常启动 1DevTool。你不会再被提示。

Windows：杀毒软件阻止安装

某些杀毒软件将新的或未签名的安装程序标记为可疑并在安装期间阻止它们。

修复：

1. 在杀毒软件中临时禁用实时保护。
2. 运行 1DevTool 安装程序。
3. 安装完成后重新启用实时保护。

要避免完全禁用保护，你可以改为为 1DevTool 安装程序文件（通常是 1DevTool-Setup.exe）或安装目录（C:\Users\<you>\AppData\Local\1DevTool）添加例外。确切步骤因杀毒软件而异 —— 在杀毒软件设置中查找 "Exclusions" 或 "Exceptions"。

Linux：AppImage 无法启动

如果双击 AppImage 没有任何反应，或它立即关闭，按顺序尝试这些修复：

使文件可执行。 AppImage 在运行之前需要执行权限：

chmod +x 1DevTool-*.AppImage

安装 FUSE。 AppImage 使用 FUSE（Filesystem in Userspace）挂载自身。许多最小化 Linux 安装不包含它：

sudo apt install libfuse2

在 Fedora/RHEL 上：sudo dnf install fuse。

从终端运行以查看错误输出。 如果仍然失败，从终端启动它以便你可以读取错误消息：

./1DevTool-*.AppImage --no-sandbox

--no-sandbox 标志在某些受限环境（如某些企业 Linux 设置或容器）中有时是必需的。

应用打开但保持空白

症状： 1DevTool 启动并出现窗口，但界面从不加载 —— 只是白色或灰色空白屏幕。

原因： 来自先前安装或失败更新的损坏应用缓存文件。

修复 —— 删除缓存：

• macOS：
  bash

  rm -rf ~/Library/Application\ Support/1DevTool/Cache
  

• Windows： 在文件资源管理器中导航到 %APPDATA%\1DevTool\Cache 并删除 Cache 文件夹。
• Linux： rm -rf ~/.config/1DevTool/Cache

删除缓存后，重启 1DevTool。缓存会自动重建。

启动时找不到 tmux

1DevTool 使用 tmux 在你切换面板或最小化应用时保持终端会话活跃。如果未安装 tmux，你会在启动时看到警告，终端将不会持久化。

安装 tmux：

• macOS： brew install tmux
• Linux（Debian/Ubuntu）： sudo apt install tmux
• Linux（Fedora/RHEL）： sudo yum install tmux 或 sudo dnf install tmux

安装后，完全退出 1DevTool 并重新启动。如果你使用自定义 shell 或非标准 PATH，确保包含 tmux 的目录（通常是 /usr/local/bin 或 /usr/bin）包含在 shell 的 PATH 变量中。