首页/数据/数据库速查/HSET / HMSET 设置哈希字段
本包目录(495 条)
MySQL 基础与连接36 条SQL 语法52 条用户与权限21 条备份与恢复56 条主从复制与高可用53 条性能与调优57 条
Redis 命令96 条
Redis 运维与场景124 条

HSET / HMSET 设置哈希字段

Hash 是「键里套字段」结构:HSET 一次写一个或多个 field-value,返回新建字段数;HMSET 已被 HSET 取代(旧代码仍常见)。

数据库速查数据更新于 2026-10-12
用途为哈希键设置字段值
语法HSET key field value [field value ...]
返回新建字段的个数(更新已有字段计 0)

示例

示例
HSET user:1001 name 张三 age 30 city 上海
# 返回 3(三个字段都是新建)
HSET user:1001 age 31
# 返回 0(age 已存在,只是更新)
HMSET user:1001 email a@b.com phone 13800000000   # 旧命令,等价 HSET
Hash 的 field 数量上限约 2^32-1,但真正的上限是内存与操作耗时;单 Hash 上千字段就应审视设计。

易错点

  • 把 HSET 返回值当更新成功计数:它只统计新建字段数,更新返回 0 不是失败
  • 用 HMSET 写新代码:已标记弃用,统一用 HSET

数据来源与参考

  • Redis 官方文档: HSET
  • Redis 官方文档: HMSET(已弃用)

相关工具

​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