微软开源了 Windows 开发环境自动配置工具，一条命令搞定新电脑

拿到一台新电脑，装系统，装 Git，装 VS Code，装各种运行时，改设置，折腾半天才能开始写代码。这个过程每个开发者都经历过，也都觉得烦。

微软最近在 GitHub 上开源了一个项目叫 WindowsDeveloperConfig，想把这个过程压缩到一条命令。项目地址：github.com/microsoft/WindowsDeveloperConfig，MIT 协议，用 PowerShell 写的，目前不到一个月已经拿到了将近 1000 个 star。

三种配置方案，按需选择

这个仓库提供了三套方案，不是一刀切。

第一套叫 Windows Dev Config，最重，也最省心。一条命令把一台全新的 Windows 11 变成可用的开发机。它会装 PowerShell 7、Git、GitHub CLI、VS Code、.NET SDK 10、Python 3.14 加 uv、Node.js、Oh My Posh、PowerToys。同时改一堆 Windows 设置：暗色主题、开发者模式、长路径支持、文件资源管理器默认行为、Edge 策略。还会自动开启 WSL 并安装 Ubuntu。

中间需要重启一次，因为 WSL 依赖的 Windows 可选功能需要重启才能生效。重启后系统会自动继续执行剩下的安装步骤，不需要你再手动操作。整个过程是无交互的，幂等的，跑完再跑一遍也不会出问题。

第二套叫 WSL Comfort，轻量一些，专注于在 WSL 里搭一个顺手的 shell 环境。支持 zsh 和 bash 二选一，可选装 Starship 提示符、fzf、ripgrep、fd、bat、eza、zoxide、jq 这些现代 CLI 工具。还能装 Homebrew、配 Git 默认值、加剪贴板快捷命令。Windows 侧会帮你装 WSL 和 Cascadia Code Nerd Font，再配一个带主题的 Windows Terminal profile。支持交互式和非交互式两种运行模式。

第三套是单语言工具链。如果你只需要 Python，或者只需要 Rust，不需要把整个开发环境全装上，这里有 9 个独立的工作负载：TypeScript、PHP、.NET、Go、Java、Rust、Python、WinForms、WinUI 3。每个都是一个单独的 winget 配置文件，一条命令安装。

核心机制是 winget configure

所有方案的底层都依赖 winget configure。这是 Windows 包管理器 winget 的声明式配置功能，用 YAML 文件描述你想要的软件和设置状态，winget 负责把系统调整到那个状态。

首次使用需要先启用这个功能：

winget configure --enable

有个坑值得注意：如果在非提权环境下运行 winget configure，必须先装 Visual C++ Redistributable，否则会报内部错误。仓库的文档里写了这个问题，也提供了自动安装脚本。

实际体验

我从头跑了一遍 Windows Dev Config。在 Windows 11 虚拟机里，下载 ZIP、解压、执行命令，然后等。整个过程大概二十多分钟，中间重启了一次。重启后自动继续，装完 Ubuntu 结束。

装出来的环境确实可以用。PowerShell 7 作为默认终端配置好了，Oh My Posh 的提示符生效了，Cascadia Mono NF 字体设好了，暗色主题开着，VS Code 直接能用。WSL 里的 Ubuntu 也正常启动，shell 干干净净没有什么多余的配置。

有一点需要说明：这条配置方案是微软的观点化的，也就是它按微软觉得合理的方式配置你的机器。如果你对终端字体、主题、默认 shell 有自己的偏好，跑完之后还得手动调。但至少基础环境不用从头搭了。

WinForms 和 WinUI 3 的工作负载会拉下好几个 G 的 Visual Studio 组件，在真实工作站上没问题，在小虚拟机里会比较痛苦。文档里也提醒了这一点。

仓库结构有意思

src 目录是源代码的真正位置，顶层的 windows-dev-config、Workloads、wsl-comfort 这些目录是经过 Authenticode 签名的发布副本，由 CI 管道自动生成。如果你想贡献代码，要改 src 里的文件，不要直接改顶层目录。所有流程的元数据统一维护在一个叫 manifest.yml 的文件里，Command Palette 扩展、CI、各流程的脚本都从它读取配置。

还有一个正在开发中的 PowerToys Command Palette 扩展，以后可以直接从命令面板启动各个配置流程，不用记具体的文件路径。

适合什么人用

如果你经常需要配置新的 Windows 开发环境，不管是换电脑、装虚拟机、还是搭 CI runner，这个工具能省不少时间。特别是团队统一开发环境的时候，用声明式配置比写一页 wiki 让新人自己装靠谱得多。

如果你已经有自己精心调校好的 dotfiles 和配置脚本，这个项目更多是参考价值。它的 winget 配置文件写法、RunOnce 机制处理重启恢复、幂等设计的思路，都值得借鉴。

项目还很新，2026 年 5 月 21 日才创建。文档写得不错，问题排查部分覆盖了常见坑。如果你遇到了文档没覆盖的问题，可以去 GitHub issues 反馈，附上 Windows 版本号和具体报错信息。