常见问题

本页整理目前已知的安装、权限、运行和授权相关问题。遇到问题时，请先按下面顺序排查，再查看对应系统的说明。

如何反馈问题

如果排查后仍未解决，请到 Gitee Issue 提交问题。请不要在下载页面或评论区重复反馈，Issue 便于集中跟进和补充解决方案。

提交时请尽量附上：系统及版本、电脑架构、工具箱版本、安装包完整文件名、JetBrains 软件及版本、完整报错或截图、复现步骤，以及已经尝试过的处理方式。涉及隐私的信息请先打码。

先按这个顺序检查

1. 确认安装包来自首页或本人发布渠道，不要使用他人转发的安装包。
2. 确认已经按照安装教程选择了与你系统匹配的安装包。
3. 确认安装或解压完成后，已经打开工具箱。
4. Windows 安装版启动时请允许 UAC 管理员授权；便携版若提示需要提升权限，请以管理员身份运行 jetbrains.exe。
5. macOS 用户请先完成后台服务授权，并允许应用管理；完全磁盘访问仅在受保护的自定义目录访问失败时按提示开启。
6. 如果下面没有你的问题，请带上系统版本、工具箱版本、报错截图和操作步骤反馈。

目前工具箱经过 Windows、macOS、Linux 多系统测试。如遇到新版本问题，请及时反馈，方便后续补充到本页。

Windows 问题

下载或安装时提示有风险

Windows 自带安全中心可能会提示风险。工具箱涉及系统配置和环境变量处理，部分安全软件可能会误报；软件源码可通过 Gitee 仓库自行核验，也已经做过安全检测。

只有在确认安装包来自官方发布渠道，并且 SHA-256 与发布页一致后，才可以在下载记录中选择保留并继续安装。若安装包来自他人转发链接或校验不一致，请立即删除并重新下载。

输入授权码提示没有权限，重启后需要重新授权

这通常不是工具箱本身的问题，而是 JetBrains 软件的本地授权文件没有写入权限。

处理方式：

1. 根据提示找到对应的 .key 文件。
2. 删除这个 .key 文件。
3. 重新打开工具箱，并在 UAC 窗口中选择“是”。
4. 重新输入授权码或重新执行工具箱内流程。

运行时提示需要 WebView2

Windows 安装版会自动检查并安装 WebView2 运行时。便携版也会通过随包附带的启动器检查；缺少运行时时，会询问是否运行微软官方 WebView2 引导程序。

如果自动安装失败，请检查网络连接，也可以从微软官方下载页面安装 Evergreen WebView2 运行时后重新打开工具箱。请始终通过便携包中的 jetbrains.exe 启动，不要直接运行内部的 jetbrains-app.exe。

macOS 问题

提示开发者无法验证

这说明当前安装包没有通过可验证的 Apple Developer ID 签名和公证。请先确认安装包来自官方发布渠道，并核对发布页提供的 SHA-256 校验值。

如果校验一致，可以按下面步骤处理：

1. 在提示窗口中点击“取消”。
2. 打开 系统设置 -> 隐私与安全性。
3. 找到被拦截的 jetbrains.app，点击“仍要打开”。
4. 在弹窗中点击“打开”。

卸载后再次安装异常

macOS 用户不建议使用第三方卸载软件清理工具箱。第三方卸载工具可能会删除关联文件，导致再次安装或使用时出现异常。

如果已经用第三方工具清理过，请重新安装完整工具箱，按启动提示重新授权安装后台服务，并检查“应用管理”权限。只有受保护的自定义目录访问被拒绝时，才需要额外授予完全磁盘访问权限。

Linux 问题

安装不上或打不开

Linux 安装失败或无法打开，通常是系统缺少依赖。请优先查看终端报错，并根据报错安装对应依赖。

Debian、Ubuntu 等发行版建议优先使用 .deb 安装包：

sudo apt-get install ./jetbrains_{version}_linux_amd64.deb

其他发行版可以尝试 AppImage：

chmod u+x jetbrains_{version}_linux_amd64.AppImage
./jetbrains_{version}_linux_amd64.AppImage

Nvidia 驱动环境下无法启动或段错误

如果使用 Nvidia 专有驱动，并遇到段错误或工具箱无法启动，可能与 WebKit2Gtk 的 DMABUF 渲染有关。

v2.0.3 会在检测到 Nvidia 驱动时自动禁用 WebKit2Gtk 的 DMABUF 渲染，并保留用户已有的显式环境变量设置，不需要修改全局环境配置。

如果自动检测未生效，可以只对本次启动临时设置：

WEBKIT_DISABLE_DMABUF_RENDERER=1 ./jetbrains_{version}_linux_amd64.AppImage

如果这样可以启动，请附上发行版、显卡型号和驱动版本提交 Issue，以便补充自动检测规则。

上例适用于 x86_64 AppImage；ARM64 将文件名中的 amd64 改为 arm64。如果已通过 DEB/RPM 安装，可用 WEBKIT_DISABLE_DMABUF_RENDERER=1 jetbrains 临时启动。

反馈问题时请提供什么

如果你在本页没有找到对应问题，请反馈时尽量提供以下信息：

• 使用的系统：Windows、macOS 或 Linux，以及系统版本。
• 电脑架构：x64、ARM64、Apple 芯片或 Intel 芯片。
• 下载的安装包名称。
• 工具箱版本。
• JetBrains 软件名称和版本。
• 报错截图或完整提示文字。
• 你已经尝试过的处理步骤。

如果问题可以稳定复现，还可以附上对应时间段的 debug.log：Windows 通常位于 %PUBLIC%\.jb_run\debug.log，macOS 和 Linux 位于 ~/.jb_run/debug.log。日志可能包含本机用户名和目录，提交前请打码；订单号、设备标识等个人信息也不要公开。

信息越完整，越容易判断问题原因。