Windows Developer Config：微軟官方一行指令設定 Windows 11 開發環境，含 WSL 與常用工具

它是什麼

Windows Developer Config 是 Microsoft 在 GitHub 上維護的開源專案，採用 MIT 授權，Microsoft Learn 也有官方說明頁「Windows Developer Configurations」。用一行 PowerShell 指令，就能替全新的 Windows 11 安裝開發工具、套用系統設定並啟用 WSL。

截至 2026 年 11 月，GitHub 約有 3.5k 顆星、240 個 fork。乾淨的電腦約需 30 分鐘，大部分時間花在下載 VS Code、.NET SDK、PowerToys 與 Ubuntu。

只支援 Windows 11，不支援 Windows 10。WSL 要在 BIOS／UEFI 開啟硬體虛擬化（VT-x 或 AMD-V），在虛擬機器裡執行時，主機要開放巢狀虛擬化。

三種設定，先選一種

• Windows Dev Config： 完整開發工作站，含開發工具、Windows 系統設定、WSL 與終端機，分標準版與完整版，需要時會重開機一次。
• WSL Comfort： 只把 WSL 的 Shell 環境弄得好用，可選 zsh 或 bash、Starship 提示列、fzf、rg、bat 等 CLI 工具，也能互動或無人值守執行。
• Workloads： 只需要某一種語言環境，含 TypeScript、PHP、.NET、Go、Java、Rust、Python、SQL、PowerShell、WinForms、WinAppCLI、WinUI 3，共 12 種，其中 7 種有一行指令。

會裝什麼、會改什麼

開發工具包括 Windows Terminal、PowerShell 7、Git、GitHub CLI、GitHub Copilot CLI、VS Code、.NET SDK 10、Python 3.14 與 uv、PowerToys。終端機會把 PowerShell 7 設為預設設定檔，加入 Oh My Posh 提示列，預設字體為 Cascadia Mono NF，並在下拉選單加入 GitHub Copilot 設定檔。

標準版系統設定含深色主題、長路徑支援、檔案總管預設選項（顯示副檔名與隱藏檔等）、開始與搜尋的精簡設定、勿擾模式。完整版另外加上開發人員模式、Sudo、關閉小工具、Edge 原則、啟用遠端桌面，以及更多開始、搜尋與系統匣設定。WSL 會安裝 WSL 平台與 Ubuntu，含重開機與自動接續。

使用步驟

1. 確認系統與環境： Windows 11、管理員權限（可以同意兩次 UAC 提示）、網路可以連到 github.com、raw.githubusercontent.com、PowerShell Gallery 與 winget 套件來源、磁碟約有 15 GB 可用空間、WSL 需要硬體虛擬化、先儲存手邊工作（過程可能自動重開機一次）。事前不需要另外安裝 Git、PowerShell 7 或 Visual C++ Redistributable，腳本會自行處理。
2. 貼上官方指令： 在開始選單搜尋 PowerShell，用一般方式開啟即可（Windows PowerShell 5.1 或 PowerShell 7 都能執行），擇一貼上：

標準版：

irm https://aka.ms/devconfig/standard/setup.ps1 | iex

完整版：

irm https://aka.ms/devconfig/full/setup.ps1 | iex

兩者的差別在 Windows 設定的範圍。

3. 同意 UAC 並等待安裝完成： 完整版依序進行 11 個階段（準備環境與更新 winget、安裝套件、系統設定、檔案總管調整、工作列／搜尋與開始選單調整、Edge 調整（僅完整版）、字體、Windows Terminal、PowerShell 設定檔、GitHub Copilot 相關項目、WSL 與 Ubuntu）。下載大型檔案時畫面可能長時間沒有輸出，屬於正常現象，腳本會每分鐘提示一次仍在執行。
4. 重開機與接續： 如果安裝 WSL 平台需要重開機，腳本會先顯示警告，倒數 10 秒後重啟，同時建立名為 WindowsDevConfigResume 的排程工作。重新登入後約 30 秒會自動開啟視窗並再次出現 UAC 提示，同意後接續完成剩下步驟。如果等幾分鐘仍沒有視窗，重新貼上同一行指令即可，已完成的項目會直接略過。
5. 檢查摘要： 摘要會列出變更幾項、有幾項原本就正常。如果有項目標示 flagged，代表無法完成或無法確認的「盡力而為」項目，重執行一次通常能補完。接著手動從開始選單打開 Ubuntu 建立 Linux 使用者名稱與密碼、登出再登入讓部分檔案總管與工作列變更生效、打開 Windows Terminal 確認預設是 PowerShell 7 並出現 Oh My Posh 提示列。

執行前一定要知道的事

• 設計重點是「重複執行也安全」，每個步驟會先檢查目前狀態，已經符合的就略過，拿來修補既有電腦也可以。
• 重開機倒數只有 10 秒，執行前請先存檔並關閉重要程式。
• 完整版會啟用遠端桌面（RDP）。依 2026 年 11 月官方說明，Windows 防火牆規則不會同時開放，單靠這項不會直接暴露到區域網路，但仍是對電腦安全狀態的實際改變，標準版不含這項。
• 兩種版本都會關閉所有通知（全域勿擾），Teams、Outlook 等應用都不會再跳出通知。
• 完整版會用原則方式設定兩項 Edge 選項，Edge 會顯示「由你的組織管理」，這兩項在介面中會呈灰色。
• 腳本會改寫 Windows Terminal 的 settings.json，改寫前會先備份成 settings.json.bak，但原檔內的註解會遺失。
• Node.js LTS 與 nvm-windows 會同時安裝。想用 nvm 管理的人，建議先解除安裝 Node.js，避免 PATH 衝突。

常需要重灌電腦、帶新人設定開發機，或想試一套「官方版本」Windows 開發環境的人，建議先找一台虛擬機器跑一遍，確認調整的設定符合習慣後再用在主力電腦上。

指令與功能以 GitHub 專案與 Microsoft Learn 當下頁面為準。