MASM for Windows 整合環境：僅生成 .asm/.obj 無法執行，完整建置流程修正

問題現象

• MASM for Windows 整合實驗環境
• 編譯後**只有 `.asm` (源碼) 和 `.obj` (目標檔)**
• **缺少 `.exe` 可執行檔** → 無法運行

根因：缺少連結步驟

組語開發完整流程：**編譯 → 連結 → 執行**
MASM 環境預設可能僅執行 **編譯 (ML.exe → .obj)**，**未自動呼叫連結器 (Link.exe)** 產生 `.exe`。

手動完整建置命令 (命令列)

:: 1. 編譯
ml /c /coff /Cp main.asm
:: 生成 main.obj

:: 2. 連結 (生成 Console 應用程式)
link /subsystem:console /entry:main main.obj kernel32.lib user32.lib
:: 生成 main.exe

:: 3. 執行
main.exe

• `/c`：僅編譯不連結
• `/coff`：輸出 COFF 格式 `.obj` (Win32 標準)
• `/Cp`：保留識別符大小寫
• `/subsystem:console`：主控台子系統
• `/entry:main`：進入點函數名 (需與 `.code` 中 `main proc` 對應)
• `kernel32.lib user32.lib`：基本系統庫 (視 API 呼叫需求加入)

MASM for Windows IDE 內設定自動連結

1. 開啟專案屬性 / 專案選項
2. 尋找 **「建置事件」**、**「自訂建置步驟」** 或 **「連結器」設定**
3. 確認 **「連結」步驟已啟用**，且命令包含 `link.exe` 及正確參數
4. 若無圖形化設定，在 **「建置前/後事件」** 加入上述 `link` 命令

最小可運行範例 (main.asm)

.386
.model flat, stdcall
option casemap:none

include \masm32\include\windows.inc
include \masm32\include\kernel32.inc
include \masm32\include\user32.inc
includelib \masm32\lib\kernel32.lib
includelib \masm32\lib\user32.lib

.data
    msg db "Hello, MASM!", 0
    caption db "提示", 0

.code
main proc
    invoke MessageBox, NULL, addr msg, addr caption, MB_OK
    invoke ExitProcess, 0
main endp

end main

常見坑點檢查表

現代替代方案：Visual Studio + MASM

**強烈建議**直接在 **Visual Studio 2019/2022** 開發 MASM：

1. 安裝 VS 工作負載：「使用 C++ 的桌面開發」
2. 專案 → 右鍵 → `Build Customizations` → 勾選 `masm(.targets, .props)`
3. 新增 `.asm` 檔案，VS 自動處理 `ml.exe` + `link.exe` 完整建置
4. 享受 **IntelliSense、除錯器、斷點、記憶體視窗、暫存器視窗** 完整 IDE 體驗

總結

僅生成 `.asm/.obj` 代表 **缺少連結步驟**。解決方法：**手動執行 `link.exe` 生成 `.exe`、或在 IDE 設定啟用連結器、或改用 Visual Studio 內建 MASM 支援**。組語開發三步驟：`編譯 → 連結 → 除錯`，缺一不可。