iOS 用 XIB 自訂 TableViewCell 裡的按鈕點不了？三步排查法

現象：iPad 模擬器 7.1 上，XIB 客製 Cell 內的 UIButton 完全無反應

點擊按鈕沒有任何觸發事件，也沒有高亮狀態變化，彷彿按鈕不存在。

核心排查三步驟

1. 確認按鈕上方沒有其他 View 遮擋

• 在 Xcode 的 Debug View Hierarchy（執行時點選工具列的三層圖示）檢查視圖層級。
• 常見情況：contentView 上疊加了透明的 UIImageView、UIView、或 label 的 frame 超出預期，攔截了觸控事件。
• 解決：調整 subview 順序（bringSubviewToFront）、縮小遮擋 view 的 frame、或設定遮擋 view 的 userInteractionEnabled = NO。

2. 確認按鈕的超視圖能夠響應互動

• 按鈕的超視圖鏈：UIButton → cell.contentView → cell → tableView → ...
• 若 cell.contentView.userInteractionEnabled = NO 或 cell.userInteractionEnabled = NO，觸控事件傳遞鏈中斷，按鈕永遠收不到事件。
• 檢查 XIB 中 Cell 與 Content View 的 User Interaction Enabled 核取方塊是否勾選（預設應為勾選）。

3. 確認 Action 正確綁定、並在 Action 打斷點除錯

• 在 XIB 中按住 Control 拖曳按鈕到 .m/.swift 檔，選 Action、事件選 Touch Up Inside。
• 在產生的 Action 方法第一行打斷點，執行專案點擊按鈕，觀察是否命中。
• 若斷點不命中 → 事件未傳遞到按鈕（回頭檢查 1、2）。若命中但邏輯不執行 → 程式碼邏輯錯誤。

常見陷阱補充

快速檢查清單

1. ☐ Debug View Hierarchy 確認無遮擋
2. ☐ Cell / Content View / Button 皆 userInteractionEnabled = YES
3. ☐ Action 綁定 Touch Up Inside，斷點能命中
4. ☐ 無衝突手勢識別器，或已設 cancelsTouchesInView = NO
5. ☐ 真機測試排除模擬器專屬問題

結語

XIB 裡的按鈕點不了，**90% 是視圖層級遮擋或 userInteractionEnabled 鏈路中斷**。善用 Debug View Hierarchy 一眼看穿結構，配合 Action 斷點 驗證事件傳遞，幾分鐘就能定位問題。別再盲目猜測，工具才是最高效的除錯夥伴。