Ubuntu22.04下PyCharm启动报错：无法连接已运行实例（进程仍在运行）

成因分析 #

• 进程残留：Ubuntu 22.04桌面环境（如GNOME）下，关闭PyCharm时主进程可能因资源占用、子进程未同步退出等原因残留，导致下次启动时被检测为已运行实例。
• 锁文件未释放：PyCharm会在~/.config/JetBrains/PyCharm<版本号>目录生成PID锁文件，若进程异常退出，锁文件未被自动删除，启动时会误判存在运行实例。
• 桌面启动器异常：系统.desktop启动项可能存在重复触发、进程状态监控失效的情况，引发启动冲突。

解决方案 #

1. 自动清理启动脚本 #

创建替代启动脚本，自动清理残留进程与锁文件：

#!/bin/bash
# 查找并终止PyCharm残留进程
PYCHARM_PID=$(pgrep -f "pycharm.sh" | head -n 1)
if [ -n "$PYCHARM_PID" ]; then
    kill -9 "$PYCHARM_PID"
    sleep 2
fi
# 删除未释放的PID锁文件（替换为你的PyCharm版本目录）
rm -f ~/.config/JetBrains/PyCharm2023.2/pycharm.pid
# 启动PyCharm
/path/to/your/pycharm/bin/pycharm.sh

保存为start_pycharm.sh，赋予执行权限：chmod +x start_pycharm.sh，后续用此脚本启动PyCharm。

2. 修改PyCharm启动脚本 #

打开PyCharm安装目录下的pycharm.sh，在脚本开头添加PID有效性校验逻辑：

# 校验PID锁文件有效性
PID_FILE=~/.config/JetBrains/PyCharm<版本号>/pycharm.pid
if [ -f "$PID_FILE" ]; then
    OLD_PID=$(cat "$PID_FILE")
    # 若PID对应进程不存在，则删除锁文件
    if ! ps -p "$OLD_PID" > /dev/null 2>&1; then
        rm "$PID_FILE"
    fi
fi

启动时可额外添加--no-splash参数，减少启动阶段的进程冲突概率。

3. 修复桌面启动器 #

编辑PyCharm的.desktop文件（路径通常为~/.local/share/applications/jetbrains-pycharm.desktop），将Exec字段替换为上述脚本路径，或添加--new-instance参数强制启动新实例：

Exec=/path/to/start_pycharm.sh

或直接修改为：

Exec=/path/to/pycharm/bin/pycharm.sh --new-instance %f

4. 调整系统进程资源限制 #

若系统进程数限制过低，可能导致PyCharm无法正常退出。检查当前限制：

ulimit -a

若max user processes数值偏低，编辑/etc/security/limits.conf添加：

your_username soft nproc 4096
your_username hard nproc 8192

重启系统后生效。

内容的提问来源于stack exchange，提问作者Matmozaur