工具鏈：Visual Studio

本頁於 2026-09 以 Visual Studio Community 2026 18.10（MSVC 工具集 14.51.36231）驗證，x86 與 x64 兩種架構都實際編譯並載入主程式確認。

已經裝了 Visual Studio 的話，直接用它，不用另外裝編譯器。x86 與 x64 兩種架構都支援。

名稱提醒：建置車道的名字叫 vs2022，但它不限 2022 版。 這個名字是歷史沿用， build.bat 是用 Visual Studio 自己的定位工具 vswhere 找「最新的、裝了 C++ 工具的」 Visual Studio，所以 2022、2026 都會被找到（本頁用 2026 驗證）。

下載與安裝

1. 到 Visual Studio 下載頁 ，下載 Community（個人與小型團隊免費）的安裝程式。
2. 執行安裝程式，在「工作負載」畫面勾選 使用 C++ 的桌面開發 （英文介面是 Desktop development with C++），然後安裝。 其他工作負載不需要。
3. 裝完不用開 Visual Studio，也不用開「Developer Command Prompt」。 build.bat 會自己叫出編譯環境。

已經裝過 Visual Studio 但沒勾這個工作負載：開「Visual Studio Installer」，按已安裝版本的 修改，補勾即可。

build.bat 怎麼找到它

1. 執行 vswhere.exe（Visual Studio Installer 隨附，位置固定在 C:\Program Files (x86)\Microsoft Visual Studio\Installer\），要求「最新版本、且有 VC.Tools.x86.x64 元件」，取得安裝路徑。
2. 找不到才退而逐一檢查 2022 的 BuildTools／Community／Professional／Enterprise 標準路徑。
3. 對那個安裝呼叫 vcvarsall.bat，依你要求的架構設定好編譯環境，再呼叫 cl.exe。

build.bat 不會沿用你目前視窗裡已經設好的 Developer Prompt 環境：那個環境有自己的 架構，沿用會悄悄忽略你要的架構。所以在一般命令提示字元、Developer Command Prompt 裡跑， 結果一樣。

建置與驗證

在 plugins\hello_ic\ 的命令提示字元：

build.bat vs2022 x64 release
build.bat vs2022 x86 release

成功時最後一行：

[ OK ] plugin built: plugins\hello_ic.dll  (vs2022 x64 release)

中間會看到 cl 印出的檔名，以及一行「正在建立程式庫 obj\hello_ic.lib …」（英文介面是 Creating library），這是正常的，那些檔案留在 obj\，不會弄髒 plugins\。

編完怎麼載進主程式，見步驟 1。

常見問題

Visual Studio 2022 with the C++ build tools was not found：沒裝或沒勾 「使用 C++ 的桌面開發」。訊息裡寫 2022 只是沿用舊名，照上面補裝工作負載即可。

vcvarsall.bat x64 failed：安裝不完整。build.bat 會重跑一次並印出完整輸出， 通常是缺元件；用 Visual Studio Installer 選「修復」。

中文警告或編譯訊息亂碼：編譯器訊息依你的 Windows 顯示語言輸出，不影響結果， 看 [ OK ] 那一行就知道成敗。