当前位置：首页 > news >正文

MySQL开发环境标准化实践：Docker Compose自动化部署与脚本管理

news 2026/5/10 2:02:56

1. 项目概述与核心价值

最近在GitHub上看到一个挺有意思的项目，叫“MySQL_Development_Work”。光看名字，你可能会觉得这又是一个普通的MySQL学习笔记或者代码片段合集。但当我点进去，花时间梳理了它的结构、代码和文档后，我发现它远不止于此。这个项目更像是一个精心设计的“脚手架”或“开发工作流模板”，旨在为那些需要频繁与MySQL数据库打交道的开发者，提供一个开箱即用、结构清晰、且包含最佳实践参考的本地开发环境与工具集。简单来说，它解决了一个很实际的问题：如何快速、规范地启动一个涉及MySQL数据库的本地开发项目，并确保从建库、建表、数据初始化，到后续的脚本管理、版本控制，都有一套现成的、可复用的流程。

对于后端开发、数据分析师、甚至是需要搭建本地测试环境的前端全栈工程师来说，直接上手一个裸的MySQL服务，然后手动创建数据库、执行SQL文件，这个过程既琐碎又容易出错。特别是当项目需要多人协作，或者你需要在不同机器上重建环境时，这种“手工操作”的弊端就更加明显。puneetkumar041/MySQL_Development_Work这个项目，正是为了应对这些痛点而生。它通过一套预定义的目录结构、自动化脚本和示例文件，将数据库开发的“脏活累活”标准化、自动化，让你能更专注于业务逻辑的开发，而不是环境配置的细节。

这个项目的核心价值在于它的“实用性”和“启发性”。它没有试图去讲解高深的数据库原理，而是直接给出了一个“怎么做”的范本。无论你是刚接触MySQL的新手，想学习一个规范的数据库项目该如何组织；还是经验丰富的老手，想为自己的团队寻找一个轻量级的开发流程模板，这个项目都能提供直接的参考。接下来，我将深入拆解这个项目的结构，解析其设计思路，并基于我的经验，补充一套完整的、可操作的本地实践指南，让你不仅能看懂这个项目，更能把它用起来，甚至根据自己的需求进行定制。

2. 项目结构深度解析与设计哲学

打开项目的仓库，你会发现它的结构非常清晰，没有冗余的文件，每个目录和文件都有其明确的职责。这种清晰的结构本身就是第一个值得学习的地方。让我们逐一拆解：

2.1 核心目录结构剖析

典型的MySQL_Development_Work项目结构可能包含以下部分（我根据常见实践和项目描述进行了合理补充）：

MySQL_Development_Work/ ├── README.md ├── docker-compose.yml ├── init-scripts/ │ ├── 01_create_database.sql │ ├── 02_create_tables.sql │ └── 03_insert_sample_data.sql ├── sql-scripts/ │ ├── ddl/ # 数据定义语言：建表、改表、删表 │ ├── dml/ # 数据操作语言：增删改查 │ ├── dql/ # 数据查询语言：复杂查询、报表 │ └── procedures/ # 存储过程、函数 ├── config/ │ └── my.cnf # MySQL自定义配置文件（可选） ├── data/ # Docker数据卷映射目录，用于持久化数据 ├── .env.example # 环境变量示例文件 ├── setup.sh # 环境初始化脚本 └── teardown.sh # 环境清理脚本

为什么这样设计？

分离关注点：将SQL脚本按类型（DDL, DML, DQL, 存储过程）分开，符合SQL语言的自然分类，便于管理和查找。init-scripts目录专门用于环境初始化，确保执行顺序（通过数字前缀如01_, 02_）。
环境即代码：使用docker-compose.yml和.env文件，将MySQL服务及其配置定义为代码。这意味着任何团队成员都可以通过一条命令docker-compose up在本地启动一个完全一致的MySQL实例，彻底消除了“在我机器上是好的”这类环境问题。
自动化脚本：setup.sh和teardown.sh封装了复杂的Docker命令和SQL执行逻辑。对使用者来说，只需运行./setup.sh，就能完成从拉取镜像、启动容器到初始化数据库的全过程，极大降低了上手门槛。
配置与数据分离：config/目录存放可能需要的自定义配置（如字符集、缓冲区大小），data/目录通过Docker卷实现数据持久化，即使容器销毁，数据也不会丢失。

2.2 关键文件内容解读

