Borland C++ 3.1 建立專案完整圖文教學：從工作目錄設定到多檔案模組化開發

Borland C++ 3.1 建立專案完整圖文教學：從工作目錄設定到多檔案模組化開發

雖然 Borland C++ 3.1（BC31）是 90 年代的經典編譯器，但許多學校教學仍指定使用，目的是讓學生體驗「手動管理專案結構、編譯連結流程」的底層細節。本教學將完整記錄：工作目錄規劃、目錄設定、建立專案、三種加入原始檔方式、標頭檔管理、輸出目錄分離、以及跨目錄專案架構的實作步驟。

一、建立工作目錄：養成良好習慣的第一步

請勿將程式碼直接放在 C:\BORLAND\BIN。請在虛擬 C 盤（DOSBox 掛載的 DISK_C）根目錄建立專屬資料夾，例如 C:\test，並依專案規模再建立 source、include、obj 子目錄。

二、設定 BC31 目錄路徑：讓編譯器找到你的檔案

1. 變更目前工作目錄： 選單 File > Change Dir...，輸入 C:\test。
2. 固定預設工作目錄： 編輯 DOSBox 設定檔 bc31.conf，將最後幾行的 cd \BORLANDC\BIN 註解掉，改為 cd \test，重啟 BC31 即永久生效。
3. 設定輸出與原始碼目錄： 選單 Options > Directories：
   • Include Directories：C:\BORLANDC\INCLUDE（保留預設）
   • Library Directories：C:\BORLANDC\LIB（保留預設）
   • Output Directory：C:\test\obj（存放 .obj、.exe 等中間檔）
   • Source Directory：C:\test\source（存放 .c、.h）

三、建立空專案

1. 選單 Project > Open Project...，輸入專案名 test.prj，儲存於 C:\test。
2. 此時專案視窗（下方藍色區域）為空，尚無任何檔案。

四、三種加入原始檔的方法

方法一：先用內建編輯器寫好，再加入專案

1. File > New 建立新檔，撰寫程式碼（如 test.cpp 實作加法）。
2. File > Save 儲存至 C:\test\source。
3. 將游標移至專案視窗（出現綠色游標列），選單 Project > Add Item，選取剛存好的檔案，點 Add 後按 Done。

方法二：直接在專案中新建檔案

1. 游標定位至專案視窗（綠色游標列）。
2. Project > Add Item，直接在 Name 欄輸入檔名（如 test1.cpp），點 Add。
3. 專案列表出現檔案名，雙擊即可編輯。

方法三：使用外部編輯器（推薦 Notepad++），再加入專案

1. 用 Notepad++ 撰寫 test2.cpp、test2.h 等檔案，存入 C:\test\source、C:\test\include。
2. 開啟 BC31，Window > Project 顯示專案視窗。
3. Project > Add Item，BC31 會自動列出目錄下的檔案，直接加入即可。

五、多檔案模組化實作範例

/* test.cpp - 主程式 */
#include <stdio.h>
#include "test1.h"
#include "test2.h"

int main() {
    printf("Add: %d\n", add(3,5));
    printf("Sub: %d\n", sub(10,4));
    printf("Mul: %d\n", mul(6,7));
    printf("Div: %d\n", div(20,4));
    return 0;
}

/* test1.h */
int add(int a, int b);
int sub(int a, int b);

/* test1.cpp */
#include "test1.h"
int add(int a, int b) { return a + b; }
int sub(int a, int b) { return a - b; }

/* test2.h */
int mul(int a, int b);
int div(int a, int b);

/* test2.cpp */
#include "test2.h"
int mul(int a, int b) { return a * b; }
int div(int a, int b) { return a / b; }

關鍵點： 自訂標頭檔引用需用雙引號 #include "test1.h"，表示從目前工作目錄或原始碼目錄尋找。

六、進階：分離 source 與 include 目錄

實務上將 .c 放 source/，.h 放 include/。此時編譯會報錯「找不到標頭檔」，解決兩種方法：

1. 修改原始碼相對路徑： #include "../include/test1.h"
2. 在 Options > Directories > Include Directories 追加： C:\test\include（推薦，不侵入原始碼）

💡 核心觀念： 「程式是死的，路徑不告訴它，它就找不到。」無論是標頭檔、資源檔、資料檔，所有涉及路徑的設定都必須明確指定，這是從 BC31 到現代 CMake、VS 專案通用的鐵律。