必须用官方.tar.gz包解压至/opt目录，通过chmod +x赋予pycharm.sh执行权限，配置jetbrains-pycharm.desktop桌面文件并运行update-desktop-database；新版PyCharm自带JBR无需系统Java，首次启动需等待30–60秒索引构建。
必须用官方.tar.gz包，别碰Snap或APT
PyCharm 在 Linux 上不是传统“安装”软件，而是解压即用的二进制包。Snap 和 APT 仓库里的版本通常滞后至少一个大版本，专业版功能被阉割，更新节奏不受控——你改完配置、调好插件，某天系统自动升级后突然缺功能或闪退，排查成本远高于手动部署。
直接去 https://www.jetbrains.com/pycharm/download/ 下载 pycharm-community-2025.2.tar.gz（或对应最新版），别点“Linux (Snap)”或“Debian/Ubuntu package”链接。
- 下载后检查文件完整性：运行
sha256sum pycharm-community-2025.2.tar.gz，比对官网页面下方提供的校验值 - 不要解压到
~/Downloads或/tmp：路径含空格或权限不稳定，后续桌面快捷方式和Exec=路径容易失效 - 目标目录严格限定为
/opt：这是 Linux FHS 标准规定的第三方系统级软件位置，GNOME/KDE 启动器识别更可靠
解压后权限和路径必须一步到位
解压命令本身不难，但漏掉 sudo 或写错目标路径，pycharm.sh 就会报 Permission denied 或找不到 jbr/ 目录。
- 执行：
sudo tar -xzf pycharm-community-2025.2.tar.gz -C /opt - 解压后检查归属：
ls -ld /opt/pycharm-community-2025.2，若显示属主是root，运行sudo chown -R $USER:$USER /opt/pycharm-community-2025.2 - 确认
pycharm.sh可执行：ls -l /opt/pycharm-community-2025.2/bin/pycharm.sh，输出中应有x权限位；没有就补上：chmod +x /opt/pycharm-community-2025.2/bin/pycharm.sh - 新版 PyCharm（2024.1+）自带 JetBrains Runtime（JBR），不需要系统 Java；删过
jbr/目录或改过pycharm64.vmoptions才会触发No Java报错
桌面快捷方式必须放对位置、写对字段
在桌面直接 touch pycharm.desktop 编辑再双击，大概率弹出“Untrusted application launcher”警告且无法固定到任务栏——GNOME/KDE 现在只认 ~/.local/share/applications/ 下的标准命名文件。
- 正确路径：
~/.local/share/applications/jetbrains-pycharm.desktop -
Icon=必须指向真实图标文件：Icon=/opt/pycharm-community-2025.2/bin/pycharm.svg（注意大小写，.svg比.png渲染更清晰） -
Exec=必须用绝对路径并加双引号：Exec="/opt/pycharm-community-2025.2/bin/pycharm.sh" %f - 编辑完运行：
chmod +x ~/.local/share/applications/jetbrains-pycharm.desktop，然后执行：update-desktop-database ~/.local/share/applications
第一次启动卡住？多半是索引没跑完
点击 pycharm.sh 后界面停在欢迎页、无响应、CPU 占用高——这不是崩溃，是后台在扫描系统 Python 解释器、构建符号索引、加载插件缓存。等 30–60 秒，别反复点“New Project”或关掉重试。
- 如果超过 2 分钟仍无反应，检查是否在 Wayland 会话下：登录界面右下角选 “Ubuntu on Xorg” 再试（尤其 Intel 核显或 NVIDIA 闭源驱动用户）
- 黑屏或窗口空白？临时禁用硬件加速：
/opt/pycharm-community-2025.2/bin/pycharm.sh --disable-factory-reset - 启动后立刻配解释器：Settings → Project → Python Interpreter → Add → Conda Environment 或 System Interpreter，别依赖默认的
/usr/bin/python3（可能太旧或没 pip）
