遵循「Accept Interfaces」实践是否会导致弃用检测工具失效？

该问题的核心成因是：Go 官方的弃用标记默认只绑定到方法的原生定义处，用户自定义接口时复制的方法签名不会自动携带Deprecated标记，IDE和linter的静态检查只会校验当前调用的方法所属接口/结构体上的标记，因此会出现告警遮蔽的情况。

• 方案1：库方预先定义标准化抽象接口
  作为库维护者，你可以提前把常用的抽象接口在库内定义好，所有待弃用的方法都在接口的方法注释上标注官方Deprecated标记，在库文档中明确引导用户如果需要做接口抽象，直接引用库提供的标准接口，不要自行重复定义。这样用户通过该接口调用方法时，IDE和linter可以正常识别弃用标记抛出告警。
  代码示例：

  // 库方预定义的用户查询标准接口
  type UserFetcher interface {
      // Deprecated: 该方法将于v1.5.0版本移除，请使用 GetUserByID 替代
      GetUserByName(name string) (*User, error)
      GetUserByID(id int64) (*User, error)
  }
  
  // 库方原有返回的实体结构体默认实现该接口
  type UserService struct {}
  func (u *UserService) GetUserByName(name string) (*User, error) { /* 原有业务逻辑 */ }
  func (u *UserService) GetUserByID(id int64) (*User, error) { /* 新逻辑实现 */ }
  

• 方案2：在弃用方法实现中添加多维度告警兜底
  针对已经自行定义接口的存量用户，可以在弃用方法的实现侧添加多层告警，确保用户能收到通知：

  1. 静态检查层面：给方法添加Go 1.18+支持的//go:deprecated官方指令，配合staticcheck、golangci-lint等常用检查工具的规则，即使通过自定义接口调用，部分检查工具也能从实现侧追溯到弃用标记抛出告警。
  2. 运行时层面：在方法逻辑最开头添加开发环境告警逻辑，检测到是本地开发环境时打印warn级别的日志，附带调用栈信息，直接提醒调用方该方法已废弃。
     代码示例：

  import (
      "log"
      "os"
      "runtime/debug"
  )
  
  //go:deprecated Use GetUserByID instead
  func (u *UserService) GetUserByName(name string) (*User, error) {
      if os.Getenv("GO_ENV") == "dev" {
          log.Warn("GetUserByName 已废弃，将在v1.5.0版本移除，请替换为GetUserByID")
          debug.PrintStack()
      }
      // 原有业务逻辑
  }
  

• 方案3：在版本更新说明中明确要求自定义接口用户同步标记
  发布带弃用标记的版本时，在CHANGELOG和升级指南中明确列出所有待弃用的方法，告知所有自行定义了包含该方法接口的用户，只需在自己的接口对应方法上同步添加Deprecated注释，即可正常收到IDE和linter的告警提醒。

• 方案4：大版本升级时直接移除方法
  如果方法废弃已经到了最终淘汰阶段，可以直接在新的大版本中删除该方法，用户升级后编译会直接失败，强制用户完成方法替换，这是最彻底的兜底方案。

内容的提问来源于stack exchange，提问作者Brad Johnson