spring boot 本身不原生支持 `.env` 文件，该文件需借助 intellij 插件（如 envfile）在 ide 环境中加载；若需跨环境、跨运行方式（如命令行、docker、生产部署）统一管理配置，应优先使用 spring boot 原生机制——`application-{profile}.properties/yml` 配合 `@value` 或 `@configurationproperties` 注入。
? .env 文件的本质：非 Spring Boot 标准，而是开发工具辅助方案
.env 是一种约定俗成的环境变量定义文件格式，起源于 Ruby 的 dotenv 库，后被 Node.js、Python（python-dotenv）等生态广泛采用。其核心作用是：在本地开发阶段，以纯文本方式声明键值对，并由对应工具自动加载为进程级环境变量（System.getenv() 可读取）。
但请注意：Spring Boot 运行时（即 spring-boot-starter 启动容器）默认完全忽略 .env 文件。它既不会解析该文件，也不会将其内容注入 Spring Environment。因此，仅将 .env 放在项目根目录下，对 Spring Boot 应用启动无任何影响。
你观察到“IntelliJ 运行配置中设置环境变量能生效”，正是因为 IntelliJ 在启动 JVM 时，将你手动输入的 DB_NAME=... 直接注入了 JVM 进程环境；而当你安装并启用 EnvFile 插件 后，IDE 会在运行前自动读取 .env（或指定路径的 .env-* 文件），并将其内容作为环境变量传递给 JVM —— 这是 IDE 层面的行为，与 Spring Boot 无关。
✅ 正确启用 EnvFile 插件的步骤（IntelliJ 2024.2+）：
- 安装插件：Settings → Plugins → 搜索 “EnvFile” → Install；
- 启用实验性集成（关键！）：Settings → Tools → EnvFile → ✅ Enable experimental integrations；
- 在 Run Configuration 中勾选 “Load environment variables from file”，并选择你的 .env 文件路径；
- 运行应用后，可通过 System.getenv("DB_NAME") 或 @Value("${DB_NAME}") 正常读取。
⚠️ 注意：此方式仅在 IntelliJ 内有效。若你通过 mvn spring-boot:run、java -jar app.jar 或 Docker 启动，.env 将完全失效。
? Spring Boot 原生推荐方案：application.properties + Profile 分离
Spring Boot 提供了一套强大、标准化、可移植的外部化配置体系。.env 的功能（本地环境变量管理）完全可以且更可靠地通过以下方式实现：
✅ 推荐结构（按环境隔离）
src/main/resources/ ├── application.properties # 公共配置，激活默认 profile ├── application-dev.properties # 开发环境专属（如本地数据库） ├── application-prod.properties # 生产环境专属（如云数据库）
application.properties 示例：
# 激活开发 profile spring.profiles.active=dev # 公共配置（所有环境共享） server.port=8080 spring.application.name=demo-app
application-dev.properties 示例：
# 开发环境专用配置
spring.datasource.url=jdbc:postgresql://localhost:5432/${DB_NAME:demo_db}
spring.datasource.username=${DB_USERNAME:postgres}
spring.datasource.password=${DB_PASSWORD:pass}
# 可直接使用占位符引用环境变量或系统属性，未定义时提供默认值
logging.level.org.springframework.jdbc=DEBUG? 关键优势：
- ✅ 跨平台兼容：无论 Maven、IDE、Docker、Kubernetes，只要正确指定 --spring.profiles.active=dev，配置即生效；
- ✅ 类型安全 & 自动绑定：配合 @ConfigurationProperties 可实现强类型配置类；
- ✅ 层级覆盖明确：命令行参数 > 系统属性 > OS 环境变量 > application-{profile}.properties > application.properties；
- ✅ 支持多文件组合：如 application-dev-db.properties 和 application-dev-cache.properties 同时生效（需 spring.config.import）。
? 示例：类型安全配置类
@Component
@ConfigurationProperties(prefix = "spring.datasource")
@Data // Lombok
public class DataSourceProperties {
private String url;
private String username;
private String password;
// getter/setter 自动生成
}Spring Boot 会自动将 application-dev.properties 中匹配 spring.datasource.* 的属性注入该 Bean。
? 常见误区澄清
| 误区 | 正解 |
|---|---|
| “.env 是 Spring Boot 官方支持的配置方式” | ❌ 官方文档从未提及 .env；Spring Boot 支持的是 application.*、环境变量、JVM 参数等标准来源。 |
| “.env-dev 会被 Spring Boot 自动识别” | ❌ .env-* 是 EnvFile 插件的扩展约定，非 Spring Boot 行为；Spring Boot 的 profile 对应的是 application-dev.*。 |
| “在 application.properties 中写 ${DB_NAME} 就能读 .env” | ❌ 占位符 ${...} 仅从 Spring Environment 中解析（如系统环境变量、JVM -D 参数、application.properties 自身），不解析 .env 文件。 |
✅ 最佳实践总结
- 本地开发：可搭配 EnvFile 插件 + .env 提升 IDE 启动效率，但务必同步维护 application-dev.properties，避免团队成员因插件缺失导致启动失败；
-
CI/CD 与生产部署：彻底弃用 .env，改用：
- Docker：docker run -e DB_NAME=prod_db ...
- Kubernetes：envFrom: configMapRef/name: db-config
- 云平台（如 AWS ECS）：通过任务定义注入环境变量；
- 敏感信息管理：避免在代码库中硬编码密码；生产环境应使用 Vault、AWS Secrets Manager 或加密的 application-prod.properties.gpg（配合 Maven 加密插件）；
- 统一入口：所有配置最终应归一到 Spring Environment，确保 @Value("${xxx}") 或 Environment.getProperty("xxx") 在任意运行环境下行为一致。
通过拥抱 Spring Boot 原生配置模型，你将获得更强的可维护性、可测试性与部署鲁棒性 —— 而 .env，仅是一个便捷但有限的 IDE 辅助工具，切勿将其误认为架构级配置方案。
