MurmurHash3 是高性能非加密哈希函数，适用于 C++ 中哈希表等场景，具有优良分布性与运算速度。
要实现一个高效的非加密哈希函数，MurmurHash 是广泛使用的选择之一，尤其在 C++ 高性能场景中（如哈希表、布隆过滤器等）表现优异。它由 Austin Appleby 在 2008 年提出，具有良好的分布性与极快的运算速度。下面介绍如何在 C++ 中实现 MurmurHash3 的核心算法，并简要分析其性能特点。
MurmurHash3 算法原理
MurmurHash3 是 MurmurHash 系列中最成熟的一个版本，支持 32 位和 128 位输出。它采用混合乘法、异或和移位操作来打乱输入数据的比特分布，核心思想是：
- 将输入数据按固定字节大小（通常是 4 字节或 16 字节）分块处理
- 每一块通过一系列“mix”操作更新哈希状态
- 剩余不足块大小的数据单独处理
- 最后进行一次终态混合（fmix）以增强雪崩效应
该算法不用于加密安全场景，但对普通哈希用途（如 unordered_map）非常高效。
C++ 实现 MurmurHash3_32
以下是一个简洁的 MurmurHash3 32 位版本实现，适用于任意长度的字节数组：
#include#include // 常量定义 static constexpr uint32_t MURMUR_SEED = 0xc70f6907; // 可自定义种子 static constexpr uint32_t c1 = 0xcc9e2d51; static constexpr uint32_t c2 = 0x1b873593;
uint32_t murmur3_32(const uint8_t* key, size_t len) { uint32_t h = MURMUR_SEED; uint32_t k;
const uint8_t* tail; const uint32_t* blocks = reinterpret_castzuojiankuohaophpcnconst uint32_t*youjiankuohaophpcn(key); // 处理完整的 4 字节块 for (size_t i = len / 4; i != 0; i--) { k = *blocks++; k *= c1; k = (k zuojiankuohaophpcnzuojiankuohaophpcn 15) | (k youjiankuohaophpcnyoujiankuohaophpcn 17); k *= c2; h ^= k; h = (h zuojiankuohaophpcnzuojiankuohaophpcn 13) | (h youjiankuohaophpcnyoujiankuohaophpcn 19); h = h * 5 + 0xe6546b64; } // 处理剩余字节（0~3 字节） tail = reinterpret_castzuojiankuohaophpcnconst uint8_t*youjiankuohaophpcn(blocks); k = 0; switch (len & 3) { case 3: k ^= tail[2] zuojiankuohaophpcnzuojiankuohaophpcn 16; case 2: k ^= tail[1] zuojiankuohaophpcnzuojiankuohaophpcn 8; case 1: k ^= tail[0]; k *= c1; k = (k zuojiankuohaophpcnzuojiankuohaophpcn 15) | (k youjiankuohaophpcnyoujiankuohaophpcn 17); k *= c2; h ^= k; }; // 终态混合 h ^= len; h ^= h youjiankuohaophpcnyoujiankuohaophpcn 16; h *= 0x85ebca6b; h ^= h youjiankuohaophpcnyoujiankuohaophpcn 13; h *= 0xc2b2ae35; h ^= h youjiankuohaophpcnyoujiankuohaophpcn 16; return h;
}
ankuohaophpcnconst uint8_t*youjiankuohaophpcn(blocks);
k = 0;
switch (len & 3) {
case 3: k ^= tail[2] zuojiankuohaophpcnzuojiankuohaophpcn 16;
case 2: k ^= tail[1] zuojiankuohaophpcnzuojiankuohaophpcn 8;
case 1: k ^= tail[0];
k *= c1;
k = (k zuojiankuohaophpcnzuojiankuohaophpcn 15) | (k youjiankuohaophpcnyoujiankuohaophpcn 17);
k *= c2;
h ^= k;
};
// 终态混合
h ^= len;
h ^= h youjiankuohaophpcnyoujiankuohaophpcn 16;
h *= 0x85ebca6b;
h ^= h youjiankuohaophpcnyoujiankuohaophpcn 13;
h *= 0xc2b2ae35;
h ^= h youjiankuohaophpcnyoujiankuohaophpcn 16;
return h;这个实现可以直接用于字符串或内存块：
#include#include int main() { std::string str = "hello world"; uint32_t hash = murmur3_32( reinterpret_cast
(str.data()), str.size() ); std::cout << "Hash: " << hash << "\n"; return 0; }
性能优势与适用场景
MurmurHash3 在现代 CPU 上表现出色，主要得益于：
- 高吞吐量：利用了 CPU 的并行执行能力，指令间依赖少
- 良好分布：在大量测试集中表现出优秀的雪崩效应和碰撞率
- 无分支预测惩罚：主循环几乎无条件跳转，适合流水线执行
- 跨平台兼容：不依赖特定字节序（小端优先），可移植性强
相比于 std::hash 或 DJB2 等传统哈希函数，MurmurHash3 在长字符串和结构体哈希中更稳定，常被用于：
- 高性能哈希容器（如自定义 unordered_set）
- 分布式系统中的 consistent hashing
- 数据库索引键哈希
- 缓存键生成
在实际 benchmark 中，MurmurHash3 的速度通常优于 CityHash 和 SpookyHash，尤其在中短文本上优势明显。
注意事项与优化建议
使用时需注意几点：
- 种子值影响哈希结果，多线程环境中若需一致性应固定种子
- 对极短字符串（如 1~4 字节），部分混合可省略以进一步提速
- 若追求极致性能，可使用 MurmurHash3 的 SIMD 优化版本（如 x86 AVX）
- 不要用于安全敏感场景（如密码存储、防篡改）
可以将其封装为模板函数，适配 std::string、char[]、std::array 等常见类型，提升易用性。
基本上就这些。MurmurHash 是非加密哈希中的“瑞士军刀”，实现简单、速度快、效果好，值得在性能敏感项目中优先考虑。
