declare-when-a-setting-takes-effect

你正在用户界面里暴露一个设置项，而消费这个值的代码并不是每次使用都去读取它，而是在某个特定时刻读取：进程启动时、会话（session）构建时，或读入某个被缓存的对象里。

这条不适用于每次使用都会重新读取的设置项。那些设置项会立即生效，应该什么都不说——为一个根本不存在的延迟加上一句说明，教会用户的不信任，和漏掉说明是一样的。

1. 对每一个设置项，找到读取它的那一行代码。它何时生效，是那一行代码的属性，不是那个控件的属性。
2. 优先让它变成实时读取。一个在被访问时才解析的属性通常不花什么成本，而且是消除问题而不是描述问题。
3. 在真的做不到的地方——比如某样东西是在启动时初始化的——就给它加标签，并且这个标签要从服务器，或者从了解读取位置的那同一个模块生成，这样标签就不会走样。
4. 把标签归入有意义的类别：现在生效、下次对话生效、重启后生效。

标签会给设置页面增加噪音，一个每一行都挂着徽章的页面，等于徽章什么都没说明。只有那些延迟生效的设置才需要标签。

更深层的风险是把加标签当成解决方案本身。声明一个控件在重启前都不起作用，这是诚实的做法；让它变成实时生效则更好，标签不应该变成一种回避更难的那个改动的舒适借口。