# 旧接口标了弃用

**URL:** <https://buildx.do/t/%E6%97%A7%E6%8E%A5%E5%8F%A3%E6%A0%87%E4%BA%86%E5%BC%83%E7%94%A8/145>\
**Category:** 前沿快讯\
**Tags:** 技术动态\
**Created:** [2026 年10 月 6 日 00:33 UTC](https://buildx.do/t/%E6%97%A7%E6%8E%A5%E5%8F%A3%E6%A0%87%E4%BA%86%E5%BC%83%E7%94%A8/145 "2026-10-06T00:33:00Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![fenglan](https://buildx.do/letter_avatar_proxy/v4/letter/f/bc79bd/32.png) [@fenglan](https://buildx.do/u/fenglan)\
**Post date:** [2026 年10 月 6 日 00:33 UTC](https://buildx.do/t/%E6%97%A7%E6%8E%A5%E5%8F%A3%E6%A0%87%E4%BA%86%E5%BC%83%E7%94%A8/145/1 "2026-10-06T00:33:00Z")

</div>

「旧接口标了弃用」。

给了替代和一段时间。新代码别再调用旧的。

这次按时间写。先发生什么，中间查了什么，最后留下什么。不把后来才知道的结论写成一开始就想到了。查的时候把猜的和已经验证的分开，避免第二天把猜测当成事实。验证用的是改之前的同一条路径，不是换一组更容易过的输入。

动态只记会影响我们怎么用的那一部分：默认值变了、接口弃用了、协议变严了、维护窗口在哪天。不抄整份发布说明。升级前先搜自己有没有依赖旧行为。不紧急的排进周或季度，不要在维护窗口里发布。

记录里保留失败的那一次。只写成功，别人学不到边界。失败时的输出、当时的配置、本来期望发生什么，三样放在一起。修好之后补一句：如果再出现，先看哪一行。没有这句，这篇就只是故事。

复查「旧接口标了弃用」时按这四步，不靠感觉。用改之前的同一组输入再走一遍，结果要变成预期的那样。在日志里打出实际读到的配置名、端口或库名，确认不是另一个还没关的进程。换一个干净环境再做一次。最后把现象、改动、确认方法写成三行放进仓库。

补充记录。只写会影响我们怎么用的变化。默认值变了，就搜自己的配置有没有依赖旧值。接口弃用了，就写替代和截止日期，新代码从现在停用旧的。协议变了，就按现在的用法重读，不用去年的印象。维护窗口写进日历，那段时间不发布。安全更新读影响范围，再决定是这周还是当天。示例仓库更新后，旧克隆会和文档对不上，要写明重新拉还是看差异。一篇动态如果不能回答‘我们要不要改、什么时候改’，就还是公告，不是记录。

操作顺序。1. 只摘会改变我们用法的点：默认值、弃用、协议、维护窗口、安全影响。2. 写我们要不要改，以及这周、本月还是下个季度。3. 升级前搜索自己是否依赖旧行为。4. 维护窗口写进日历，那段时间不发布。5. 示例或文档地址变了，就写明旧链接还会跳转多久。6. 把结论压成三行放在开头，细节放后面。读完三行仍不知道要不要行动，这篇就还是转载，不是我们自己的记录。

---

<div class="post-metadata">

**Author:** ![chenmiao](https://buildx.do/letter_avatar_proxy/v4/letter/c/d2c977/32.png) [@chenmiao](https://buildx.do/u/chenmiao)\
**Post date:** [2026 年10 月 6 日 01:58 UTC](https://buildx.do/t/%E6%97%A7%E6%8E%A5%E5%8F%A3%E6%A0%87%E4%BA%86%E5%BC%83%E7%94%A8/145/2 "2026-10-06T01:58:00Z")

</div>

新代码不要再调用已弃用的接口。旧调用保留到他们写明的截止日期。
