Eclipse CDT GDB 調試「No source file named」問題完整解決方案

問題根因分析

Eclipse CDT 使用 GDB 調試 C++ 時，常出現「No source file named」錯誤導致斷點無法生效。根本原因是路徑分隔符差異：Unix 使用 /，Windows 使用 \（C/C++ 轉義字元），GDB 從 Unix 移植到 Windows 時路徑解析發生轉義錯誤。

解決方案：修改 GDB 來源搜尋路徑

1. 開啟 Windows → Preferences
2. 展開 C/C++ → Debug → GDB
3. 在 Source lookup path 區域新增項目
4. 選擇 Path Relative to Source Folders（相對於原始碼資料夾的路徑）
5. 套用並重新啟動調試

原理解析

• 相對路徑優先：避免多層絕對路徑中的反斜線轉義問題
• 源碼資料夾基準：GDB 以專案源碼目錄為基準解析相對路徑
• 跨平台相容：此設定同時相容 Windows 原生與 Cygwin/MinGW 環境

替代方案

# 在 .gdbinit 中設定（專案根目錄）
set substitute-path /build/src /home/user/project/src
# 或使用目錄映射
directory /home/user/project/src

此設定一次配置永久生效，徹底解決 Eclipse CDT Windows 環境下 GDB 找不到源碼檔案的經典問題。