Skip to main content
用户指南

常见问题

排查常见问题。

远程桌面中 IntelliJ IDEA 卡死或白屏怎么办？

通过 XRDP、VNC、X11 Forwarding 或 NoMachine 等方式连接远程 Linux 桌面后，如果 IntelliJ IDEA 出现界面卡死、白屏或无响应，可能是 Java 2D 硬件加速与远程图形驱动不兼容。可以尝试关闭相关渲染加速选项。
  1. 在远程环境中的 IntelliJ IDEA 选择 Help > Edit Custom VM Options。
  2. 在文件末尾添加以下参数。如果已有同名参数，修改原有值，避免重复配置。
-Dsun.java2d.opengl=false
-Dsun.java2d.xrender=false
-Dsun.java2d.pmoffscreen=false
  1. 保存文件并重启 IntelliJ IDEA，检查界面是否恢复正常。
如果界面无法操作，可以编辑对应版本的自定义 VM 参数文件。Linux 下的路径通常为 ~/.config/JetBrains/<Idea-Version>/idea64.vmoptions，请将 <Idea-Version> 替换为实际版本目录。 这些参数关闭 OpenGL、XRender 和离屏 pixmap 相关渲染选项，用于排查远程图形环境的兼容性问题。

JetBrains Gateway 中中文显示为方框怎么办？

通过 JetBrains Gateway 连接 Linux 远程开发环境时，如果 Qoder 回复中的中文显示为方框（“豆腐块”），请检查远程 Linux 服务器是否安装了中文字体并配置了字体回退。 Qoder 文本使用 IDE 的界面字体，和代码编辑区字体不同。Inter 不包含中文字形；SansSerif 是逻辑字体，其中文显示依赖系统字体及回退配置，因此仅修改编辑器字体未必能解决问题。 1. 在远程服务器安装中文字体 按远程服务器的发行版选择命令，需要相应的软件安装权限。 Red Hat 
sudo yum install fontconfig
sudo yum install google-noto-sans-cjk-ttc-fonts google-noto-serif-cjk-ttc-fonts
Ubuntu 
sudo apt update
sudo apt install fontconfig
sudo apt install fonts-noto-cjk fonts-noto-cjk-extra
2. 配置字体回退 使用运行远程 IDE 的用户，在其用户目录下创建 ~/.config/fontconfig/fonts.conf。如果文件已存在，将下列规则合并到已有的 <fontconfig> 元素中，保留其他配置。 
<?xml version="1.0"?>
<!DOCTYPE fontconfig SYSTEM "fonts.dtd">
<fontconfig>
  <match target="pattern">
    <test name="family"><string>Inter</string></test>
    <edit name="family" mode="append" binding="strong">
      <string>Noto Sans CJK SC</string>
    </edit>
  </match>
  <alias>
    <family>SansSerif</family>
    <prefer><family>Noto Sans CJK SC</family></prefer>
  </alias>
  <alias>
    <family>sans-serif</family>
    <prefer><family>Noto Sans CJK SC</family></prefer>
  </alias>
  <alias>
    <family>serif</family>
    <prefer><family>Noto Serif CJK SC</family></prefer>
  </alias>
</fontconfig>
该配置为 Inter 追加中文回退字体，并为 SansSerif、sans-serif 和 serif 设置中文字体映射。 3. 刷新字体缓存并检查匹配结果 
fc-cache -fv
fc-match Inter
fc-match SansSerif
fc-match 'sans-serif:lang=zh-cn'
检查中文匹配是否能找到 Noto Sans CJK SC。fc-match Inter 可能仍返回 Inter，因为它仍是首选字体；这并不表示中文回退失效。 4. 重启远程 IDE 实例 重启 Gateway 连接的远程 IDE 实例，重新连接后向 Qoder 提问，检查中文是否正常显示。

JetBrains 插件更新后，本地服务连不上或修复失败

  1. 如果 IDE 提示重启以完成插件更新，请保存工作并重启当前 IDE。
  2. 重新打开项目后，如果 Qoder 仍然连不上，在插件工具窗口中打开 问题上报 > 自助排查 > 一键修复本地服务。
  3. 结束正在进行的 Qoder 任务，点击 开始修复。修复期间，共用该服务的其他 IDE 会暂时断开。
  4. 看到“本地服务已修复并启动”后，回到对话窗口，重新发送之前失败的问题。如果提示当前服务仍可用，也可以先继续工作，稍后再修复。
如果修复未完成，请根据提示处理：
  • 旧服务无法停止或提示权限不足：保存工作并退出当前 IDE。如果电脑上还开着 IntelliJ IDEA、PyCharm、GoLand 等其他 JetBrains IDE，或同一 IDE 的其他项目窗口，也请一并退出。然后只启动一个 IDE、打开一个项目，再次运行修复。
  • 安装失败：检查磁盘剩余空间，以及插件设置中 本地存储路径 的读写权限。
  • 版本不一致：将共用该服务的 IDE 中的对应插件更新到同一版本，按提示重启 IDE。
如果以上操作后仍未恢复，建议在方便时保存工作并重启电脑，帮助释放可能残留的后台进程。重启后先只打开一个 IDE、一个项目，检查连接，必要时再次运行修复。 如果重启后 Windows 仍提示权限不足，且电脑由公司统一管理，请联系公司 IT 支持人员，协助检查本地软件运行权限。 仍然无法使用时，在 问题上报 窗口下方的 问题反馈 中填写故障发生时间、IDE 和插件版本，并附上完整错误提示。提交后，将问题 ID 提供给 Qoder 技术支持，方便进一步排查。