Visual Studio 多專案協作：靜態庫專案被主專案引用調用完整配置指南

前言

在 Visual Studio 中將功能模組封裝為靜態庫（.lib），供其他專案引用，是實現代碼復用、模組解耦的標準做法。本文以雙專案為例，詳細記錄從庫專案創建到主專案調用的完整配置流程。

一、專案結構規劃

• test1：靜態庫專案，提供數學運算函數
• test2：主程式專案（控制台應用），調用 test1 函數

二、庫專案 (test1) 創建與配置

1. 創建專案

• 專案類型：Windows 桌面向導 → 靜態庫 (.lib)
• 專案名：test1

2. 編寫頭文件 (test1.h)

// test1.h
#pragma once

#ifdef TEST1_EXPORTS
#define TEST1_API __declspec(dllexport)
#else
#define TEST1_API __declspec(dllimport)
#endif

// 靜態庫實際不需要 dllexport/dllimport，但保留宏便於未來遷移動態庫
int add(int x, int y);
int subtract(int x, int y);

3. 實現源文件 (test1.cpp)

// test1.cpp
#include "test1.h"

int add(int x, int y) {
    return x + y;
}

int subtract(int x, int y) {
    return x - y;
}

4. 關鍵配置：輸出類型為靜態庫

• 專案屬性 → 通用 → 配置類型 → 靜態庫 (.lib)
• 輸出目錄建議統一：$(SolutionDir)lib\$(Configuration)\

三、主專案 (test2) 創建與引用配置

1. 創建主專案

• 專案類型：Windows 桌面向導 → 主控台應用程式
• 專案名：test2
• 勾選「放置解決方案和專案在同一目錄中」

2. 添加專案引用（核心步驟）

1. 右鍵 test2 專案 → 添加 → 參考
2. 在「專案」頁籤勾選 test1 → 確定
3. 此操作自動完成：
   ✅ 連結器 → 輸入 → 附加相依性 添加 test1.lib
   ✅ C/C++ → 一般 → 附加包含目錄 添加 test1 目錄
   ✅ 專案相依性 設置 test2 依賴 test1

3. 編寫主程式 (test2.cpp)

// test2.cpp
#include 
#include "test1.h"  // 因專案引用，無需絕對路徑

int main() {
    std::cout << "3 + 4 = " << add(3, 4) << std::endl;
    std::cout << "5 - 3 = " << subtract(5, 3) << std::endl;
    return 0;
}

四、常見配置問題與解決

五、進階：跨方案引用靜態庫

若 test1 和 test2 在不同解決方案：

1. 編譯 test1 產出 test1.lib + test1.h
2. test2 專案屬性手動配置：
   - C/C++ → 一般 → 附加包含目錄：lib路徑\include
   - 連結器 → 一般 → 附加程式庫目錄：lib路徑\lib
   - 連結器 → 輸入 → 附加相依性：test1.lib
3. 將 test1.lib 複製至輸出目錄或配置後置建置事件自動複製

六、總結檢查清單

1. ✅ 庫專案配置類型 = 靜態庫 (.lib)
2. ✅ 主專案添加專案引用（右鍵 → 添加 → 參考）
3. ✅ 主程式 #include "test1.h" 無需絕對路徑
4. ✅ 同一解決方案下 Debug/Release 配置一致
5. ✅ 修改庫代碼後重新建置庫專案

掌握 VS 多專案靜態庫引用流程，是構建大型 C++ 專案模組化架構的基礎技能。關鍵在於「專案引用」自動處理的三重保障：頭文件路徑、庫文件鏈接、建置順序依賴。