go中状态码须用const命名而非裸数字，以明确语义、便于搜索重构；应分离http状态码与业务错误码，统一管理、显式类型、配套text()方法，并通过is()支持errors.is()匹配，前端依赖稳定json字段名与全大写枚举。
Go 里用 const 定义状态码，为什么不能直接写数字？
因为数字本身不带语义，400 是参数错误还是权限不足？调用方和维护者都得猜。用 const 给每个状态码起个名字，比如 ErrInvalidParam，能立刻知道意图，也方便全局搜索和重构。
常见错误是把状态码和错误消息混在一起定义，或者在多个包里重复定义同一组码——结果改一个地方漏了另一处，API 文档和实际返回对不上。
- 所有状态码统一放在一个包里（如
pkg/code），导出为大写常量 - 避免用
int类型裸写，显式声明类型，比如type Code int，再定义const ErrNotFound Code = 404 - 配套提供
Text()方法或映射函数，把Code转成描述字符串，别在各处硬编码消息
HTTP 状态码和业务错误码要不要分开？
要分开。HTTP 状态码（如 404、500）表达的是通信层/协议层结果；业务错误码（如 ErrOrderAlreadyPaid）表达的是领域逻辑失败。混用会导致前端难处理：比如 400 可能对应参数错、库存不足、用户被禁用三种完全不同的业务场景。
典型坑是把所有业务错误都塞进 400，前端只能靠响应体里的 code 字段区分，但 HTTP 客户端库默认不检查 body，容易误判为“请求成功”。
立即学习“go语言免费学习笔记（深入）”；
1.修正会员卡升级会员级别的判定方式2.修正了订单换货状态用户管理中心订单不显示的问题3.完善后台积分设置数据格式验证方式4.优化前台分页程序5.解决综合模板找回密码提示错误问题6.优化商品支付模块程序7.重写优惠卷代码8.优惠卷使用方式改为1卡1号的方式9.优惠卷支持打印功能10.重新支付模块，所有支付方式支持自动对账11.去掉规格库存显示12.修正部分功能商品价格显示4个0的问题13.全新的支
- HTTP 状态码只反映响应性质：用
2xx表示请求被接收并处理完毕（无论业务成功与否），4xx表示客户端问题，5xx表示服务端异常 - 业务错误码放进响应体的
code字段，类型建议用string（如"ORDER_PAID"），比整数更易读、可扩展 - 不要用 HTTP 状态码承载业务分支逻辑，比如用
402表示“余额不足”——402是保留状态码，多数中间件不识别，且语义不符
errors.Is() 和自定义错误码怎么配合？
Go 1.13+ 的 errors.Is() 依赖错误是否实现了 Unwrap() 和底层错误匹配。如果只是把状态码藏在结构体字段里，errors.Is(err, ErrNotFound) 默认不会生效。
常见写法是让错误类型实现 Is(target error) bool 方法，手动比对状态码值。否则上层代码只能用类型断言或反射去取字段，既脆弱又难测试。
- 定义错误类型时嵌入
error接口，并实现Is()：比如判断err是否等于ErrNotFound，就比较其Code()返回值 - 避免在错误包装链中丢失状态码：用
fmt.Errorf("xxx: %w", origErr)包装时，确保origErr自身支持Is() - 测试时别只测错误字符串是否包含某关键词，要用
errors.Is()断言具体错误码
前端怎么可靠地拿到并使用 Go 后端的状态码？
前端拿不到 Go 里的 const 名字，只能靠约定好的字符串或数字。所以后端输出的 code 字段必须稳定、文档化、不可随意变更。
最容易被忽略的是版本兼容：v1 接口返回 "USER_NOT_FOUND"，v2 改成 "USER_MISSING"，前端没改就会静默失败。还有大小写问题，比如 Go 里写 ErrUserNotFound，JSON 序列化成 errusernotfound（没加 json: tag）。
- 所有业务错误码用全大写 + 下划线风格（如
"PAYMENT_TIMEOUT"），和 HTTP 状态码数字明确区隔 - 在 struct 的 JSON tag 里显式指定字段名，比如
Code string `json:"code"`，别依赖默认小写转换 - 上线前用自动化脚本扫描所有
code字符串，生成前端可用的枚举 TS 文件，避免手写遗漏