docker-compose.yml 文件解析这是项目的核心，它定义了MySQL服务。一个典型的配置可能如下：

version: '3.8' services: mysql-dev: image: mysql:8.0 # 指定稳定版本，避免兼容性问题 container_name: mysql_dev_work restart: unless-stopped environment: MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD:-rootpass} # 从.env读取，提供默认值 MYSQL_DATABASE: ${MYSQL_DATABASE:-dev_db} # 初始创建的数据库 MYSQL_USER: ${MYSQL_USER:-dev_user} MYSQL_PASSWORD: ${MYSQL_PASSWORD:-devpass} ports: - "${MYSQL_PORT:-3306}:3306" # 主机端口可配置 volumes: - ./data:/var/lib/mysql # 数据持久化 - ./config/my.cnf:/etc/mysql/conf.d/custom.cnf # 自定义配置 - ./init-scripts:/docker-entrypoint-initdb.d # **关键**：自动执行初始化SQL command: --default-authentication-plugin=mysql_native_password # 兼容旧客户端

注意：/docker-entrypoint-initdb.d这个卷挂载点是MySQL官方镜像的“魔法目录”。容器首次启动时，会自动按字母顺序执行该目录下的所有.sql,.sh,.sql.gz文件。这正是实现数据库自动初始化的关键。

.env.example 文件解析此文件定义了可配置的环境变量，避免了将敏感信息（如密码）硬编码在docker-compose.yml中。

# MySQL Development Environment Variables MYSQL_ROOT_PASSWORD=your_strong_root_password_here MYSQL_DATABASE=application_db MYSQL_USER=application_user MYSQL_PASSWORD=your_strong_user_password_here MYSQL_PORT=3307 # 避免与主机已有MySQL冲突

使用者需要复制此文件为.env并修改其中的值。.env文件通常被.gitignore忽略，保证了安全。

初始化SQL脚本示例 (init-scripts/01_create_tables.sql)这些脚本展示了如何规范地创建表结构。

