前言
在现代后端开发中，接口响应不仅仅是数据的传递，还承担着向前端或用户传递操作状态和结果的功能。一个规范、统一的 message 字段设计，可以显著提升系统的可维护性、前端开发效率和用户体验。
定义
通常我们采用统一的响应结构来规范数据交互。以 NestJS 为例，标准的响应体应包含以下核心字段：
interface ApiResponse<T> {
success: boolean;
message: string;
data: T;
}
这种结构清晰明了，便于前端统一处理逻辑。
提示信息设计原则
设计 message 时，需遵循几个核心原则。
首先是简洁明了。提示信息不宜过长，一般控制在 3 到 12 个汉字之间。避免使用含糊不清的词，如'完成了'、'OK'等，这些词缺乏明确的操作指引。
其次是统一风格。同一项目的接口建议使用统一的动词加状态组合，例如'获取数据成功'、'数据加载完成'，保持整体一致性。
上下文要清晰。提示信息应体现操作对象或类型，比如'用户列表获取成功'而不是简单的'获取成功'。这样用户在看到提示时能立刻知道是哪个模块的操作结果。
最后是可扩展与模板化。对于多类型数据返回，可使用模板化语法，如'设备列表获取成功'、'订单数据获取成功'，方便后续扩展。
此外，建议面向用户与面向开发分层。前端提示简短易懂，强调用户操作状态；后台日志或文档则正式完整，便于排查接口状态。
提示信息风格分类
根据使用场景，我们可以将提示信息分为几类：
- 简洁风格（前端显示）：直接展示给用户，如'保存成功'。
- 正式 / 日志风格（后台接口 / 接口文档）：用于内部记录，如'数据更新操作已完成'。
- 带数量 / 上下文提示：增加具体信息，如'共 10 条'。
- 带操作指引提示：引导下一步动作，如'请刷新查看'。
提示信息模板化设计
为了统一风格和减少重复代码，设计模板非常必要。
例如，基础模板可以是：{操作} {对象} {状态}。
输出效果：用户列表获取成功，共 10 条。
模板化的好处显而易见：统一风格易维护，可动态生成提示内容，且更容易适配多语言国际化需求。
国际化与多语言支持
在国际化项目中，message 不应硬编码字符串，而应使用语言文件或翻译 key。
好处包括：适配不同语言环境，前端可直接展示翻译内容，后端日志仍可使用统一 key 便于排查问题。
最佳实践
结合多年经验，总结几点最佳实践供参考。
前端提示要短小清晰，例如'数据加载完成'、'获取数据成功'。后台或日志提示则需正式完整，例如'数据已成功获取'、'列表数据已返回'。
数量提示能有效增加用户反馈，比如'列表数据获取成功，共${list.length}条'。
采用模板化加动态内容，能提高复用率并降低出错率。
务必避免模糊词，不使用'OK'、'完成了'、'操作成功了'，必须明确操作对象、状态或数量。
参考示例（NestJS 响应）
下面是一个基于 NestJS 的简单实现示例，展示了如何构建规范的响应消息。
// 响应 DTO
export class ApiResponseDto<T> {
success: ;
: ;
: T;
}
()
(): <<[]>> {
users = ..();
{
: ,
: + users. + ,
: users,
};
}
