Unity Android 開發:VS Code C# 程式設計工具安裝

Ted Liou 2025.10.27 Unity
Unity 使用 C# 程式語言來設計功能,目前推薦搭配 Visual Studio Code (簡稱 VS Code) 來開發。VS Code 本身是一個文字編輯器,開發者可透過安裝各種模組來讓它支援多種程式語言。本文將接續 上一單元,將使用 VS Code 來在 Unity 上開發程式。

下載 VS Code

請前往官網 https://code.visualstudio.com/Download,點擊 Windows 欄位的下載按鈕來取得安裝程式 (VSCodeUserSetup-x64-1.105.1.exe)。

image.png

接下來請啟動安裝程式 (VSCodeUserSetup-x64-1.105.1.exe),並同意授權合約,繼續軟體安裝流程。

image.png

到「選擇附加的工作」階段,請勾選「將以 Code 開啟動作加入 Windows 檔案總管檔案 / 目錄的操作功能表中」兩個選項,後續開發會更順利。請參考下圖:

image.png

安裝完成後,請啟動 VS Code 程式。

中文化 VS Code

啟動 VS Code 後,請點擊左側的延伸模組按鈕,並在搜尋框中輸入「繁體」,點擊「Install」來安裝 Chinese (Traditional) 的語言套件。

2025104046-kFXjZwwbeh.png

安裝完成後,右下角會跳出提示訊息,請點擊「Change Language and Restart」來重新啟動 VS Code 並套用中文語言。

2025104047-lumYNULizq.png

目前版本的 VS Code 會自動跳出 Copilot 的介面,那是 AI 協作開發的功能,我們目前用不到。請點擊右上角的按鈕 > 「預設顯示檢視」來將它關閉。

2025104048-zWk2Xf1flM.png

安裝 Unity 模組

接下來我們要在 VS Code 上安裝 Unity 的模組,來讓 VS Code 能和 Unity 搭配使用。

請一樣切換到延伸模組介面,搜尋「Unity」,並點擊「安裝」來取得模組。

2025104049-GgvjzOP0g0.png

Unity 模組安裝好後,我們要來設定 C# 的開發環境。一開始我們有提到 Unity 要使用 C# 來開發功能,而 C# 是依賴 .NET 框架,因此我們要安裝 .NET C# 所需要的核心。

請點擊上方的搜尋框,輸入「> .NET Install Tool」,選擇「.NET Install Tool: Install the .NET SDK System-Wide.」來開始安裝 .NET 核心。

2025104050-8iiEoP0mnk.png

2025104051-bb5zSu8wbI.png

接著會跳出輸入版本的輸入框,請保持預設的版本號,直接點擊 Enter。

2025104052-iIiLbPsfxs.png

接著請等待自動安裝程式完成所有安裝。

2025104054-N3DWEdJHKF.png

安裝完成後,請無視右下角跳出一個警告訊息,那只是通知你它會蒐集匿名使用資料。主要請確認「輸出」介面裡面有「Done!」的文字,它的出現代表我們有成功安裝 .NET 核心。

確定一切 OK 後,請關閉 VS Code,我們先回到 Unity 來進行設定。

2025104055-XuckdZm7bU.png

設定 Unity 使用 VS Code

首先,我們要確認專案有安裝要用 VS Code 來開發程式所需的套件。請從頂部導覽列 > Window 來開啟「Package Manager」。

2025104056-osyAloHkqn.png

請確認專案內有「Visual Studio Editor」套件,並且是最新版本。若沒有該套件,請點擊左側列表切換到「Unity Registry」來安裝「Visual Studio Editor」;若套件版本不是最新,則點擊「Update」來更新。

最新版本的套件可確保 Unity 能順利和 VS Code 連線。

2025104057-sZAeSd9Du5.png

接著,我們要來確認 Unity 的設定是使用 VS Code 來開發 C# 程式。請點擊頂部導覽 > Edit 來開啟「Preferences」。

2025104058-bE76hHklA4.png

點擊左側列表切換到「External Tools」,確認 External Script Editor 的設定是「Visual Studio Code」。

別選到「code.cmd」,正確的設定是「Visual Studio Code」。

2025104059-bDCZn14So4.png

設定 VS Code 的 C# 開發環境

初次使用 VS Code 來開發 C# 時,有一些設定先設置好對於後續的順利與否會有很大的幫助,尤其是在初學者的時期更依賴這些功能,對於熟練者來說這些設定也是提高開發效率的好東西。

首先,請從 Unity 的頂部導覽列 > Assets > Open C# Project 來用 VS Code 開啟 C# 專案。

2025104060-Q7bFMqcyRK.png

初次開啟 Unity 專案會跳出「您是否信任此資料夾中檔案的作者」提示,請點擊「是,我信任作者」。

2025104061-NrW3yfWPbr.png

接著,請點擊右下角通知的「重新載入延伸模組」來更新設定。

2025104062-PRDkTqxHSR.png

如果有跳出「登入以使用您的 Visual Studio 訂閱權益」提示,請直接按「關閉」,那東西目前也用不到。

