常见问题
本页整理目前已知的安装、权限、运行和授权相关问题。遇到问题时，请先按下面顺序排查，再查看对应系统的说明。
先按这个顺序检查
- 确认安装包来自首页或本人发布渠道，不要使用他人转发的安装包。
- 确认已经按照安装教程选择了与你系统匹配的安装包。
- 确认安装或解压完成后，已经打开工具箱。
- Windows 用户建议用管理员权限打开工具箱。
- macOS 用户请确认已授予完全磁盘访问权限和 App 管理权限。
- 如果下面没有你的问题，请带上系统版本、工具箱版本、报错截图和操作步骤反馈。
目前工具箱经过 Windows、macOS、Linux 多系统测试。如遇到新版本问题，请及时反馈，方便后续补充到本页。
Windows 问题
下载或安装时提示有风险
Windows 自带安全中心可能会提示风险。工具箱涉及系统配置和环境变量处理，部分安全软件可能会误报；软件源码可通过 GitHub 仓库自行核验，也已经做过安全检测。
如果你确认安装包来自首页或本人发布渠道，可以在下载记录中选择保留后再安装。若安装包来自他人转发链接，请不要继续使用，建议重新从官方入口下载。
提示没有权限，无法写入配置
如果 JetBrains 软件安装在 C 盘，或者配置文件需要管理员权限，工具箱可能会因为权限不足无法写入。
处理方式：
- 关闭工具箱。
- 右键工具箱图标。
- 选择“以管理员身份运行”。
- 重新执行工具箱内的配置或授权流程。
输入授权码提示没有权限，重启后需要重新授权
这通常不是工具箱本身的问题，而是 JetBrains 软件的本地授权文件没有写入权限。
处理方式：
- 根据提示找到对应的
.key文件。 - 删除这个
.key文件。 - 右键工具箱，选择“以管理员身份运行”。
- 重新输入授权码或重新执行工具箱内流程。
旧版 JetBrains 软件按流程操作后仍然无效
如果你已经完整执行流程，并尝试重启电脑后仍然无效，常见原因有两个：
- 使用的是较旧的 2023 或 2024 版本，兼容性不如最新版。
- 电脑之前使用过其他修改方式，遗留配置影响了当前流程。
推荐处理方式：
- 优先升级到 JetBrains 最新版本，最新版支持最好。
- Windows 用户可以打开
C:\Users\你的用户名\AppData\Roaming，删除JetBrains文件夹后重新执行流程。
注意
删除 JetBrains 文件夹可能会影响部分 JetBrains 本地配置。操作前请确认你能接受重新配置相关设置。
运行时提示需要 WebView2
如果运行工具箱时提示缺少 WebView 运行时，可以自行安装 WebView2 运行时。
安装完成后重新打开工具箱。
macOS 问题
打开后提示没有权限
这通常是因为没有授予工具箱所需的系统权限。
处理方式：
- 打开
系统设置。 - 进入
隐私与安全性 -> 完全磁盘访问权限，添加或允许jetbrains.app。 - 进入
隐私与安全性 -> App 管理，添加或允许jetbrains.app。 - 关闭并重新打开工具箱。
如果仍然无效，请确认 jetbrains.app 已经拖入 Applications（应用程序）目录，不要直接在 .dmg 窗口或下载目录中长期运行。
提示开发者无法验证
如果提示开发者无法验证，请按下面步骤处理：
- 在提示窗口中点击“取消”。
- 打开
系统设置 -> 隐私与安全性。 - 找到被拦截的
jetbrains.app，点击“仍要打开”。 - 在弹窗中点击“打开”。
提示应用已损坏，无法打开
打开 Terminal.app，执行下面的命令：
sudo xattr -d com.apple.quarantine /Applications/jetbrains.app执行后再次打开 jetbrains.app。
如果 .dmg 安装包内包含“损坏修复”脚本，也可以双击脚本并输入管理员密码进行修复。
提示恶意软件或被移到废纸篓
部分旧版 macOS 可能提示 “jetbrains”将对你的电脑造成伤害。你应该将它移到废纸篓。，且“隐私与安全性”中没有“仍要打开”选项。
可以先在“应用程序”中找到 jetbrains.app，右键选择“显示简介”，勾选“覆盖恶意软件保护”。如果仍无法打开，再在终端执行：
sudo spctl --master-disable
sudo xattr -d com.apple.quarantine /Applications/jetbrains.app
sudo spctl developer-mode enable-terminal也可以参考下面两个视频，根据你的系统提示选择对应方案：
卸载后再次安装异常
macOS 用户不建议使用第三方卸载软件清理工具箱。第三方卸载工具可能会删除关联文件，导致再次安装或使用时出现异常。
如果已经用第三方工具清理过，请重新安装工具箱，并重新授予 完全磁盘访问权限 和 App 管理 权限。
Linux 问题
安装不上或打不开
Linux 安装失败或无法打开，通常是系统缺少依赖。请优先查看终端报错，并根据报错安装对应依赖。
Debian、Ubuntu 等发行版建议优先使用 .deb 安装包：
sudo apt-get install ./jetbrains_{version}_linux_amd64_webkit2_41.deb其他发行版可以尝试 AppImage：
chmod u+x jetbrains_{version}_linux_amd64.AppImage
./jetbrains_{version}_linux_amd64.AppImageNvidia 驱动环境下无法启动或段错误
如果使用 Nvidia 专有驱动，并遇到段错误或工具箱无法启动，可能与 WebKit2Gtk 的 DMABUF 渲染有关。
可以尝试在 /etc/environment 或其他环境变量配置位置加入：
WEBKIT_DISABLE_DMABUF_RENDERER=1保存后重新登录系统，再打开工具箱。
反馈问题时请提供什么
如果你在本页没有找到对应问题，请反馈时尽量提供以下信息：
- 使用的系统：Windows、macOS 或 Linux，以及系统版本。
- 电脑架构：x64、ARM64、Apple 芯片或 Intel 芯片。
- 下载的安装包名称。
- 工具箱版本。
- JetBrains 软件名称和版本。
- 报错截图或完整提示文字。
- 你已经尝试过的处理步骤。
信息越完整，越容易判断问题原因。