-- 创建用户表 CREATE TABLE IF NOT EXISTS `users` ( `id` INT UNSIGNED NOT NULL AUTO_INCREMENT, `username` VARCHAR(50) NOT NULL UNIQUE, `email` VARCHAR(100) NOT NULL UNIQUE, `password_hash` CHAR(60) NOT NULL, -- 用于存储bcrypt等哈希值 `created_at` TIMESTAMP DEFAULT CURRENT_TIMESTAMP, `updated_at` TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, PRIMARY KEY (`id`), INDEX `idx_username` (`username`), INDEX `idx_email` (`email`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='用户信息表'; -- 创建订单表 CREATE TABLE IF NOT EXISTS `orders` ( `id` BIGINT UNSIGNED NOT NULL AUTO_INCREMENT, `user_id` INT UNSIGNED NOT NULL, `order_number` VARCHAR(32) NOT NULL UNIQUE, `total_amount` DECIMAL(10, 2) NOT NULL, `status` ENUM('pending', 'processing', 'shipped', 'delivered', 'cancelled') DEFAULT 'pending', `created_at` TIMESTAMP DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (`id`), FOREIGN KEY (`user_id`) REFERENCES `users`(`id`) ON DELETE RESTRICT, INDEX `idx_user_id` (`user_id`), INDEX `idx_order_number` (`order_number`), INDEX `idx_status_created` (`status`, `created_at`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='订单表';

实操心得：在初始化脚本中使用CREATE TABLE IF NOT EXISTS是很好的实践，它使得脚本可以安全地重复执行。同时，显式地指定存储引擎、字符集和校对规则，可以避免因服务器默认配置不同而导致的不一致问题。utf8mb4和utf8mb4_unicode_ci是当前支持完整Unicode（包括emoji）的最佳选择。

3. 从零开始：完整本地开发环境搭建实战

理解了项目结构后，我们动手搭建一个属于自己的MySQL开发环境。这个过程将完全遵循该项目倡导的“自动化”和“可重复”理念。

3.1 环境准备与工具选型

1. 安装Docker与Docker Compose这是整个方案的基石。请根据你的操作系统（Windows/macOS/Linux）访问Docker官网下载并安装Docker Desktop（已包含Compose）。安装后，在终端运行docker --version和docker-compose --version验证安装。

2. 代码编辑器或IDE推荐使用VS Code，并安装以下插件以提升效率：

SQLTools：提供数据库连接、查询执行、结果可视化。
Docker：方便管理容器和镜像。
Prettier或SQL Formatter：自动格式化SQL代码。

3. 图形化数据库客户端（可选但推荐）虽然命令行够用，但图形化工具在数据浏览、表结构设计时更直观。可选：

DBeaver：免费、开源、功能强大，支持多种数据库。
MySQL Workbench：官方工具，在数据库建模方面有优势。
TablePlus：现代、轻量、界面美观（部分功能收费）。

3.2 项目初始化与配置

假设你已经在本地创建了一个新项目目录my-mysql-project。

步骤1：创建核心配置文件

cd my-mysql-project touch docker-compose.yml .env.example README.md mkdir -p init-scripts sql-scripts/{ddl,dml,dql,procedures} config data

步骤2：编写docker-compose.yml将前面解析的docker-compose.yml内容复制进去。

步骤3：配置环境变量复制.env.example为.env，并修改为你自己的值：

cp .env.example .env # 然后使用文本编辑器打开 .env 进行修改

一个安全的密码策略建议：使用长随机字符串，可以借助openssl rand -base64 12命令生成。

步骤4：编写初始化脚本在init-scripts/目录下创建SQL文件。确保命名有顺序，例如：

01_create_database.sql: (可选，因为MYSQL_DATABASE环境变量已创建库) 可以包含CREATE DATABASE IF NOT EXISTS。
02_create_tables.sql: 包含所有DDL建表语句。
03_insert_sample_data.sql: 插入必要的种子数据或测试数据。

步骤5：创建自动化脚本创建setup.sh(Linux/macOS) 或setup.ps1(Windows PowerShell) 来简化流程。

setup.sh (Linux/macOS)

#!/bin/bash # 颜色定义，用于输出美化 GREEN='\033[0;32m' NC='\033[0m' # No Color echo -e "${GREEN}正在启动MySQL开发环境...${NC}" # 检查 .env 文件是否存在 if [ ! -f .env ]; then echo "错误: 未找到 .env 配置文件。" echo "请复制 .env.example 为 .env 并填写必要的配置。" exit 1 fi # 停止并移除可能存在的旧容器（可选，避免端口冲突） docker-compose down # 启动服务（-d 表示后台运行） docker-compose up -d # 等待MySQL服务完全启动 echo -e "${GREEN}等待MySQL服务就绪...${NC}" sleep 10 # 检查容器状态 if docker-compose ps | grep -q "Up"; then echo -e "${GREEN}✅ MySQL开发环境启动成功！${NC}" echo -e "连接信息：" echo -e " 主机: 127.0.0.1" echo -e " 端口: $(grep MYSQL_PORT .env | cut -d '=' -f2)" echo -e " 数据库: $(grep MYSQL_DATABASE .env | cut -d '=' -f2)" echo -e " 用户: $(grep MYSQL_USER .env | cut -d '=' -f2)" else echo -e "❌ 容器启动可能失败，请检查日志：docker-compose logs mysql-dev" exit 1 fi

记得给脚本执行权限：chmod +x setup.sh

setup.ps1 (Windows PowerShell)

Write-Host "正在启动MySQL开发环境..." -ForegroundColor Green # 检查 .env 文件 if (-not (Test-Path .env)) { Write-Host "错误: 未找到 .env 配置文件。" -ForegroundColor Red Write-Host "请复制 .env.example 为 .env 并填写必要的配置。" exit 1 } # 停止旧容器 docker-compose down # 启动服务 docker-compose up -d # 等待 Write-Host "等待MySQL服务就绪..." -ForegroundColor Green Start-Sleep -Seconds 10 # 检查状态 $status = docker-compose ps | Select-String "Up" if ($status) { Write-Host "✅ MySQL开发环境启动成功！" -ForegroundColor Green $envContent = Get-Content .env $port = ($envContent | Select-String "MYSQL_PORT").ToString().Split('=')[1] $db = ($envContent | Select-String "MYSQL_DATABASE").ToString().Split('=')[1] $user = ($envContent | Select-String "MYSQL_USER").ToString().Split('=')[1] Write-Host "连接信息：" -ForegroundColor Cyan Write-Host " 主机: 127.0.0.1" Write-Host " 端口: $port" Write-Host " 数据库: $db" Write-Host " 用户: $user" } else { Write-Host "❌ 容器启动可能失败，请检查日志：docker-compose logs mysql-dev" -ForegroundColor Red }

同样，创建一个teardown.sh或teardown.ps1用于清理环境：

#!/bin/bash echo “正在停止并清理MySQL开发环境...” docker-compose down -v # -v 参数会同时删除数据卷，慎用！通常开发时不加。 echo “环境已清理。”

3.3 启动与验证

现在，运行你的自动化脚本：

./setup.sh

如果一切顺利，你将看到成功提示和连接信息。

验证连接：

使用Docker命令进入容器执行SQL：

docker exec -it mysql_dev_work mysql -u dev_user -p # 输入密码后，执行 SHOW DATABASES; USE your_database_name; SHOW TABLES;

使用图形化客户端连接：
- 主机：127.0.0.1或localhost
- 端口：.env文件中配置的MYSQL_PORT(如 3307)
- 用户名/密码/数据库：.env文件中配置的对应值。

注意事项：首次启动时，因为要执行初始化脚本并初始化数据卷，可能会花费几十秒到一分钟。可以通过docker-compose logs -f mysql-dev命令实时查看日志，观察初始化过程。

4. 高效开发工作流与脚本管理

环境搭好了，接下来是如何在这个标准化环境中进行高效的日常开发。MySQL_Development_Work项目提供的目录结构，为SQL脚本的管理奠定了良好基础。

4.1 SQL脚本的版本控制与执行策略

1. 脚本分类存放

sql-scripts/ddl/：存放所有结构变更脚本。每个变更一个文件，并按日期和顺序命名，例如：20240501_01_add_user_status_column.sql，20240510_01_create_product_table.sql。这清晰地记录了数据库结构的演进历史。
sql-scripts/dml/：存放数据迁移、修复、批量更新脚本。同样建议使用描述性命名，如20240515_backfill_user_avatars.sql。
sql-scripts/dql/：存放复杂的查询、报表SQL。可以按功能或模块组织，如reports/daily_sales_summary.sql。
sql-scripts/procedures/：每个存储过程或函数一个文件，文件名与对象名一致，如usp_get_user_orders.sql。

2. 脚本执行顺序与幂等性所有脚本（尤其是DDL）都必须设计为可重复执行（幂等）。这意味着多次运行同一个脚本不会导致错误或产生重复数据。

使用IF NOT EXISTS/IF EXISTS：如前文建表示例。

使用事务：对于DML脚本，将相关操作包裹在事务中，失败时可以回滚。

START TRANSACTION; -- 你的更新语句 UPDATE table1 SET ...; UPDATE table2 SET ...; -- 检查是否满足条件，不满足则回滚 COMMIT; -- 或 ROLLBACK;

记录执行日志：可以创建一个schema_migrations表，记录已执行的脚本文件名和哈希值，在执行新脚本前先检查，避免重复执行。

4.2 集成到应用开发流程

你的后端应用（如Spring Boot, Django, Express.js）需要连接到这个本地MySQL实例。

1. 应用配置在应用的配置文件中（如application.yml,.env），使用动态的环境变量或配置指向Docker启动的MySQL。

# Spring Boot application.yml 示例 spring: datasource: url: jdbc:mysql://localhost:${MYSQL_PORT:3306}/${MYSQL_DATABASE:dev_db}?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=UTC username: ${MYSQL_USER:dev_user} password: ${MYSQL_PASSWORD} driver-class-name: com.mysql.cj.jdbc.Driver

这里巧妙地使用了与Docker Compose相同的环境变量名，便于统一管理。

2. 使用Flyway或Liquibase进行数据库版本管理对于严肃的项目，建议集成专业的数据库迁移工具（如Flyway）。你可以将sql-scripts/ddl/目录下的文件作为Flyway的迁移脚本（需要遵循其命名规范，如V1__Create_user_table.sql）。这样，应用启动时会自动检查并执行未应用的迁移脚本，确保数据库结构与代码版本同步。

3. 测试数据管理在init-scripts/03_insert_sample_data.sql中准备基础的种子数据（如管理员账号、配置项）。对于更复杂的测试数据，可以：

在sql-scripts/dml/下创建专门的测试数据脚本。
使用像Faker这样的库通过编程语言生成。
使用数据库工具导出生产数据的匿名化快照（需注意数据安全）。

4.3 团队协作规范

当多人基于此模板协作时，需要一些约定：

.env文件不入库：确保.gitignore中包含.env。在README.md中说明如何基于.env.example创建自己的.env。
数据库变更评审：所有提交到sql-scripts/ddl/的脚本，都应像代码一样进行Pull Request评审，关注性能影响（索引）、兼容性、数据一致性等。
统一的连接配置：团队内部约定使用相同的端口和数据库名（在各自的.env中配置），避免连接字符串混乱。
文档更新：任何对项目结构、脚本执行流程的修改，都需要同步更新README.md。

5. 进阶技巧、问题排查与性能调优

掌握了基本流程后，我们来看看如何让这个开发环境更强大、更稳定，并解决可能遇到的问题。

5.1 自定义配置与性能调优

通过config/my.cnf文件，你可以对MySQL实例进行调优，以适应开发需求。

一个基础的开发环境配置示例 (config/my.cnf)：

[mysqld] # 通用设置 character-set-server = utf8mb4 collation-server = utf8mb4_unicode_ci default-storage-engine = InnoDB # 连接设置 max_connections = 200 # 开发环境可以设高一些 wait_timeout = 600 # 防止长时间空闲连接超时 interactive_timeout = 600 # InnoDB 缓冲池 - 根据你的机器内存调整，开发环境可以给多一些 innodb_buffer_pool_size = 256M # 例如，如果机器有8G内存，可以设为1G innodb_log_file_size = 128M # 查询缓存（MySQL 8.0已移除，如果是8.0以下版本可配置） # query_cache_type = 0 # 在8.0以下版本，开发环境通常关闭查询缓存 # 慢查询日志 - 用于捕捉性能不佳的查询，开发时非常有用 slow_query_log = 1 slow_query_log_file = /var/log/mysql/slow.log long_query_time = 1.0 # 执行超过1秒的查询被记录 log_queries_not_using_indexes = 1 # 记录未使用索引的查询 # 错误日志 log_error = /var/log/mysql/error.log [client] default-character-set = utf8mb4

实操心得：innodb_buffer_pool_size是影响InnoDB性能最重要的参数。在开发机上，可以设置为物理内存的50%-70%。开启慢查询日志 (long_query_time设为0.5或1秒) 能帮你快速定位到代码中写的烂SQL。

5.2 常见问题排查实录

问题1：容器启动失败，提示端口已被占用。

排查：运行docker-compose logs mysql-dev查看错误日志。通常会有Bind for 0.0.0.0:3306 failed: port is already allocated类似信息。
解决：
1. 检查.env文件中的MYSQL_PORT是否被主机其他进程（如本地安装的MySQL）占用。使用netstat -an | grep 3306(Linux/macOS) 或Get-NetTCPConnection -LocalPort 3306(PowerShell) 查看。
2. 修改.env中的端口为一个未被占用的端口，如3307。
3. 停止并重启容器：docker-compose down && docker-compose up -d。

问题2：初始化SQL脚本执行出错。

排查：
1. 查看容器日志：docker-compose logs mysql-dev，错误信息通常会直接显示。
2. 进入容器手动执行有问题的SQL文件进行调试：
```
docker exec -it mysql_dev_work bash cd /docker-entrypoint-initdb.d mysql -u root -p < 有问题的文件.sql
```
常见原因与解决：
- 语法错误：仔细检查SQL语句，确保分号、引号正确。
- 依赖顺序：如果02_create_tables.sql中的表引用了01_create_database.sql中创建的数据库，但执行顺序不对，就会失败。确保脚本按数字前缀顺序执行，且依赖关系正确。
- 重复执行：如果容器已经初始化过，再次启动时，/docker-entrypoint-initdb.d目录下的脚本不会再次执行（这是MySQL镜像的机制）。如果需要重新初始化，需要删除数据卷重建：docker-compose down -v && docker-compose up -d。 (注意：-v会清除所有数据！)

问题3：应用程序无法连接到Docker内的MySQL。

排查：
1. 确认容器正在运行：docker-compose ps。
2. 确认端口映射：docker-compose port mysql-dev 3306查看实际映射到主机的端口。
3. 从主机测试连接：mysql -h 127.0.0.1 -P 3307 -u dev_user -p(使用你的端口和用户)。
4. 检查用户权限：进入容器，用root用户登录，检查dev_user是否拥有从%(任意主机) 或172.%(Docker网络) 连接的权限。
```
USE mysql; SELECT Host, User FROM user WHERE User='dev_user'; -- 如果Host是localhost，需要授权 GRANT ALL PRIVILEGES ON dev_db.* TO 'dev_user'@'%' IDENTIFIED BY 'your_password'; FLUSH PRIVILEGES;
```
- 注意：在docker-compose.yml中通过环境变量创建的用户，默认主机是%，通常可以连接。如果不行，可能是防火墙或Docker网络问题。

5.3 数据备份与恢复

开发过程中，有时需要备份当前数据状态或恢复到某个快照。

1. 使用mysqldump备份

# 在主机上执行，将容器内的数据库导出到主机 docker exec mysql_dev_work mysqldump -u root -p[密码] dev_db > backup_$(date +%Y%m%d).sql # 更安全的方式（密码通过环境变量或交互输入）： docker exec -i mysql_dev_work mysqldump -u root -p"$MYSQL_ROOT_PASSWORD" dev_db > backup.sql

2. 从备份文件恢复

# 将备份文件复制到容器内，然后导入 docker cp backup.sql mysql_dev_work:/tmp/backup.sql docker exec -i mysql_dev_work mysql -u root -p"$MYSQL_ROOT_PASSWORD" dev_db < /tmp/backup.sql # 或者直接从主机管道导入 cat backup.sql | docker exec -i mysql_dev_work mysql -u root -p"$MYSQL_ROOT_PASSWORD" dev_db

3. 利用Docker卷快照（更底层）由于数据持久化在主机./data目录，你可以直接备份这个目录。停止容器后，打包data目录即可。恢复时，停止容器，清空现有data目录，解压备份文件，再启动容器。

5.4 扩展：集成其他服务

一个完整的开发环境可能不止MySQL。你可以轻松扩展docker-compose.yml，加入其他服务，如：

Redis：用于缓存。
Elasticsearch：用于搜索。
phpMyAdmin：Web版MySQL管理工具。

version: '3.8' services: mysql-dev: # ... 原有配置不变 phpmyadmin: image: phpmyadmin/phpmyadmin container_name: phpmyadmin_dev restart: unless-stopped ports: - "8080:80" environment: PMA_HOST: mysql-dev # 使用Docker服务名连接 PMA_PORT: 3306 UPLOAD_LIMIT: 128M depends_on: - mysql-dev

这样，你就可以通过http://localhost:8080访问phpMyAdmin来管理数据库了。

6. 项目总结与个性化定制建议

经过以上从结构解析到实战搭建，再到进阶管理的完整流程，我们可以看到puneetkumar041/MySQL_Development_Work这个项目模板的精髓在于“约定大于配置”和“自动化优先”。它提供了一套经过思考的最佳实践起点，而不是一个僵化的框架。

我个人在实际使用和推广这类模式中的体会是：

起步即规范：对于新项目或新团队成员，最大的好处是无需争论环境怎么搭、SQL脚本怎么放。直接克隆这个模板，就能得到一个业界公认的、整洁的起点，节省了大量前期决策和沟通成本。
降低心智负担：docker-compose up和./setup.sh这类一键命令，将复杂的底层细节隐藏起来。开发者只需要关心业务SQL和代码，不需要记忆繁琐的安装和配置步骤，尤其是在操作系统更换或机器更替时，优势极其明显。
促进DevOps文化：它将基础设施的定义（Infrastructure as Code）引入了日常开发。即使是纯开发人员，也会开始接触并理解容器、编排、环境变量等概念，为后续的CI/CD和云原生部署打下良好基础。

最后再分享几个根据团队实际情况进行个性化定制的建议：

对于小型项目或个人学习：可以简化结构，去掉sql-scripts的复杂子目录，一个scripts文件夹放所有SQL也行。setup.sh脚本也可以简化，甚至直接写进README.md的步骤里。
对于中大型团队项目：强烈建议引入数据库迁移工具（Flyway/Liquibase）。可以将init-scripts仅用于创建最基本的、与迁移工具本身相关的表（如flyway_schema_history），其他所有表结构变更都通过迁移工具来管理。sql-scripts目录则可以存放不需要版本控制的临时查询、数据分析脚本等。
对于微服务架构：可以为每个微服务配备一个这样的“数据库开发环境”目录。在顶层的docker-compose.yml中，将所有这些服务（MySQL, Redis, 应用本身）编排在一起，实现一键启动整个开发栈。
关于数据安全：务必在.env.example中强调使用强密码，并确保.env文件不被提交。对于生产环境的配置，应使用更安全的密钥管理服务，切勿将生产密码硬编码或放入版本库。