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

贊助商連結
Windows Developer Config:微軟官方一行指令設定 Windows 11 開發環境,含 WSL 與常用工具

本文重點:Windows Developer Config 是 Microsoft 以 MIT 授權公開的開源專案,用一行 PowerShell 指令替全新 Windows 11 安裝開發工具、套用系統設定,並建立 WSL 與 Ubuntu 環境。

每次重灌 Windows 或換新電腦,要把 Git、VS Code、Node.js、Python、終端機和 WSL 開發環境一個個裝好,再把檔案總管、深色模式這些設定調回習慣的樣子,可能一弄就得花上半天時間,有沒有更快、更有效率的方法呢?

近期微軟在 GitHub 公開了一個開源專案「Windows Developer Config」,把這些步驟整理成可重複執行的 PowerShell 腳本,在全新的 Windows 11 裡開啟 PowerShell,貼上一行指令,約 30 分鐘就能得到一台裝好工具、套用好設定,並啟用 WSL 與 Ubuntu 的開發機。

本文整理它包含哪些內容、如何用它設定 Windows 11 開發環境,以及執行前最好先知道的系統變更。

贊助商連結

Windows Developer Config 是什麼?

Windows Developer Config 由 Microsoft 在 GitHub 上維護,採用 MIT 授權,Microsoft Learn 也有「Windows Developer Configurations」的官方說明頁。專案的設計重點是「重複執行也安全」:每個步驟會先檢查目前狀態,已經符合的就略過,所以拿來修補一台既有的電腦也可以。截至 2026 年 11 月撰稿時,專案在 GitHub 約有 3.5k 顆星、240 個 fork。

專案提供三種設定,依需求挑選:

設定適合的情況內容
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 種有一行指令,其餘用 winget configure 執行

Windows Dev Config 會安裝與調整哪些項目

  • 開發工具:Windows Terminal、PowerShell 7、Git、GitHub CLI、GitHub Copilot CLI、VS Code、.NET SDK 10、Python 3.14 與 uv、Node.js LTS 與 nvm、Coreutils for Windows、Windows App CLI、Oh My Posh、PowerToys。
  • 終端機:PowerShell 7 設為預設設定檔,加入 Oh My Posh 提示列,預設字型為 Cascadia Mono NF(來自微軟的 Cascadia Code 字型專案),並在下拉選單加入 GitHub Copilot 設定檔。
  • Windows 設定(標準版):深色主題、長路徑支援、檔案總管預設選項(顯示副檔名與隱藏檔等)、開始與搜尋的精簡設定、勿擾模式。
  • Windows 設定(完整版另外加上):開發人員模式、Sudo、關閉小工具、Edge 原則、啟用遠端桌面,以及更多開始、搜尋與系統匣設定。
  • WSL:安裝 WSL 平台與 Ubuntu,含重開機與自動接續。

網站標題:Windows Developer Config
網站連結:https://github.com/microsoft/WindowsDeveloperConfig

Windows Developer Config 使用教學

確認系統與環境需求

執行前先確認以下項目:

  • 作業系統為 Windows 11,不支援 Windows 10。
  • 帳號有系統管理員權限,可以同意兩次 UAC 提示。
  • 網路可以連到 github.com、raw.githubusercontent.com、PowerShell Gallery 與 winget 套件來源。
  • 磁碟約有 15 GB 可用空間。
  • 若要安裝 WSL,需要在 BIOS 或 UEFI 開啟硬體虛擬化(VT-x 或 AMD-V);在虛擬機器裡執行時,主機要開放巢狀虛擬化。
  • 先儲存手邊的工作,因為過程可能會自動重開機一次。

事前不需要另外安裝 Git、PowerShell 7、Visual C++ Redistributable,腳本會自行處理。

Windows developer config 2.

開啟 PowerShell 並貼上指令

在開始選單搜尋 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 設定的範圍,完整版多出的項目列在上方「Windows Dev Config 會安裝與調整哪些項目」,風險較高的幾項寫在文末提醒。指令會下載經 Microsoft 簽章的腳本,驗證簽章後才執行。

Windows developer config 3.

贊助商連結
同意 UAC 並等待安裝完成

若目前不是系統管理員身分,畫面會跳出 UAC 提示,同意後才會繼續。完整版會依序進行 11 個階段,標準版略過其中的 Edge 調整:

  1. 準備環境與更新 winget
  2. 安裝套件
  3. 系統設定
  4. 檔案總管調整
  5. 工作列、搜尋與開始選單調整
  6. Edge 調整(僅完整版)
  7. 字型
  8. Windows Terminal
  9. PowerShell 設定檔
  10. GitHub Copilot 相關項目
  11. WSL 與 Ubuntu

乾淨的電腦約需要 30 分鐘,大部分時間花在下載 VS Code、.NET SDK、PowerToys 與 Ubuntu,下載大型檔案時畫面可能長時間沒有輸出,屬於正常現象,腳本會每分鐘提示一次仍在執行。

Windows developer config 4.
Windows developer config 5.

重新開機並接續執行

安裝 WSL 平台若需要重新開機,腳本會先顯示警告,倒數 10 秒後重新啟動電腦,同時建立名為 WindowsDevConfigResume 的排程工作。

重新登入後約 30 秒,會自動開啟視窗並再次出現 UAC 提示,同意後就會接續完成剩下的步驟。若等了幾分鐘仍沒有任何視窗,重新貼上同一行指令即可,已完成的項目會直接略過。

Windows developer config 8.

查看摘要並完成後續設定

安裝完成後,畫面會列出摘要,包含變更了幾項、有幾項原本就正常。若有項目標示為 flagged,代表是無法完成或無法確認的「盡力而為」項目,重新執行一次指令通常能補完。

接著做三件事:

  1. 從開始選單開啟 Ubuntu,建立 Linux 使用者名稱與密碼。這一步需要手動完成。
  2. 登出再登入,讓部分檔案總管與工作列變更生效。
  3. 開啟 Windows Terminal,確認預設為 PowerShell 7,並出現 Oh My Posh 提示列。

使用前的提醒

若需要重新開機,倒數只有 10 秒,執行前請先存檔並關閉重要程式。

Windows Developer Config 會調整不少系統設定,部分項目建議先看過。

  • 完整版會啟用遠端桌面(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 開發環境,不妨找一台虛擬機器先跑一遍,確認它調整的設定符合自己的習慣後,再用在主力電腦上。

贊助商連結

訂閱新文章通知

已有 3.5 萬位讀者訂閱,新文章直接寄到你的信箱。

Pseric

Pseric

「免費資源網」創辦人,自 2006 年起專注於網路資源、雲端服務與軟體評測,累積 20 年實測經驗,於免費資源網發表超過 7,000 篇教學文章,內容受國內外主流科技媒體引用。致力於透過深度測試,為使用者篩選安全且高品質的數位工具。