# Springboot yml怎麼獲取系統環境變量的值

## 引言

在現代應用開發中，**配置管理**是至關重要的一環。Spring Boot作為Java生態中最流行的框架之一，提供了強大的配置管理能力，其中`application.yml`（或`application.properties`）是默認的配置文件格式。而將系統環境變量與YAML配置結合使用，可以實現更靈活的部署方案。本文將深入探討如何在Spring Boot的YAML配置中獲取系統環境變量的值。

---

## 目錄
1. [環境變量與配置的關係](#環境變量與配置的關係)
2. [YAML基礎語法回顧](#yaml基礎語法回顧)
3. [Spring Boot中引用環境變量](#spring-boot中引用環境變量)
   - [3.1 直接引用語法](#31-直接引用語法)
   - [3.2 默認值設置](#32-默認值設置)
   - [3.3 嵌套屬性引用](#33-嵌套屬性引用)
4. [操作系統環境變量設置](#操作系統環境變量設置)
   - [4.1 Linux/Mac](#41-linuxmac)
   - [4.2 Windows](#42-windows)
5. [高級用法](#高級用法)
   - [5.1 多環境配置](#51-多環境配置)
   - [5.2 自定義前綴](#52-自定義前綴)
   - [5.3 加密處理](#53-加密處理)
6. [調試與常見問題](#調試與常見問題)
7. [最佳實踐](#最佳實踐)
8. [總結](#總結)

---

## 環境變量與配置的關係

系統環境變量是操作系統級別的鍵值對存儲，具有以下特點：
- **全局可見性**：所有進程均可訪問
- **運行時注入**：無需修改代碼即可改變應用行為
- **安全性**：敏感信息可避免硬編碼

在Spring Boot中，環境變量的優先級高於`application.yml`中的配置（遵循[特定優先級規則](https://docs.spring.io/spring-boot/docs/current/reference/html/features.html#features.external-config)）。

---

## YAML基礎語法回顧

YAML（YAML Ain't Markup Language）是常用的配置文件格式，比Properties文件更具可讀性：

```yaml
server:
  port: 8080
  servlet:
    context-path: /api

server.port=8080
server.servlet.context-path=/api

database:
  url: ${DB_URL}
  username: ${DB_USER}
  password: ${DB_PASSWORD}

app:
  cache-size: ${CACHE_SIZE:100}  # 默認值100

spring:
  datasource:
    url: jdbc:mysql://${DB_HOST:localhost}:${DB_PORT:3306}/${DB_NAME}

# 臨時設置
export DB_URL=jdbc:mysql://localhost:3306/mydb

# 永久設置（添加到~/.bashrc或~/.zshrc）
echo "export DB_USER=admin" >> ~/.bashrc
source ~/.bashrc

:: 臨時設置
set DB_PASSWORD=secret

:: 永久設置（系統屬性→高級→環境變量）

# application-dev.yml
database:
  url: ${DEV_DB_URL}
  
# application-prod.yml  
database:
  url: ${PROD_DB_URL}

java -jar app.jar --spring.profiles.active=prod

@Configuration
@ConfigurationProperties(prefix = "myapp")
public class AppConfig {
    private String apiKey;
    // getters & setters
}

myapp:
  api-key: ${API_KEY}

database:
  password: ENC(${ENCRYPTED_DB_PASSWORD})

@SpringBootApplication
public class MyApp {
    public static void main(String[] args) {
        SpringApplication.run(MyApp.class, args)
            .getEnvironment().getPropertySources().forEach(ps -> {
                System.out.println(ps.getName() + ": " + ps.getSource());
            });
    }
}