# 海勒姆定律

> “当一个API（接口）拥有足够多的用户时，你在合约里承诺什么都不重要了：你系统中的所有可被观测到的行为（哪怕是Bug或副作用），都会被某些用户依赖。”

- ID: m02076
- 分类: system
- 领域: 复杂科学

## 定义

“当一个API（接口）拥有足够多的用户时，你在合约里承诺什么都不重要了：你系统中的所有可被观测到的行为（哪怕是Bug或副作用），都会被某些用户依赖。” - 脚手架作用： 隐性依赖的诅咒。 - 这解释了为什么改革这么难。你以为你只是修复了一个“错误”，结果发现这个“错误”不仅被员工当成了“功能”，还成了业务流程的核心支柱。在复杂系统中，不存在“无害的改动”。 任何现状（哪怕是坏的现状）都是某种生态赖以生存的基础。

## 机制

Hyrum's Law：当API有足够多用户时，你在合约中承诺的行为都不如你在实践中被依赖的行为重要——任何可观测的输出或副作用都会被某人依赖，因而无法安全改动。

## 练习

把“文档承诺”与“实际被依赖行为”分开登记；改动前搜索所有隐式依赖；以弃用期与兼容层渐进迁移；测试覆盖隐式契约。

## 脚手架用法

隐性依赖的诅咒。 - 这解释了为什么改革这么难。你以为你只是修复了一个“错误”，结果发现这个“错误”不仅被员工当成了“功能”，还成了业务流程的核心支柱。在复杂系统中，不存在“无害的改动”。 任何现状（哪怕是坏的现状）都是某种生态赖以生存的基础。

[阅读网页](https://thinkingmodels.site/entries/detail/m02076)