# MASM開發環境設置 - 使用 Visual Studio 與 Irvine 範例

###### tags: `教學` `筆記` `開發環境` `112-1` `112-1 組合語言與系統程式`


## 目錄

[TOC]

## 簡介

本教學配合 *Assembly Language for x86 Processors* 使用MASM，
配合該書作者 Irvine 的範例與函式庫，使用作者提供的專案設定，
介紹 Windows 平台上使用 Visual Studio 簡單快速開始編寫MSAM的方法。

:::success
本文基本設置內容大致與作者自行編寫的教學大同小異，也可直接參考：
[*Getting Started with MASM and Visual Studio 2022*](https://www.asmirvine.com/gettingStartedVS2022/index.htm)
也推薦參考[作者網站](https://www.asmirvine.com/)有更多資源 *(作者也有Visual Studio 2019版本的教學)*
:::

:::info
本文整理自修習組合語言課程時，為了複習與寫作業自行摸索的步驟
如果有任何錯誤或建議，請隨時留言提出
:::

:::warning
請注意，本文撰寫於2023/11，內容未來可能不再適用

:::

## 開發環境基本設置

### 系統需求

* Windows 10/11 64bit
* 4 GB 記憶體
* 20GB儲存空間 (建議)

### 下載與安裝 Visual Studio 2022

1. 進入 [**Visual Studio 官網**](https://visualstudio.microsoft.com/zh-hant/vs/whatsnew/)
2. 選擇下載 **Community 2022** 版本 *(Community為免費版)*
3. 下載完畢後開啟 `VisualStudioSetup.exe`
4. 僅勾選 **`使用C++的桌面開發`** 後點選安裝
5. 等待下載與安裝完畢後重新開機

### 下載與放置 Irvine 範例、函式庫與專案檔案

1. 前往 [**Irvine 的專案 GitHub**](https://github.com/surferkip/asmbook)
2. 下載 [`Irvine.zip`](https://github.com/surferkip/asmbook/blob/main/Irvine.zip)、[`Project32_VS2022.zip`](https://github.com/surferkip/asmbook/blob/main/Project32_VS2022.zip)與[`Project64_VS2022.zip`](https://github.com/surferkip/asmbook/blob/main/Project64_VS2022.zip) 三個壓縮檔
:::info
可以分別點選上述檔案連結後點選右上角`Download raw file`下載 **(建議)**
或在專案頁面點選右上角`Code > Download ZIP`下載整個專案再取出這三個檔案
:::
3. 將三個壓縮檔**解壓縮至此** *(壓縮檔內已經是資料夾，外面不用再包一層)*
4. 將`Irvine`資料夾移到`C:\`下，看起來像是這樣
:::info
`Irvine`資料夾內的`Examples`包含 *Assembly Language for x86 Processors* 書中範例
:::
:::warning
除非會自行更改專案設定，否則請不要改變路徑
:::
5. 將`Project32_VS2022`、`Project64_VS2022`資料夾移到自己喜歡的目錄，例如`C:\Code\`

### 設置 Visual Studio 組譯與除錯

1. 開啟 Visual Studio 2022
2. 若提示登入帳號，可以選擇暫時略過 *(登入帳號未來可在多裝置上同步設定)*
3. 選擇佈景主題後啟動
4. 選擇 **`開啟專案或解決方案`**
5. 選擇先前`Project32_VS2022`資料夾內的`Project.sln`，例如`C:\Code\Project32_VS2022\Project.sln`
* **(重要)** 不是`Project.vcxproj`是`Project.sln`(有可能沒顯示副檔名`Project`)
6. 點開右側方案總管下的`AddTwo.asm`
畫面應該會如下
其中`AddTwo.asm`程式碼如下

    ; AddTwo.asm - adds two 32-bit integers.
    ; Chapter 3 example

    .386
    .model flat,stdcall
    .stack 4096
    ExitProcess proto,dwExitCode:dword

    .code
    main proc
        mov	eax,5				
        add	eax,6				

        invoke ExitProcess,0
    main endp
    end main

7. 在

        mov eax, 5

該行行號左側點一下，設置一個中斷點
8. 按下上方中間的 **`本機Windows偵錯工具`** 或快捷鍵 **`F5`** 開始偵錯
此時應該會跳出一個小黑窗，而程式此時暫停於中斷點如下
9. 點選 **`偵錯 > 視窗 > 暫存器`**
會出現一個暫存器小窗格，可以窗格上側將其放置至喜歡的位置
例如在右下方
10. 在暫存器小窗格上方按右鍵，勾選 **`旗標`**
暫存器窗格將多顯示旗標
:::info
如何透過 **`EFL`***(EFLAGS)* 暫存器觀察常見旗標，請參考[EFLAGS對應位元](https://en.wikipedia.org/wiki/FLAGS_register)
:::
11. 按一下上方中間的 **`逐步執行(不進入函式)`** 或快捷鍵 **`F10`** 使程式執行至下一行
此時執行了這行程式

        mov eax, 5

觀察程式碼處，箭頭變為指向下一行開頭
而暫存器窗格的`EAX`暫存器變為紅色，值變為`00000005`
*(`EIP`暫存器也會改變)*
12. 重複上個步驟，再按一下逐步執行
此時執行了這行程式

        add	eax,6

箭頭往下移動，而暫存器窗格的`EAX`暫存器值變為`0000000B` *(11)*
13. 重複上個步驟，再按一下逐步執行，退出偵錯模式
至此即完成開發環境的基本設置以及偵錯示範
14. 若要編寫程式，可以直接開始修改`AddTwo.asm`
:::info
Visual Studio 編譯、組譯與偵錯是**以方案而非單一檔案**為單位
若要在 Visual Studio 中執行或偵錯其他檔案，在右側方案總管的`AddTwo.asm`上點右鍵，選擇 **`從專案移除`**
*(這不會將檔案刪除，只是從專案中移除)*
在`Project`上 *(**不是**`方案'Project'(1/1個專案)`)*點右鍵，
* 若要建立新檔案，選擇 **`加入 > 新建項目`**，輸入檔名並將副檔名改為 **`.asm`**
* 若要加入已存在的檔案 *(例如：Irvine的課本範例檔)* ，選擇 **`加入 > 現有項目`**，選擇檔案
:::

## Visual Studio 進階設置 (選擇性)

以下步驟皆非必要，但可以改善開發體驗，可自行考量是否操作

### 調整編輯器字體與大小

1. 點選上方 **`工具 > 選項`**
2. 選擇 **`環境 > 字型和色彩`**
3. 將文字編輯器的字型換為其他合適字體
* 最好選擇等寬字體 *(以粗體表示)*
* 推薦選擇內建的 **`Consolas`**
4. 將大小調整為合適大小
* 也可以在編寫時按住 **`Ctrl + 滾輪`** 調整大小
5. 按確定完成調整


|**調整前**|
|:-:|
||
|**調整後**|
||

:::info
Visual Studio 大多數文字的字體與顏色大小等都能修改，可自行摸索
:::

### 加入語法突顯(Syntax highlighting)

使用 **AsmDude2** 延伸模組，其[GitHub頁面](https://github.com/HJLebbink/asm-dude)有詳細說明

1. 點選上方 **`延伸模組 > 管理延伸模組`**
2. 選擇 **`線上`** 後在右上方搜尋輸入 `AsmDude2`
3. 點選下載


4. 關閉 Visual Studio
5. 點選 Modify


6. 安裝完畢後重新開啟 Visual Studio 2022

|**調整前**|
|:-:|
||
|**調整後**|
||

:::info
可以在 **`工具 > 選項`** 中的 **`AsmDude2`** 對顏色等進行進一步修改
:::

:::warning
目前 **AsmDude2** 還在開發中，有時會有小錯誤，例如這個錯誤訊息


:::