在 Spring 和 Spring Boot 开发中，@Value 是一个非常常见的注解。很多人第一次接触它时，只知道它可以“给属性赋值”，但真正用起来会发现，@Value 的用途其实很丰富，既能读取配置文件中的值，也能注入系统环境变量、表达式结果，甚至支持默认值和简单计算。

如果你正在学习 Spring 配置注入，或者想提升对 @Value 注解 的理解，这篇文章会用简单易懂的方式，带你总结 @Value 的几种常见用法，帮助你更好地掌握 Spring 配置读取的核心技巧。

一、@Value 是什么

@Value 是 Spring 提供的一个注解，主要作用是把外部值注入到 Java 属性中。这些外部值可以来自：

  • application.properties 或 application.yml 配置文件

  • 系统环境变量

  • Java 表达式（SpEL）

  • 默认值或动态计算结果

它的核心价值很简单：让代码和配置分离。这样做的好处是，程序更灵活，修改参数时不需要频繁改代码。

二、最常见的用法：读取配置文件中的值

这是 @Value 最经典、最常用的场景。我们通常会在配置文件中写入一些参数，比如端口、用户名、开关状态等，然后在代码中直接读取。

例如，在 application.properties 中：

server.port=8080
app.name=SpringDemo
app.version=1.0.0

在 Java 类中可以这样写：

import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Component;

@Component
public class AppInfo {

    @Value("${app.name}")
    private String appName;

    @Value("${app.version}")
    private String version;

    @Value("${server.port}")
    private String port;
}

这里的 ${...} 是 @Value 读取配置项的标准写法。Spring 会自动去配置文件中查找对应的键，并把值注入到变量中。

这种方式非常适合读取简单配置，比如：

  • 应用名称

  • 第三方接口地址

  • 开关配置

  • 超时时间

三、给配置项设置默认值

实际开发中，并不是所有配置项都会存在。如果某个配置没有写，程序可能会报错。为了避免这种情况，@Value 支持设置默认值。

默认值的写法如下：

@Value("${app.name:默认应用}")
private String appName;

这段代码的意思是：如果 app.name 存在，就读取它的值；如果不存在，就使用“默认应用”。

这是一种非常实用的写法，尤其适合以下场景：

  • 某些配置在测试环境中可能没有设置

  • 应用需要提供兜底值

  • 避免因为配置缺失导致启动失败

从 SEO 和实际开发经验来看，Spring Boot 配置默认值 是很多初学者经常搜索的问题，而 @Value 默认值 正是解决这类问题的重要方式。

四、注入基本数据类型

@Value 不仅能注入字符串，还可以注入基本数据类型，比如 int、long、boolean、double 等。Spring 会自动帮你完成类型转换。

例如：

@Value("${app.timeout:30}")
private int timeout;

@Value("${app.debug:false}")
private boolean debug;

@Value("${app.rate:0.75}")
private double rate;

在配置文件中可以这样写：

app.timeout=60
app.debug=true
app.rate=0.9

Spring 会把字符串形式的配置值自动转换成目标类型。这种自动转换机制，减少了很多手动解析代码，让配置读取更方便。

需要注意的是，配置值的格式要正确，比如布尔值一般使用 true 或 false，数字配置要保证能被正常解析，否则会在启动时报错。

五、读取数组和列表

有时候我们需要在配置中保存多个值，比如多个邮箱、多个地址、多个允许访问的域名等。这时，@Value 也可以配合分隔符读取数组或列表。

例如：

app.emails=a@example.com,b@example.com,c@example.com

Java 中可以这样注入：

@Value("#{'${app.emails}'.split(',')}")
private List<String> emails;

也可以注入数组：

@Value("#{'${app.emails}'.split(',')}")
private String[] emails;

这里使用了 SpEL 表达式，先读取配置字符串，再按逗号拆分成多个值。对于简单的多值配置，这种方式很方便。

不过如果你的配置结构较复杂，或者数据量较多，通常更推荐使用 @ConfigurationProperties，因为它更适合批量绑定配置。

六、使用 SpEL 表达式

