NetBeans IDE 從現有 C/C++ 代碼建立專案與程式碼輔助配置指南

為什麼需要從現有代碼建立專案？

IDE 的核心職責是建立程式碼模型，支援程式碼自動完成、超連結導航、符號跳轉等功能。模型建構需要編譯資訊：編譯檔案、編譯器選項、包含路徑、巨集定義。對於複雜開源專案，Makefile 架構龐大、包含 Shell 腳本、依賴前序建構產出，靜態分析極其困難。

NetBeans 提供替代方案：從編譯器除錯資訊（DWARF 格式）反推專案配置，來源可為：

• 物件檔（.o）
• 靜態/動態函式庫（.a/.so）
• 可執行檔

實戰流程：以 MySQL 專案為例

步驟 1：以除錯旗標編譯專案

./configure CFLAGS="-g3 -gdwarf-2" CXXFLAGS="-g3 -gdwarf-2"
make

• -g3：最大化除錯資訊，包含巨集定義
• -gdwarf-2：使用 DWARF v2 格式（NetBeans 偏好）

若 Makefile 不支援環境變數，需直接修改 Makefile 或匯出變數：

export CFLAGS="-g3 -gdwarf-2"
export CXXFLAGS="-g3 -gdwarf-2"

步驟 2：建立 NetBeans 專案

1. File → New Project → C/C++ → C/C++ Project with Existing Sources
2. 指定主 Makefile 位置（確保 IDE 可建構）
3. Build Actions 指定可執行檔路徑（可稍後補填）
4. 關鍵步驟：Code Assistance Configuration 頁面，IDE 根據除錯資訊自動推導包含路徑與巨集
5. 選擇 Configuration Level：Project Level（合併至專案屬性）或 File Level（逐檔案）
6. 專案儲存位置（預設家目錄下 nbproject/，與原始碼分離，利於版控）

常見問題解決

如何手動編輯包含路徑與巨集？

專案/邏輯資料夾/檔案右鍵 Properties → Code Assistance → C/C++ Compiler → General。屬性可繼承：專案 → 資料夾 → 檔案。

如何偵測配置錯誤？

專案節點右上角出現藍底問號，右鍵 Code Assistance → Show Failed #includes 查看未解析的包含路徑。

現有專案可重新配置嗎？

可。重新以除錯旗標建構原始碼，專案右鍵 Code Assistance → Configure Code Assistance。兩種模式：

• Simple：重複新建專案邏輯
• Advanced：可選擇掃描來源（建構產出/物件檔/手動指定），提供分析預覽

支援多平台/裝置配置嗎？

支援。專案屬性 Configurations 管理多組配置，每組可獨立執行配置嚮導，指定對應平台的建構產出。

核心原理總結

NetBeans 透過讀取 ELF/DWARF 除錯區段，提取每個編譯單元的編譯器呼叫完整命令列，反解出：

• 編譯器路徑與版本
• 系統/使用者包含路徑（-I/-isystem）
• 前置定義巨集（-D）
• 語言標準（-std=）

未參與建構的檔案標記為 Excluded from Code Assistance，不影響模型效能。