WinGet 配置 —— 导读 未开始

题记与说明

这篇讲什么

这是微软官方对 WinGet Configuration（WinGet 配置）功能的概览页：用一份 YAML 格式的配置文件，声明开发环境所需的全部软件版本、包、工具、依赖项和系统设置，底层借助 PowerShell Desired State Configuration (DSC) 自动配置 Windows 操作系统，最后用一条 winget configure 命令启动整个配置过程（要求 WinGet v1.6.2631+）。文件还覆盖了运行方式（双击文件或命令行）、创作与可信度检查、官方示例库（aka.ms/dsc.yaml、PowerShell 库的 DSC 资源筛选）、企业组策略禁用方法，以及常见疑难解答。

核心观点

最重要的一个观念转变：配置文件不是命令性的步骤序列，而是声明性的「目标状态」描述。你只定义机器「应该是什么样」，不定义「按什么顺序做哪些事」。因此资源排序无关紧要，安装甚至可以并行运行；即使某些断言或资源失败，配置也会尽力推进其余任务，最后由人工检查故障。官方列出的三大好处是：无人参与安装、可靠且可重复（换机/入组不再凭记忆找版本）、可托管在 GitHub 支持开源协作。

最值得记住的金句与数据

1. 「WinGet 配置文件不是要遵循的命令性步骤序列，而是声明性的，用于定义所需的计算机配置状态结果。」——environment as code 的精髓一句话。
2. 「输入 winget configure 命令，让 Windows 程序包管理器和 PowerShell DSC 自动安装和设置……所有要求。」——一条命令复现整台开发机。
3. 关键数据：需 WinGet v1.6.2631+；PowerShell 库托管「数百个」含 DSC 资源的模块；官方维护 Windows 开发人员配置（dev-configs）精选库；微软还提供了企业级 GPO 禁用开关，说明这是被当真的一等公民功能。

对我的启发

• Agent 系统视角：声明式状态天然适配 Agent 的「验证-应用-修复」闭环。环境从散文式 README 变成机器可校验的目标态，意味着 AI Agent 可以自主执行配置、读取断言失败原因并修复，这正是 Agent 在真实开发机上落地所需的可观测接口。
• AI 编程工具视角：与 dotfiles、脚本式 setup.sh 相比，YAML + DSC 是「无聊但可验证」的选择——环境可 diff、可审计、可让 LLM 直接生成与检查。
• 个人知识管理视角：开发环境本身就是一份应被存档和复现的知识资产；把「我机器上装了什么」写成仓库里的 YAML，知识库就从记文档升级为记状态。
• 写作视角：官方文档用 FAQ 结构组织长文、用失败示例截图讲清断言依赖的传播，这种「用一个反例讲透机制」的写法值得借鉴。

适合谁读

Windows 平台开发者、需要频繁重装/换机/给新项目搭环境的人、要给团队做 onboarding 的 Tech Lead，以及所有对「环境即代码」和 Agent 可复现执行环境感兴趣的人。入门权威，读完后可顺着文中的 create / check 子页深入。