前言

HBuilderX (原 HBuilder) 內建 PHP 語法提示與調試功能，配合 WAMP/XAMPP 的 Xdebug 即可實現斷點除錯。本文以 WAMP 為例完整記錄流程。

步驟

1. 下載安裝 HBuilderX：https://www.dcloud.io/hbuilderx.html
   
2. 開啟 WAMP Xdebug：左鍵 WAMP 圖示 → PHP → PHP 擴展 → 勾選 xdebug，等待服務重啟（約 10 秒）。
   
3. 建立專案：檔案 → 新建 → 專案 → 選擇 PHP 專案，目錄指向 WAMP www 下資料夾。
   
4. 新建 PHP 檔案並設定斷點：行號左側雙擊出現紅點。
   
5. 啟動調試：編輯區右鍵 → 調試方式 → PHP Server。
   
6. 首次配置：彈出視窗確認 PHP 執行路徑、網站根目錄、URL 前綴，點擊確定。
   
7. 瀏覽器自動開啟對應 URL，HBuilderX 切換到調試面板，變數、呼叫堆疊、監視表單一俱全。
   
8. 結束調試：點擊紅色方塊 □ 停止，右上角切回開發視圖。

注意事項

• 調試檔案**必須在專案目錄下**，否則無法對應路徑映射。
• Xdebug 版本需與 PHP 版本對應（VC 編譯、TS/NTS、位元數）。
• 防火牆需放行 9000 埠（Xdebug 預設）。
• HBuilderX 內建伺僅供靜態預覽，**PHP 調試仍依賴外部 WAMP/XAMPP 環境**。

總結

HBuilderX 提供輕量級 PHP 開發體驗，適合習慣國產 IDE 的開發者；專業團隊仍建議 PhpStorm/VS Code + Docker 獲得最佳生態支援。