Ubuntu如何调试PHPStorm

在 Ubuntu 上调试 PhpStorm，通常分为两类需求：
1️⃣ 调试 PhpStorm 本身（卡顿、崩溃、插件问题）
2️⃣ 在 PhpStorm 中调试 PHP 程序（Xdebug / Zend Debugger）

下面我按常见场景给你一个完整说明。

一、调试 PhpStorm 本身（Ubuntu 环境）

1️⃣ 查看 PhpStorm 日志

PhpStorm 的运行日志对排查问题非常重要。

~/.cache/JetBrains/PhpStorm<version>/log/

常见文件：

• idea.log —— 主日志
• threadDumps-*.txt —— 卡死时线程快照

查看日志：

less ~/.cache/JetBrains/PhpStorm2023.3/log/idea.log

2️⃣ 启动 PhpStorm 看终端报错

如果你是从命令行启动的：

phpstorm

或：

/opt/phpstorm/bin/phpstorm.sh

这样可以直接看到 Java 抛出的异常信息。

3️⃣ 调整 JVM 参数（卡顿 / 内存问题）

编辑：

~/.config/JetBrains/PhpStorm<version>/phpstorm64.vmoptions

常见优化：

-Xms1024m
-Xmx2048m
-XX:ReservedCodeCacheSize=512m

修改后重启 PhpStorm。

4️⃣ 禁用插件排查

如果 PhpStorm 经常崩溃：

• Help → Diagnostic Tools → Disable All Plugins
• 逐个启用插件定位问题

二、在 Ubuntu 下用 PhpStorm 调试 PHP（最常见）

✅ 推荐方案：Xdebug + PhpStorm

1️⃣ 安装 Xdebug

sudo apt update
sudo apt install php-xdebug

检查：

php -v

应看到类似：

with Xdebug v3.x

2️⃣ 配置 Xdebug（php.ini）

找到 php.ini：

php --ini

编辑：

[xdebug]
zend_extension=xdebug.so
xdebug.mode=debug
xdebug.client_host=127.0.0.1
xdebug.client_port=9003
xdebug.start_with_request=yes

重启 PHP 服务（根据环境）：

sudo systemctl restart apache2
# 或
sudo systemctl restart php8.x-fpm

3️⃣ 配置 PhpStorm

1. Settings → PHP → Debug
   • Debug port：9003
2. Settings → PHP → Servers
   • 添加你的项目
   • Host：localhost
   • Port：80 / 443
3. 右上角点击 电话图标（Start Listening for PHP Debug Connections）

4️⃣ 设置断点并调试

• 在代码行号左侧点击打断点
• 浏览器访问页面
• PhpStorm 会弹出调试窗口

三、命令行 PHP 调试（CLI）

export XDEBUG_SESSION=1
php your_script.php

或在 PhpStorm 中：

• Run → Edit Configurations → PHP Script

四、常见 Ubuntu + PhpStorm 问题

❌ PhpStorm 打不开

java -version

确保 JDK 17+（PhpStorm 自带 JBR，一般不用单独装）

❌ 端口被占用

sudo lsof -i :9003

❌ 中文输入法问题

sudo apt install ibus

五、如果你愿意，我可以更精确帮你

你可以直接告诉我：

1. Ubuntu 版本（20.04 / 22.04 / 24.04）
2. PhpStorm 版本
3. 是 PhpStorm 卡 / 崩溃，还是 PHP 断点不生效
4. 用的是 Apache / Nginx / PHP-FPM

我可以一步一步给你定制调试方案 ✅