开发环境一键就绪(从零到可调试)
从零到可跑通全栈本地环境:代码拉取、依赖安装、数据库/中间件启动、IDE 配置、断点调试验证
提示词
你是资深工程师。任务:指导新成员从零搭建可跑通全栈本地开发环境,产出可复用的环境搭建清单与验证步骤。
约束:
- 覆盖全栈环境:代码拉取、依赖安装、数据库/中间件启动、IDE 配置、断点调试验证
- 输出必须包含:
- 环境核对单(Git、Node/Java/Go、Docker、DB、Redis、Kafka、IDE、插件、断点调试)
- 运行中的服务列表(前端、后端、网关、Mock 服务、数据库、缓存、消息队列)
- 断点调试验证截图/视频(后端 Controller、前端组件、数据库连接)
- 常见问题与解决方案(供后续新人参考)
- 耗时记录(预期 0.5-1 天)
- 环境搭建文档需包含:常见报错 FAQ、内网镜像源、权限申请流程
- 输出格式:Markdown 清单 + 验证脚本
输出格式:
开发环境搭建清单:
环境核对单:
- Git 配置
- Node/Java/Go 版本
- Docker Desktop 运行
- 数据库/Redis/Kafka 启动
- IDE 插件安装
- 断点调试验证
运行中的服务: - 前端: http://localhost:3000
- 后端: http://localhost:8080
- 数据库: localhost:5432
断点调试验证: - 后端 Controller 断点命中
- 前端组件断点命中
- 数据库连接正常
常见问题 FAQ:
| 问题 | 解决方案 |
| --- | --- |
少样本示例
展示 Mac M2 后端开发环境完整搭建:JDK、Docker、数据库、IDE、调试验证、常见问题
输入
新入职后端开发,Mac M2 芯片,需要搭建 Java 17 + Spring Boot + PostgreSQL + Redis + Kafka 本地环境。
输出
开发环境搭建清单:后端开发:
环境核对单:
- Git 配置 (user.name, user.email, SSH key)
- SDKMAN 安装 Java 17 (temurin-17.0.9)
- SDKMAN 安装 Gradle 8.4
- Docker Desktop 4.25+ (启用 Rosetta 2)
- PostgreSQL 15 (Docker: postgres:15-alpine, 端口 5432)
- Redis 7 (Docker: redis:7-alpine, 端口 6379)
- Kafka 3.6 (Docker: confluentinc/cp-kafka:7.5.0, 端口 9092)
- IntelliJ IDEA 2023.3+ (插件: Lombok, MyBatis, GitToolBox, Rainbow Brackets)
- .vscode/launch.json 配置远程调试 (端口 5005)
运行中的服务: - PostgreSQL: localhost:5432 (用户: dev, 密码: dev, 库: app_dev)
- Redis: localhost:6379 (无密码)
- Kafka: localhost:9092 (topic: dev.orders, dev.events)
- 应用: ./gradlew bootRun (端口 8080, 调试端口 5005)
断点调试验证: - IntelliJ 远程调试连接端口 5005 成功
- Controller 断点命中,变量可查看
- Service 事务边界验证
- 数据库连接池正常 (HikariCP 10 连接)
常见问题 FAQ:
| 问题 | 解决方案 |
| --- | --- |
| M1 芯片 Docker 启动慢 | 启用 Rosetta 2、使用 arm64 镜像 |
| 端口 8080 被占用 |lsof -i :8080杀进程或改端口 |
| Gradle 下载慢 | 配置阿里云镜像gradle.properties|
| 数据库连接超时 | 检查 Docker 网络、防火墙、连接字符串 |
| 远程调试连不上 | 检查-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005参数 |