Java HashMap values() 方法（完整指南）

Java HashMap values() 方法详解：从入门到实战

在 Java 的集合框架中，HashMap 是最常用的数据结构之一。它以键值对（key-value）的形式存储数据，支持快速的插入、查询和删除操作。然而，很多时候我们不仅需要获取键或键值对，更关注的是所有“值”的集合。这时，values() 方法就派上了用场。

今天我们就来深入聊聊 Java HashMap values() 方法，通过实际代码和通俗比喻，带你彻底搞懂它的用法、原理与常见陷阱。

什么是 values() 方法？

values() 是 HashMap 类提供的一个实例方法，它的作用是：返回一个包含所有键值对中“值”（value）的 Collection 视图。换句话说，它会把 map 中所有的 value 抽取出来，组成一个集合，方便你后续遍历、处理或分析。

想象一下，你有一本学生通讯录，每一页记录一个学生的名字（key）和电话号码（value）。如果你只想查看所有学生的电话号码，而不关心名字，那 values() 方法就像是“只翻电话号码页”的快捷方式。

import java.util.*;

public class HashMapValuesDemo {
    public static void main(String[] args) {
        // 创建一个 HashMap，存储学生姓名和成绩
        Map<String, Integer> studentScores = new HashMap<>();

        // 添加数据
        studentScores.put("张三", 88);
        studentScores.put("李四", 92);
        studentScores.put("王五", 76);
        studentScores.put("赵六", 95);

        // 调用 values() 方法，获取所有成绩
        Collection<Integer> scores = studentScores.values();

        // 遍历并打印所有成绩
        for (Integer score : scores) {
            System.out.println("成绩: " + score);
        }
    }
}

输出结果：

成绩: 88
成绩: 92
成绩: 76
成绩: 95

✅ 注意：values() 返回的是 Collection<V> 类型，其中 V 是 value 的类型（这里是 Integer）。它不是 ArrayList，也不是数组，而是一个“视图”——对原 map 的动态引用。

values() 返回的是什么类型？

values() 方法返回的是 Collection<V>，具体实现类通常是 HashMap.Values，它是 HashMap 的内部类，属于“视图”（View）结构。

这意味着什么？关键点在于：这个集合是“活的”。

也就是说，如果你修改了原始 HashMap 的内容，values 集合也会随之变化。这种设计既节省内存，又保证数据一致性。

Map<String, String> userRoles = new HashMap<>();
userRoles.put("admin", "超级管理员");
userRoles.put("editor", "编辑");
userRoles.put("viewer", "只读用户");

// 获取 values 视图
Collection<String> roles = userRoles.values();

System.out.println("初始角色列表: " + roles);

// 修改 map
userRoles.put("admin", "系统管理员");

System.out.println("修改后角色列表: " + roles); // 会看到 "系统管理员"

输出：

初始角色列表: [超级管理员, 编辑, 只读用户]
修改后角色列表: [系统管理员, 编辑, 只读用户]

⚠️ 重要提醒：不要尝试直接对 values() 返回的集合进行 add() 或 remove() 操作，除非你明确知道这是安全的。虽然某些版本允许，但行为不可预测，容易引发 UnsupportedOperationException。

如何遍历 values() 返回的集合？

遍历是 values() 最常见的用途。我们有多种方式，最推荐的是使用增强 for 循环（for-each）。

方法一：增强 for 循环（推荐）

Map<String, Double> prices = new HashMap<>();
prices.put("苹果", 5.5);
prices.put("香蕉", 3.2);
prices.put("橙子", 6.8);

// 使用 values() 遍历所有价格
for (Double price : prices.values()) {
    System.out.println("单价: " + price + " 元");
}

方法二：使用迭代器（Iterator）

适用于需要在遍历过程中删除元素的场景。

Iterator<Double> iterator = prices.values().iterator();

while (iterator.hasNext()) {
    Double price = iterator.next();
    if (price < 5.0) {
        iterator.remove(); // 安全删除小于 5 的价格
    }
}

💡 小技巧：如果你要删除符合条件的值，一定要用迭代器的 remove() 方法，否则会抛出 ConcurrentModificationException。

values() 与 keySet() 的区别

很多初学者容易混淆 values() 和 keySet()。我们来对比一下：

举个例子：你有一个商品库存系统，想找出所有库存为 0 的商品，应该怎么做？

Map<String, Integer> inventory = new HashMap<>();
inventory.put("手机", 10);
inventory.put("耳机", 0);
inventory.put("充电宝", 5);
inventory.put("数据线", 0);

// 使用 values() 遍历所有库存
for (Integer stock : inventory.values()) {
    if (stock == 0) {
        System.out.println("有商品库存为 0");
    }
}

如果用 keySet()，你得先拿到 key，再通过 get(key) 取值，效率更低。

实战案例：统计成绩分布

假设你有一个班级的成绩表，你想知道有多少人考了 90 分以上，多少人低于 60 分。这就是 values() 的典型应用场景。

import java.util.*;

public class GradeAnalysis {
    public static void main(String[] args) {
        Map<String, Integer> grades = new HashMap<>();
        grades.put("张三", 88);
        grades.put("李四", 95);
        grades.put("王五", 76);
        grades.put("赵六", 58);
        grades.put("钱七", 92);
        grades.put("孙八", 65);

        int highScoreCount = 0;   // 90 分以上
        int lowScoreCount = 0;    // 60 分以下

        // 使用 values() 遍历所有成绩
        for (Integer grade : grades.values()) {
            if (grade >= 90) {
                highScoreCount++;
            } else if (grade < 60) {
                lowScoreCount++;
            }
        }

        System.out.println("90 分以上人数: " + highScoreCount);
        System.out.println("60 分以下人数: " + lowScoreCount);
    }
}

输出：

90 分以上人数: 2
60 分以下人数: 1

这个例子展示了 values() 在数据统计中的强大能力——它让你专注于“值”的处理，而无需关心键。

注意事项与常见陷阱

1. 不要对 values() 集合直接修改

Collection<Integer> scores = studentScores.values();

// ❌ 错误操作：直接 add 会抛异常
// scores.add(100); // 抛出 UnsupportedOperationException

// ✅ 正确做法：通过原 map 修改
studentScores.put("新同学", 98);

2. values() 返回的是视图，非副本

修改原 map 会影响 values 集合，反之亦然。

Map<String, String> map = new HashMap<>();
map.put("a", "A");
map.put("b", "B");

Collection<String> values = map.values();

map.put("c", "C");
System.out.println(values); // 输出 [A, B, C] —— 动态更新

values.remove("A");
System.out.println(map); // 输出 {b=B, c=C} —— 键值对也被移除了

3. values() 不能保证顺序

HashMap 本身不保证插入顺序，所以 values() 的顺序也是不确定的。如果需要顺序，应使用 LinkedHashMap 或 TreeMap。

总结：values() 方法的核心价值

Java HashMap values() 方法 是一个简单却强大的工具。它让你可以：

• 快速提取所有“值”进行分析
• 避免冗余的键值获取操作
• 提升代码可读性与执行效率
• 在统计、过滤、聚合等场景中大显身手

无论你是初学者还是中级开发者，掌握 values() 的用法，都是提升 Java 编程能力的重要一步。记住：当你只关心“值”的时候，就用 values()。

下次你在处理 map 数据时，不妨先问问自己：“我需要键吗？还是只关心值？”——答案往往就在 values() 之中。

文末小贴士：在实际项目中，配合 Stream API 使用 values() 会更优雅。比如 map.values().stream().filter(s -> s > 90).count()，能一句话完成统计任务。后续我们再深入讲解。