工具鏈：gcc（w64devkit）

本頁於 2026-09 以 w64devkit 2.6.0（GCC 15.2.0、binutils 2.46，目標 x86_64-w64-mingw32）驗證，x64 實際編譯並載入主程式確認。

如果你已經習慣 gcc，或不想裝 llvm-mingw，可以用這一條。限制：這條車道只能編 64 位元。 要 32 位元的 Plugin，請改用 llvm-mingw 或 Visual Studio（見架構要對）。

這一頁講的是 w64devkit：一個免安裝的 gcc 套件，解壓就能用。其他 MinGW-w64 發行版 （MSYS2 的 mingw64 等）只要 gcc.exe 與 windres.exe 在 PATH 上、目標是 64 位元， 做法相同。

下載與安裝

1. 到 w64devkit 的 Releases 頁 ， 下載 w64devkit-x64-<版本>.7z.exe（撰寫本頁時最新的是 w64devkit-x64-2.10.0.7z.exe； 同頁另有 w64devkit-x86-... 是給 32 位元 Windows 用的，不要選它）。它是自解壓縮的 7z 檔。

2. 執行它，選一個解壓位置，例如 C:\tools。會產生 w64devkit\ 資料夾，裡面有 bin\。 不需要系統管理員權限，不動登錄檔。

3. 確認裝好了：開命令提示字元，執行

   C:\tools\w64devkit\bin\gcc --version

   應該印出 gcc.exe (GCC) ...。

build.bat 怎麼找到它

gcc 車道沒有專用的環境變數：它就是執行 PATH 上第一個 gcc.exe， 並要求 PATH 上也找得到 windres.exe（編 .rc 版本資源用；每個 MinGW-w64 發行版都跟 gcc.exe 放在同一個 bin\，所以讓那個 bin\ 上 PATH 就一併解決）。所以要做的事只有一件：讓 w64devkit\bin 出現在 PATH 上。

暫時的做法（只影響這個命令提示字元視窗，最不會弄亂系統）：

set "PATH=C:\tools\w64devkit\bin;%PATH%"

也可以寫進 plugins\hello_ic\toolchain.local.bat（複製自 toolchain.local.bat.sample）， 每次 build.bat 開頭會自動執行：

set "PATH=C:\tools\w64devkit\bin;%PATH%"

建置與驗證

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

build.bat gcc x64 release

成功時：

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

編完怎麼載進主程式，見步驟 1。主程式要用 64 位元版。

常見問題

gcc.exe was not found on PATH：PATH 沒設好。在同一個視窗打 gcc --version 確認。

windres.exe was not found on PATH：PATH 上找不到 windres.exe（build.bat 是用 where 在 PATH 上找它，不是看 gcc.exe 旁邊）。多半是你的 gcc.exe 來自一個不完整的 MinGW-w64 發行版；換成 w64devkit，或把有 windres.exe 的 bin\ 也加進 PATH。

gcc on this platform targets x64 only： 你下了 build.bat gcc x86。這條車道不支援 32 位元，build.bat 會直接拒絕而不是 偷偷編成 64 位元（那樣你會拿到一個載不進 32 位元主程式的 DLL，而且完全沒有錯誤訊息）。