為 VS Code 打造的 .NET 單檔工具箱

一個 C# 檔案,
就能開始。

把想法寫進 .cs,不用先建立專案。
執行、建置、發佈,連同文件預覽,都留在熟悉的編輯器裡。

開源 · MIT 授權 · Windows / macOS / Linux

C#   hello.cs▷   Run File
#:property PublishAot=false

/*markdown
# Hello, file-based apps!

一個檔案,放進 **程式與說明**。
*/

Console.WriteLine("Let's build something.");
MARKDOWN PREVIEW

Hello, file-based apps!

一個檔案,放進 程式與說明。

Let's build something.

功能示意;實際畫面請見下方預覽。

VS Code 1.100+ .NET SDK 10.0.100+ 介面語言 English / 繁體中文 原生 C# 編輯體驗 保持不變

LESS SETUP. MORE BUILDING.

從小工具,到下一個靈感。

少一點切換,多一點專注。不取代 C# 編輯器,而是補上單檔開發最常用的動作。

01 / EXECUTE

常用指令,一步到位

從標題列或命令選擇區執行、還原、建置及清除檔案;也能傳入參數、選擇啟動設定檔。

dotnet run --file hello.cs
02 / DOCUMENT

讓註解,也能好好閱讀

在 C# 區塊註解加上語言標記,即可使用 Markdown 暫留提示、同步預覽與程式碼語法醒目提示。

/*markdown   /*yaml   /*json
03 / SHIP

需要成長時,再展開

管理套件指示詞、發佈可執行檔、封裝 .NET 工具,或轉換成專案,同時保留原始檔案。

#:package PackageName@Version
執行前,先信任。會啟動 .NET SDK 的命令在受限模式下停用;標記註解只供呈現,不會執行其中的內容。

CODE + CONTEXT

程式與文件,不必分開。

原始碼維持可編輯,旁邊是好讀的預覽。
深色、淺色主題,都能自在工作。

深色主題的標記註解預覽面板,包含 Markdown 文件、語法醒目提示、來源行號及複製按鈕。
預覽面板畫面(局部) · 點選圖片可檢視完整原圖
查看淺色主題 淺色主題的標記註解預覽面板,包含 Markdown 文件與多語言程式碼區塊。

18 種語言標記 Markdown · YAML · JSON · SQL · XML · Bash · PowerShell · C# · JavaScript · TypeScript · HTML · CSS · Python · C++ · TOML · INI · Dockerfile · CSV

內建文法支援預覽醒目提示;編輯器內的顯示會受 C# 語意醒目提示與主題影響。YAML / JSON 語法驗證需自行啟用。

READY WHEN YOU ARE.

三個步驟,開始寫。

  1. 準備環境

    安裝 VS Code 1.100+ 與 .NET SDK 10.0.100+。請確認終端機能執行 dotnet --version。

  2. 下載並安裝 VSIX

    下載最新正式版,在 VS Code 命令選擇區執行 Extensions: Install from VSIX…,選取剛下載的檔案。

  3. 建立檔案,執行!

    將上方範例儲存為 hello.cs,檢視並信任工作區,再執行 .NET File Apps: Run File。使用 Preview Tagged Comments 開啟註解預覽。

開始之前的小提醒

所有 .cs 檔案都會出現執行按鈕嗎?

預設只辨識以 #: 指示詞或 dotnet shebang 開頭的檔案,避免把一般專案檔案誤判為單檔應用程式。也可以調整 File Detection 設定,或對個別檔案手動啟用。

需要 C# Dev Kit 或更高版本的 .NET 嗎?

這個工具箱不取代 C# 語言服務,也不強制依賴 C# Dev Kit。基本檔案型命令需要 .NET SDK 10.0.100+;管理專案參考與格式化功能需要 .NET 11+。進階編輯體驗仍由你安裝的 C# 擴充套件提供。

為什麼發佈可執行檔時需要原生工具鏈?

.NET 檔案型應用程式預設使用 Native AOT 發佈。若不需要 AOT,可加入 #:property PublishAot=false 改用架構相依發佈。

可以在遠端工作區或瀏覽器裡使用嗎?

遠端工作區的命令由遠端擴充套件主機執行,因此該環境必須安裝 .NET SDK。純瀏覽器與虛擬工作區不支援這些 CLI 功能;WSL、SSH 與 Dev Containers 仍需實際環境驗證。