)

博主 默语带您 Go to New World.
✍ 个人主页—— 默语 的博客👦🏻
《java 面试题大全》
《java 专栏》
🍩惟余辈才疏学浅，临摹之作或有不妥之处，还请读者海涵指正。☕🍭
《MYSQL从入门到精通》数据库是开发者必会基础之一~
🪁 吾期望此文有资助于尔，即使粗浅难及深广，亦备添少许微薄之助。苟未尽善尽美，敬请批评指正，以资改进。！💻⌨

---

TypeError: unhashable type: ‘list’：不可哈希类型：列表完美解决方法 🔥

大家好，我是默语，擅长全栈开发、运维和人工智能技术。今天，我们要深入探讨Python中的一个常见错误：TypeError: unhashable type: ‘list’。这个错误的根本原因在于我们试图将一个不可哈希（mutable）的类型，如列表，作为字典的键或放入集合中。在这篇文章中，我将解释哈希性的概念、错误发生的原因，并提供有效的解决方案。📘

摘要 ✨

TypeError: unhashable type: 'list' 是Python编程中的常见错误，通常出现在试图将列表作为字典的键或插入集合时。由于列表是可变的（mutable），因此它们不是哈希类型，不能直接用于这些场景。本文将详细讲解这一错误的根本原因，并提供多种解决方案，帮助开发者正确处理Python中的哈希性问题。

引言 💡

在Python中，字典的键和集合中的元素必须是“可哈希”的。简单来说，哈希性意味着一个对象在其生命周期中具有不变的哈希值，并且该对象是不可变的。不可变对象（如tuple、str、int）可以作为字典的键，而像列表（list）这样的可变对象则不行。这就是为什么我们会看到TypeError: unhashable type: 'list'的错误。

接下来我们将深入探讨该错误的成因，并提供多个实用的解决方案。

正文 🛠️

1. 什么是哈希性？为什么列表不可哈希？

哈希性指的是一个对象能够通过hash()函数生成一个唯一的哈希值（或整数），并且在对象的生命周期中，这个哈希值是固定不变的。

• 可哈希对象：不可变类型，如整数、字符串、元组。
• 不可哈希对象：可变类型，如列表、字典、集合。

因为列表的内容可以随时更改，Python不允许将其作为字典的键或集合中的元素，原因是如果允许这样做，可能会导致集合或字典的键值匹配出现问题。

2. 触发错误的场景 🎯

通常，TypeError: unhashable type: 'list' 会出现在以下情况中：

2.1 使用列表作为字典的键

my_dict = {[1, 2, 3]: "value"}  # 错误

在这里，列表[1, 2, 3]被用作字典的键，结果触发了错误。

2.2 将列表作为集合的元素

my_set = set([[1, 2], [3, 4]])  # 错误

在这个示例中，试图将列表插入到集合中，同样触发了TypeError。

3. 解决方案 🔧

针对这个错误，我们可以采用以下几种有效的解决方案：

3.1 使用元组代替列表

元组（tuple）是不可变的，因此是可哈希的对象。我们可以将列表转换为元组，以避免错误。

示例 1：字典键

my_dict = {(1, 2, 3): "value"}  # 使用元组作为键
print(my_dict[(1, 2, 3)])  # 输出：value

示例 2：集合元素

my_set = set([(1, 2), (3, 4)])  # 使用元组作为集合元素
print(my_set)  # 输出：{(1, 2), (3, 4)}

3.2 将列表转换为不可变对象

在某些情况下，如果列表的内容不需要更改，将它转换为元组是一种常见的解决方案。

my_list = [1, 2, 3]
my_dict = {tuple(my_list): "value"}  # 将列表转换为元组
print(my_dict[tuple(my_list)])  # 输出：value

3.3 避免使用可变类型作为键

如果列表中的数据需要经常更改，建议使用另一种方法来标识字典的键，而不是直接使用列表。

示例：使用字符串标识

my_list = [1, 2, 3]
my_dict = {"_".join(map(str, my_list)): "value"}  # 使用字符串作为键
print(my_dict["_".join(map(str, my_list))])  # 输出：value

3.4 深度拷贝

有时我们需要将不可哈希的对象存储在字典中，我们可以使用深度拷贝来创建对象的不可变副本：

from copy import deepcopy

my_list = [1, 2, 3]
immutable_list = tuple(deepcopy(my_list))  # 深度拷贝并转换为元组
my_dict = {immutable_list: "value"}
print(my_dict[immutable_list])  # 输出：value

4. 实战案例 🎯

假设你有一个包含多个用户信息的列表，想要将其存储到字典中，同时以用户名列表作为键进行查找。我们可以使用元组或字符串进行转换：

users = [["Alice", 25], ["Bob", 30]]
user_dict = {tuple(user): f"User: {user[0]}" for user in users}
print(user_dict)  # 输出：{('Alice', 25): 'User: Alice', ('Bob', 30): 'User: Bob'}

在这个例子中，我们将每个用户的信息转换为元组，然后作为字典的键存储起来。

总结 🏁

TypeError: unhashable type: 'list' 是由于Python中列表是不可哈希的可变对象所引起的。通过将列表转换为元组、字符串或使用其他不变的标识符，我们可以有效避免这个错误。了解哈希性和可变对象的特性，对于编写高效且无错误的Python代码至关重要。

参考资料 📚

• Python 官方文档
• 哈希性与不可变对象

希望今天的分享能对你有所帮助！如果你在实际项目中遇到其他类似的问题，欢迎在评论区留言或者加入我的技术社区进行讨论。😊

---

🪁🍁 希望本文能够给您带来一定的帮助🌸文章粗浅，敬请批评指正！🍁🐥
🪁🍁 如对本文内容有任何疑问、建议或意见，请联系作者，作者将尽力回复并改进📓；(联系微信:Solitudemind )🍁🐥
🪁点击下方名片，加入IT技术核心学习团队。一起探索科技的未来，共同成长。🐥