2025104063-Ej8hSdslMX.png

最後,請點擊 X 來將右下方的界面和歡迎介面關閉,接下來要來建立我們的第一個 C# 腳本。

2025104064-3qRUwle7cv.png

建立第一個 C# 腳本

Unity 的 C# 腳本要放在 Project 介面中的 Assets 資料夾內,通常的慣例會再建立一個資料夾來專門放程式碼,專案的結構會比較簡潔明瞭。

請在 Assets 資料夾上點擊滑鼠右鍵 > Create > Folder 來建立一個名為「Scripts」的資料夾。

2025104065-uDfoqqiAyU.png

接著,在 Scripts 資料夾上點擊滑鼠右鍵 > Create > MonoBehaviour Script 來建立一個名為「GameManager」的 C# 腳本。

2025104066-rw62Gynze2.png

最後專案的 Assets 資料夾內會有一個 Script 資料夾,裡面會有一個 GameManager 的 C# 腳本,請雙點擊來開啟它,接下來我們要藉由這個腳本的存在來對 VS Code 進行更進一步的設定。

2025104067-28rSH4yjXo.png

設定 VS Code 的開發設定

首先是右側欄的介面,通常我們不會用到,請在上面點擊滑鼠右鍵 > 縮圖來隱藏它。

2025104069-QVob91bC2O.png

接著,請點擊左下角的齒輪來開啟「設定」。

2025104070-UuUiCcALZK.png

VS Code 有內建自動格式化的功能,也就是自動幫你處理程式碼的縮排和排版,讓程式結構看起來更清楚。初學者在剛接觸 C# 開發的時候,這功能也會讓我們比較不會因為對語法的不熟而產生未知的 Bug (例如少了個括號之類的…)。

而最好觸發程式碼格式化的的時機就是存檔,請在開啟設定後勾選「Editor: Format On Save」。

2025104071-gHSdT42NCz.png

接著,因為我們會在 VS Code 上開發 Unity 的 C# 腳本,我們會希望程式碼的變動能快速的更新到 Unity 裡面。

請搜尋「Refresh on Save」,勾選「Vstuc: Refresh On Save」來讓我們存檔時能自動通知 Unity 套用我們的變更。

2025104072-VXZ3RwOWpo.png

另一部份則是各個電腦的作業系統差異可能會造成的 Bug,就是 C# 腳本的最後一行字元的問題。簡單來說,讓最後一行保持是一個空行最不容易出事。

請搜尋「Insert Final Newline」來勾選「Files: Insert Final Newline」。

2025104073-ZJQF7ADcm1.png

最後,程式碼有長有短,難免會有一行中塞了一堆程式碼的狀況。這時候我們就需要橫向捲動來檢視它。而 VS Code 也支援自動換行的功能,請搜尋「Word」來將「Editor: Word Wrap」變更為「on」。

至此,VS Code 的設定都已結束。

2025104074-pnaCWL0SNb.png

建立 Hello World!

最後是經典的環節,我們要來撰寫第一個功能,要在 Unity 的 Console 中印出「Hello World!」的文字,來確認我們在 VS Code 上撰寫的 C# 程式碼有順利的被 Unity 使用。

請在 Start 之中輸入以下程式碼並點擊鍵盤 Ctrl + S 存檔:

1Debug.Log("Hello World!");

2025104075-7w8uKgra3X.png

接著,我們要將寫好的 C# 腳本掛到場景的物件上,來讓腳本生效。

請在 Hierarchy 的空白處點擊滑鼠右鍵 > Create Empty 來建立一個名為「GameObject」的空物件。

2025104076-4SWdMyZQ4r.png

請選取 GameObject,並看到 Inspector 介面,點擊介面中的「Add Component」,搜尋並點擊「GameManager」,這樣我們的 GameManager C# 腳本就成功掛到物件上了。

2025104078-gEymbCN1U4.png

最後,請點擊正上方的 Play 按鈕,來執行我們的 Unity 專案。

2025104079-fTWYFOm6Pn.png

執行成功後,左上角的 Console 介面會印出 Hello World! 的文字,代表我們的 C# 腳本有成功動起來了!

確認好結果後,再點擊正上方的停止按鈕來停止專案。

2025104080-rRx9ooj1cz.png

總結

在本文中,我們接續 上一單元 的進度,在電腦中安裝了用於開發 C# 程式腳本的 VS Code 工具,也進行了 Unity 編輯器和各種有助於後續開發的設定。在開發前完成這些設定能讓我們開發時可以不用面對未知的使用障礙,例如常見的:沒有自動完成選單、存檔失敗、程式碼格式雜亂等等問題。

在下一單元中,我們將來撰寫一個簡單的小功能,並將我們的成果安裝到 Android 手機當中。

Ted Liou

我是一位遊戲開發工程師 / 軟體工程師,專精於 Unity 和 C#。我善於自學新技術,並樂於將所學轉化為淺顯易懂的教材,幫助他人學習與成長。