Scoop 项目中 Update-ManifestProperty 函数对 PSCustomObject 类型 autoupdate 字段的误写问题分析

问题背景

在 Windows 包管理工具 Scoop 的维护过程中，开发人员发现了一个关于清单(manifest)文件更新的重要问题。当使用 Update-ManifestProperty 函数更新清单文件时，如果清单中包含 autoupdate 字段且该字段是 PSCustomObject 类型，函数会错误地重写该对象中的所有字段值，而不仅仅是需要更新的目标字段。

问题重现

以一个修改过的 sudo 包清单为例，原始清单中包含了版本号、描述、下载链接等基本信息，以及用于自动更新的 autoupdate 配置。开发人员添加了环境变量设置：

{
    "version": "0.1",
    "env_set": {
        "SUDO_VERSION": "0.1"
    },
    "autoupdate": {
        "url": "...",
        "env_set": {
            "SUDO_VERSION": "$version"
        }
    }
}

当运行更新命令后，不仅 env_set.SUDO_VERSION 被更新为实际版本号，autoupdate.env_set.SUDO_VERSION 中的变量占位符 $version 也被错误地替换成了具体版本值，这破坏了自动更新功能的设计意图。

技术分析

根本原因

问题的根源在于 PowerShell 中对 PSCustomObject 的处理方式。在 PowerShell 中，对象赋值默认是引用传递而非值传递。当 Update-ManifestProperty 函数处理 autoupdate 字段时，直接修改了原始对象的引用，导致所有相关字段都被更新。

影响范围

这一问题会影响所有包含 PSCustomObject 类型 autoupdate 字段的 Scoop 清单文件。特别是那些在 autoupdate 中使用了变量替换模式(如 $version, $matchSha 等)的包，自动更新功能会被破坏。

解决方案

临时解决方案

在问题修复前，维护人员可以：

1. 手动恢复被错误修改的 autoupdate 字段
2. 避免直接使用更新命令，改为手动编辑清单文件

永久修复方案

正确的修复方法是修改 Update-ManifestProperty 函数，使其在处理 PSCustomObject 时创建深度拷贝(deep copy)，确保修改操作不会影响原始对象。这可以通过以下方式实现：

1. 使用 ConvertTo-Json 和 ConvertFrom-Json 进行序列化/反序列化来创建对象副本
2. 或者使用 PowerShell 的 .Clone() 方法（如果可用）
3. 实现自定义的深度拷贝逻辑

最佳实践建议

对于 Scoop 清单维护人员，建议：

1. 在修改清单文件前做好备份
2. 仔细检查自动更新相关的字段是否保持变量替换模式
3. 对于重要包，考虑在更新后运行测试验证自动更新功能是否正常
4. 关注 Scoop 的更新，及时应用修复版本

总结

这个问题的发现和解决过程展示了在软件开发中对象引用处理的重要性。特别是在配置管理和自动化工具中，确保数据完整性和功能正确性需要开发人员对语言特性和对象生命周期有深入理解。Scoop 团队通过这一问题进一步优化了清单更新机制，提高了工具的可靠性。