Atom 本身不支持 PHP 调试，需依赖 Xdebug 扩展和 atom-debug-ui、php-debug 插件协同工作；必须正确配置 php.ini 中 Xdebug（v2.9 或 v3.x），重启 Web 服务，并手动启动监听后通过 URL 触发调试。
Atom 本身不支持 PHP 调试，必须借助外部工具链
Atom 是一个纯文本编辑器，没有内置 PHP 解释器或调试器（如 Xdebug）。直接双击打开 .php 文件只会显示源码，无法单步断点、查看变量或监听请求。所谓“调试”，实际是让 Atom 作为 Xdebug 的前端界面，靠本地 PHP 环境（含 Xdebug 扩展）和调试插件协同工作。
安装 atom-debugger 和 php-debug 插件是基础前提
Atom 需要通过社区插件桥接 Xdebug。核心组合是：atom-debug-ui（UI 框架） + php-debug（Xdebug 协议适配器）。注意：php-debug 不是 php-debugger 或其他名字相近的插件，装错就无法连接。
- 在 Atom 中按
Cmd+,（macOS）或Ctrl+,（Windows/Linux）打开设置 → Install → 搜索并安装：atom-debug-ui、php-debug - 安装后重启 Atom，否则插件不激活
-
php-debug依赖系统 PATH 中存在php命令；运行php -v和php --ini确认 PHP 可执行且配置路径正确
PHP 必须启用并正确配置 Xdebug（v2.9 或 v3.x）
这是最容易卡住的环节：Atom 只是“显示器”，Xdebug 才是“摄像头”。如果 Xdebug 没加载、端口不通、或版本协议不匹配，Atom 就收不到任何调试信号。
- 运行
php -m | grep xdebug确认扩展已载入；若无输出，需先编译或启用 Xdebug - Xdebug 3.x 默认使用
port=9003，且xdebug.mode=debug；旧版（v2.9）用xdebug.remote_enable=1和xdebug.remote_port=9000 - 关键配置项必须写进
php.ini（不是php.ini-development等副本），例如 Xdebug 3：zend_extension=xdebug<br>xdebug.mode=debug<br>xdebug.client_host=127.0.0.1<br>xdebug.client_port=9003<br>xdebug.start_with_request=yes
- 改完
php.ini后务必重启 Web 服务（如 Apache）或 CLI PHP 进程
启动调试前必须手动开启监听，并确保 URL 触发 Xdebug
Atom 的 php-debug 插件不会自动拉起 PHP 进程，它只被动等待 Xdebug 主动连接。你得自己触发 PHP 执行，且让 Xdebug 知道该连谁。
立即学习“PHP免费学习笔记（深入）”；
- 在 Atom 中打开项目根目录（File → Add Project Folder），不能只打开单个
.php文件 - 点击右下角调试栏的
Start Debugging按钮（或按Cmd+Shift+P→ 输入PHP Debug: Start Listening） - 此时 Atom 在
9003端口等待连接；用浏览器访问http://localhost/your-script.php?XDEBUG_SESSION_START=atom（Xdebug 3 需加&XDEBUG_SESSION_START=1或配合浏览器插件） - 如果没反应，检查：Xdebug 日志（
xdebug.log）、Atom 控制台（View → Developer → Toggle Developer Tools → Console）、以及是否被防火墙拦截9003端口
真正卡住的地方往往不在 Atom 设置，而在 PHP 环境是否真实跑通了 Xdebug 连接 —— 很多人配了半天 php.ini，却忘了重启 Apache，或者误把 CLI 的 php.ini 当成 Web 的用。