@Value 的另一个强大能力，是支持 SpEL（Spring Expression Language，Spring 表达式语言）。它可以在注入值时做一些简单计算、拼接或调用方法。

例如：

@Value("#{2 * 3}")
private int result;

运行后，result 的值就是 6。这个功能虽然不常用，但在一些特殊场景下非常实用。

再比如：

@Value("#{'Hello ' + 'Spring'}")
private String message;

这时，message 的值就是 Hello Spring。

SpEL 还可以读取其他 Bean 的属性：

@Value("#{userService.defaultName}")
private String defaultName;

不过在实际开发中要注意，复杂逻辑不要写在 @Value 里。如果表达式太长、太复杂，不仅难维护，也不利于代码可读性。

七、读取系统环境变量和 JVM 参数

@Value 不只可以读取配置文件，还能读取系统环境变量和 JVM 启动参数。这在部署时非常有用。

例如：

@Value("${JAVA_HOME}")
private String javaHome;

或者读取启动参数：

@Value("${server.port}")
private String port;

如果你在启动应用时通过命令行传入参数：

java -jar app.jar --server.port=9090

那么 @Value 也可以正常读取到这个值。这样做的好处是，程序代码无需修改，就能根据部署环境灵活变化。

这也是 Spring 配置管理的一大优势：同一套代码，可以在不同环境使用不同配置。

八、注入资源文件路径

除了普通字符串，@Value 还能用于注入资源路径，比如文件路径、classpath 路径等。这在处理文件上传、模板读取、静态资源引用时很常见。

例如：

@Value("classpath:config/app.properties")
private Resource resource;

或者：

@Value("file:/data/logs/app.log")
private Resource logFile;

通过 Resource 类型，Spring 可以帮你统一处理不同类型的资源路径，使用起来非常方便。

九、@Value 的优点和局限

@Value 虽然好用，但并不是所有配置场景都适合它。了解它的优点和局限，才能更好地使用它。

优点

  • 写法简单，容易上手

  • 适合注入单个配置项

  • 支持默认值和表达式

  • 可直接读取配置文件、环境变量和启动参数

局限

  • 不适合大量配置项批量绑定

  • 复杂对象绑定能力较弱

  • 表达式太多会影响可读性

  • 字段注入方式在某些场景下不利于测试

如果你只是读取少量简单配置，@Value 非常合适；如果你要管理一整组配置，建议考虑 @ConfigurationProperties。

十、@Value 使用时的注意事项

在使用 @Value 注解 时，有几个常见问题值得注意：

  1. 确保 Bean 被 Spring 管理：只有被 Spring 容器托管的类，@Value 才会生效。

  2. 字段不要写成静态变量：@Value 通常不能直接注入 static 字段。

  3. 注意配置键名是否正确：如果拼写错误，可能会导致启动失败或取到默认值。

  4. 复杂配置尽量使用专门的配置类：不要把所有东西都塞进 @Value。

另外，在一些项目中，团队会统一使用 @ConfigurationProperties 来管理配置，减少零散的 @Value 使用。这样更有利于结构化维护。

十一、总结

总的来说，@Value 是 Spring 中一个非常实用的注解，主要用于把外部配置注入到 Java 属性中。它的常见用法包括：

  • 读取配置文件中的值

  • 设置默认值

  • 注入基本数据类型

  • 读取数组和列表

  • 使用 SpEL 表达式

  • 读取系统环境变量和 JVM 参数

  • 注入资源路径

如果你想快速掌握 Spring 配置注入，@Value 用法 是一个很好的起点。它简单、直接、实用，适合处理单个配置项。虽然它不是万能的，但在日常开发中依然很常见。

理解 @Value 的几种常见用法，不仅能帮助你写出更灵活的代码，也能让你更好地理解 Spring 的配置管理机制。对于初学者来说，这是从“会用”到“理解原理”的重要一步。

如果你后续还想深入学习 Spring 配置注入，建议继续了解 @ConfigurationProperties、Environment 和 PropertySource 等相关知识，它们能帮助你建立更完整的配置体系。