新建application.yml文件

### 如何新建并配置 `application.yml` 文件 在 Spring Boot 中，`application.yml` 是一种 YAML 格式的配置文件，用于定义应用程序的各种属性和行为。以下是关于如何新建该文件及其格式和示例的内容。 #### 新建 `application.yml` 文件 要创建一个新的 `application.yml` 文件，请按照以下方法操作： 1. **项目目录位置** 将 `application.yml` 放置在项目的资源目录下，即 `src/main/resources/` 路径中[^2]。这是 Spring Boot 默认查找配置文件的位置。 2. **文件命名** 确保文件名为 `application.yml` 或者其他符合 Spring Boot 命名约定的变体（如 `application-dev.yml`, `application-prod.yml`），以便支持多环境配置[^4]。 3. **编辑器选择** 使用任何文本编辑器或者 IDE（如 IntelliJ IDEA, Eclipse）打开 `src/main/resources/` 目录，并新增一个名为 `application.yml` 的文件。 --- #### `application.yml` 文件的基本格式 YAML 是一种人类可读的数据序列化标准，其语法简单明了。以下是它的基本规则： - 键值对之间使用冒号分隔 (`key: value`)。 - 缩进表示层级关系，必须使用空格而不是制表符 (Tab)。 - 同一层级下的键值对需保持相同的缩进量。 例如： ```yaml server: port: 8080 spring: datasource: url: jdbc:mysql://localhost:3306/mydb username: root password: secret logging: level: root: INFO ``` 上述例子展示了如何配置服务器端口、数据库连接信息以及日志级别[^5]。 --- #### 示例：完整的 `application.yml` 配置 下面是一个典型的 `application.yml` 文件内容，涵盖了多个常见的配置项： ```yaml # Server Configuration server: port: 8081 servlet: context-path: /api # Database Configuration spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/test_db?useSSL=false&serverTimezone=UTC username: admin password: passw0rd jpa: hibernate: ddl-auto: update show-sql: true # Logging Configuration logging: level: org.springframework.web: DEBUG com.example.myapp: TRACE file: name: logs/app.log # Cache Configuration spring.cache.type: redis # Mail Service Configuration spring.mail: host: smtp.gmail.com port: 587 username: [email protected] password: email-password properties: mail: smtp: auth: true starttls: enable: true ``` 此示例包含了服务器端口、上下文路径、数据库连接、JPA 设置、日志记录、缓存类型以及邮件服务的相关配置[^1]。 --- #### 多环境配置 为了适应不同运行环境的需求，可以通过创建多个配置文件实现多环境支持。例如： - `application.yml`: 定义通用配置。 - `application-dev.yml`: 开发环境专用配置。 - `application-prod.yml`: 生产环境专用配置。 通过设置 `spring.profiles.active` 属性指定当前激活的环境。例如，在开发环境中启动应用时可以添加如下参数： ```bash java -jar my-app.jar --spring.profiles.active=dev ``` 这会加载 `application-dev.yml` 中的特定配置。 --- #### 注意事项 1. **缩进一致性**: YAML 对缩进非常敏感，错误的缩进可能导致解析失败。 2. **字符编码**: 推荐使用 UTF-8 编码保存文件，以避免特殊字符引发问题。 3. **安全性**: 敏感信息（如密码）不应直接写入版本控制系统，建议采用外部化的加密方式存储[^3]。 ---