企业官网建设流程全解析

简介：基于Java技术栈的孕妇母婴知识交流分享系统完整项目文档，面向具备一定编程基础的Java研发人员、医疗信息化从业者以及相关专业学生与研究人员。文档围绕系统的设计与实现展开，涵盖项目背景与目标、技术架构、功能模块划分、数据库设计、代码实现、性能优化、安全措施等完整环节，详细分析了信息可信度、用户需求多样性、平台安全与隐私保护等七大挑战及对应解决方案。资源包共1个文件，为完整的docx格式技术文档，体积约78KB，内容结构清晰，章节划分细致，便于按模块查阅定位。已有42人学习下载。读者可从中获得完整的系统设计思路、数据库与GUI设计细节、前后端分离架构说明、核心代码实现解析及性能调优方法，并有面向未来的改进方向，如引入更多专家资源、拓展国际市场、强化AI算法等，对同类健康管理平台的研发具有良好的参考价值与启发性。

1. 孕妇母婴知识交流分享系统：从课程设计到能演示的完整项目，难点不在代码而在这三处

做一套基于 Java 的孕妇母婴知识交流分享系统，听起来像是个标准课设题：无非是登录注册、文章列表、问答帖子和个人中心。但真正动手后你会发现，卡住你的不是 Java 语法，而是三件容易被低估的事——GUI 框架的选型与布局、数据库表之间的关联设计、以及把 Swing 界面和 JDBC 代码串起来之后的那一堆乱码和卡顿问题。这套系统面向的用户是孕妇和家属，核心功能是知识文章阅读、经验交流问答和孕期记录。它的代码量不大，但胜在五脏俱全，特别适合用来打通 Java 基础语法、数据库增删改查、面向对象编程这几块知识。适合正在做毕设，或者打算把手里的 Java 项目从控制台升级成带 GUI 的完整系统的读者。

2. 技术选型：JFrame 还是 JavaFX？MySQL 还是 SQLite？先定这四个决定成败的选项

2.1 GUI 框架选型：Swing 的成熟稳定 vs JavaFX 的现代外观

孕妇母婴知识交流分享系统这类项目，绝大多数场景是单机演示、答辩展示或课程验收，对界面的要求是“看起来像个正经系统”，但不要求达到商业产品的水准。常见做法是选 Swing，理由非常实在：JDK 自带，不用额外引入运行时库；资料多，遇到问题搜得到；只要注意布局和字体，做出来的界面并不丑。JavaFX 虽然外观更现代，但它需要单独配置 SDK，在部分学校电脑和远程演示环境里容易出现版本不匹配的尴尬。

我一般建议用 Swing + JFrame 作为主窗口容器，配合 JTabbedPane 做功能分区。这样代码结构清晰，每个 Tab 对应一个业务模块，后期维护也方便。下面是一个主窗口的最小骨架，包含了菜单栏、标签页和状态栏：

JFrame mainFrame = new JFrame("孕妇母婴知识交流分享系统"); mainFrame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); mainFrame.setSize(1000, 720); mainFrame.setLocationRelativeTo(null); // 居中显示 JTabbedPane tabPane = new JTabbedPane(); tabPane.addTab("知识浏览", new KnowledgePanel()); tabPane.addTab("经验问答", new QAForumPanel()); tabPane.addTab("孕期记录", new PregnancyRecordPanel()); tabPane.addTab("个人中心", new ProfilePanel()); mainFrame.setContentPane(tabPane); mainFrame.setVisible(true);

这段代码的逻辑很直白：创建主窗口，把四个业务面板塞进标签页容器，最后显示。注意setLocationRelativeTo(null)这一步很容易被漏掉，少了它窗口会出现在屏幕左上角，第一印象就很扣分。每个Panel都是独立的JPanel子类，内部各自管理自己的组件和数据刷新逻辑，不要在 Main 类里堆上千行业务代码，那是新手最容易犯的错误。

2.2 数据库选型：MySQL 适合答辩展示，SQLite 适合本地演示

这个项目的数据量不会大，但涉及用户、文章、评论、问答、收藏五类实体，存在明显的关联关系。如果是在机房演示或者答辩，MySQL 8.0 是更稳妥的选择——老师看到 MySQL 客户端里的表结构和数据，会觉得项目更完整、认可度更高。MySQL 还方便现场执行 SQL 去验证数据，比如select * from article where category = '孕期营养'，这种现场演示对答辩加分明显。

SQLite 则适合那种“不想装数据库服务”的场景。它打包进项目里就能跑，方便拷贝演示。但 SQLite 在并发写入上有天然的弱势，而且如果你用了 MyBatis-Plus，想根据实体类自动生成建表 SQL，MySQL 的支持更友好。这里我强烈建议：课程设计、毕设项目优先选 MySQL，别给自己挖坑。

2.3 分层架构：entity / dao / service / ui / util 五个包各司其职

很多读者会问，一套完整的系统代码该怎么组织？我见过太多人把数据库连接、界面渲染、业务判断全写在一个类里。这种代码跑通没问题，但一旦要加功能，改起来想死的心都有。常见的做法是分五层，简单但够用：

分层之后，ui层只负责渲染和调用service，service层只处理业务规则，dao层只做 JDBC。这样各层都可以单独测试，踩坑时定位问题也快。举个例子，注册新用户时，界面把用户输入的username和password传给UserService.register()，密码先做 MD5 加密，再调用UserDao.insert()落库。界面层永远不出现INSERT语句，DAO 层永远不弹窗。

2.4 JDK 版本与项目构建工具的选择

这个标题对应的典型场景是课设和毕设，所以 JDK 8 仍然是最安全的选择。不要用 JDK 17 甚至 21，倒不是说语法不支持，而是部分旧教程使用的第三方库在 JDK 17 下会报模块访问错误，比如 JavaFX、部分 JDBC 驱动。我建议用 JDK 8 + 手动管理 jar 包就够了，不必引入 Maven——虽然 Maven 是正规军，但对于一个演示型项目，Maven 的依赖下载、仓库配置，本身就容易变成新的坑。

如果你决定用 Maven，最好统一用阿里云镜像，否则首次构建下载依赖的等待时间足够劝退不少人。我这里给出两种方式，读者按自己的习惯选。手动管理 jar 时，项目根目录下的lib文件夹放驱动包，IDE 里右键 Add as Library 即可，简单粗暴。

3. 数据库设计：从怀孕周期到问答帖子的五张核心表，以及建表 SQL 和 CRUD 封装

3.1 数据模型设计：用户、文章、评论、问答、孕期记录之间的关联

一套母婴知识交流系统，数据模型要比普通博客系统多出两个特殊性：一是用户有孕妇和普通用户（比如家属）的区分，二是需要记录孕期周数。因此用户表里要加userType和dueDate（预产期）字段。文章表要区分分类，比如孕早期、孕中期、孕晚期、产后护理、新生儿喂养。问答表则记录提问和回复，一个提问可以对应多个回答，所以设计成question和answer两张表更合理。

我给出一套经过简化但足够完整的表结构设计。这套设计的核心思想是：每张表都有create_time用于展示“最新”；每张业务表都保留user_id外键，方便查“某人发了什么”。字段类型上，标题用varchar(100)，正文字段用text，不要用varchar(5000)这种做法，MySQL 里text类型在存储和索引上更合适。

3.2 建表 SQL：从实体类到建表语句的两种落地路径

如果你是手写 JDBC 的路线，建表脚本直接放在sql/init.sql里。另一个热门的做法是用 MyBatis-Plus 根据实体类自动生成建表 SQL——这个功能在热词里出现频率很高。它的好处是：实体类字段一改，表结构跟着变，适合开发期频繁调整数据模型的阶段。但 MyBatis-Plus 的自动建表需要引入mybatis-plus-boot-starter和对应的数据库方言配置，而且它在字段类型映射上有自己的规则，比如LocalDateTime映射为datetime，String默认映射为varchar(255)。如果对表结构有精细控制需求，比如想把content映射为longtext，还是得手写建表 SQL 再做微调。

以下是核心三张表的建表脚本，覆盖了用户、文章、问答三个主要业务域：

CREATE TABLE `user` ( `id` INT PRIMARY KEY AUTO_INCREMENT, `username` VARCHAR(50) NOT NULL UNIQUE, `password` VARCHAR(64) NOT NULL COMMENT 'MD5加密后的密码', `nickname` VARCHAR(50) DEFAULT '', `user_type` TINYINT DEFAULT 0 COMMENT '0-孕妇 1-家属 2-管理员', `due_date` DATE DEFAULT NULL COMMENT '预产期', `create_time` DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; CREATE TABLE `article` ( `id` INT PRIMARY KEY AUTO_INCREMENT, `user_id` INT NOT NULL, `title` VARCHAR(100) NOT NULL, `category` VARCHAR(30) NOT NULL COMMENT '孕早期/孕中期/孕晚期/产后/喂养', `content` TEXT NOT NULL, `view_count` INT DEFAULT 0, `create_time` DATETIME DEFAULT CURRENT_TIMESTAMP, CONSTRAINT `fk_article_user` FOREIGN KEY (`user_id`) REFERENCES `user`(`id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; CREATE TABLE `question` ( `id` INT PRIMARY KEY AUTO_INCREMENT, `user_id` INT NOT NULL, `title` VARCHAR(100) NOT NULL, `description` TEXT, `create_time` DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; CREATE TABLE `answer` ( `id` INT PRIMARY KEY AUTO_INCREMENT, `question_id` INT NOT NULL, `user_id` INT NOT NULL, `content` TEXT NOT NULL, `create_time` DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

建表时有三个参数需要特别注意。第一是utf8mb4，MySQL 8.0 默认就是这个字符集，它支持 emoji 和完整的中文；如果用了utf8，部分生僻字和特殊符号会报错。第二是外键约束FOREIGN KEY，它能保证数据的完整性，比如删除用户时，如果发现他还有关联文章，会阻止删除，避免“用户没了文章还在”的脏数据。第三是AUTO_INCREMENT主键，它是这套系统的默认主键策略，简单可靠，不要在这个项目里试图搞 UUID 主键，除非你对分布式系统有特殊的执念。

3.3 DAO 层封装：连接池、PreparedStatement 与增删改查的模板代码

DAO 层是这套系统里最重要的部分。数据库连接的管理是一个高频踩坑点。最传统的DriverManager.getConnection()会导致每次数据库操作都建立新的物理连接，而 MySQL 默认的wait_timeout是 8 小时，空闲久了连接会断，系统运行一段时间后再点按钮就会报“连接早已关闭”的错。解决方式是使用连接池，比如 Druid 或 HikariCP。

下面是一个基于 Druid 连接池的DBUtil核心代码，所有 DAO 类都通过它获取连接：

public class DBUtil { private static DruidDataSource dataSource; static { dataSource = new DruidDataSource(); dataSource.setUrl("jdbc:mysql://localhost:3306/maternal_db?useSSL=false&serverTimezone=Asia/Shanghai&characterEncoding=utf8"); dataSource.setUsername("root"); dataSource.setPassword("your_password"); dataSource.setInitialSize(5); // 启动时建立5个连接 dataSource.setMaxActive(20); // 最大连接数 dataSource.setMinIdle(5); // 最小空闲连接数 } public static Connection getConnection() throws SQLException { return dataSource.getConnection(); } }

serverTimezone=Asia/Shanghai这个参数很关键。MySQL 8.0 的驱动（com.mysql.cj.jdbc.Driver）要求必须设置时区，否则抛异常。characterEncoding=utf8是配合数据库端的utf8mb4，保证中文数据不会乱码。useSSL=false是在本地开发时关闭 SSL 握手，能减少几次不必要的网络往返。

有了连接池，接下来就是一个标准的增删改查模板。比如查询全部文章并返回列表：

public List<Article> findAll() { List<Article> list = new ArrayList<>(); String sql = "SELECT id, user_id, title, category, content, view_count, create_time FROM article ORDER BY create_time DESC"; try (Connection conn = DBUtil.getConnection(); PreparedStatement ps = conn.prepareStatement(sql); ResultSet rs = ps.executeQuery()) { while (rs.next()) { Article a = new Article(); a.setId(rs.getInt("id")); a.setUserId(rs.getInt("user_id")); a.setTitle(rs.getString("title")); a.setCategory(rs.getString("category")); a.setContent(rs.getString("content")); a.setViewCount(rs.getInt("view_count")); a.setCreateTime(rs.getTimestamp("create_time")); list.add(a); } } catch (SQLException e) { e.printStackTrace(); } return list; }

这段代码里用了 try-with-resources，它保证Connection、PreparedStatement、ResultSet在方法结束时自动关闭，避免连接泄漏。这也是很多老项目内存飙高的原因——开发者只关了ResultSet，或者把Connection留在局部变量里忘记了close()。

注意，不要把Connection做成静态字段共享。Swing 界面是有多线程的，一个长时间执行的查询在后台线程里跑，用户又发起新请求，静态连接会出现并发占用问题。每次都从连接池获取连接，成本极低，是安全的做法。

3.4 参数化查询与 SQL 注入：按标题搜索的正确写法

母婴系统的文章搜索功能必然用到模糊查询。新手最容易写成字符串拼接：

String sql = "SELECT * FROM article WHERE title LIKE '%" + keyword + "%'";

这样写的后果是，用户输入%' OR '1'='1就能把全表数据拉出来。这类系统虽然数据不敏感，但答辩时被老师当面指出 SQL 注入漏洞，印象分会大打折扣。正确做法是用PreparedStatement的参数占位符：

public List<Article> searchByTitle(String keyword) { String sql = "SELECT * FROM article WHERE title LIKE ? ORDER BY create_time DESC"; try (Connection conn = DBUtil.getConnection(); PreparedStatement ps = conn.prepareStatement(sql)) { ps.setString(1, "%" + keyword + "%"); try (ResultSet rs = ps.executeQuery()) { // 装配结果集 } } }

参数化查询除了防注入，还有一个实际好处：MySQL 会对预编译语句做缓存，同一 SQL 结构只编译一次，反复执行时性能比字符串拼接好不少。这个优化在数据量只有几百条时感受不到，但它是 Java 工程师必须养成的习惯。

4. GUI 界面实现：用 Java Swing 把系统拆成四个功能面板

4.1 登录与注册模块：MD5 加密和输入校验

登录界面是用户看到的第一个界面，也是答辩时老师第一眼看到的界面，视觉上不能掉链子。常见做法是JPanel自定义背景色 + GridBagLayout 或null布局手动控制坐标。对于新手，null布局上手最快——你直接指定每个组件的坐标和宽高，所见即所得。

JPanel loginPanel = new JPanel(); loginPanel.setLayout(null); JLabel userLabel = new JLabel("用户名"); userLabel.setBounds(240, 220, 80, 30); JTextField userField = new JTextField(); userField.setBounds(320, 220, 200, 30); JPasswordField passField = new JPasswordField(); passField.setBounds(320, 270, 200, 30); JButton loginBtn = new JButton("登 录"); loginBtn.setBounds(270, 330, 120, 40); loginBtn.setBackground(new Color(214, 87, 127)); // 柔和的粉色系 loginBtn.setForeground(Color.WHITE); loginPanel.add(userLabel); loginPanel.add(userField); loginPanel.add(passField); loginPanel.add(loginBtn);

setBounds是null布局的核心方法，四个参数分别是 x、y、宽、高。这里有一个注意点：窗口的setResizable(false)建议开启，否则窗口拉大后组件不会跟着自适应，界面会显得很空。密码框用JPasswordField而不是JTextField，它自带掩码效果，避免密文裸奔在屏幕上。

登录的事件监听里，需要先做非空校验，再查数据库比对密码。MD5 加密是典型的工具类逻辑，归到util包。注意 MD5 只能做单向散列，不能解密，所以注册时加密一次存库，登录时同样哈希后比对。

4.2 主界面布局：JTabbedPane 四个标签页，让功能分区一目了然

主界面采用JTabbedPane后，四个模块的切换逻辑完全交给 Swing，不用自己维护状态。知识浏览页是最核心的页面，左侧是文章分类列表JList，右侧是文章标题JTable，点击表格行后，下方加载正文。

界面和数据之间的交互逻辑是这样的：初始化时调用ArticleDao.findByCategory("全部")拿到所有文章，填充到表格；点击"孕早期"分类时，调用ArticleDao.findByCategory("孕早期")刷新表格；双击表格行时，根据文章 id 查询详情。这里面有个常见的性能问题：每次切换分类都全表查询，对本地演示项目不是问题。但你必须在代码里写好排序规则，否则文章列表乱序呈现，老师看了会觉得系统逻辑混乱。默认按create_time DESC排序，把最新的知识放在最上面，是知识社区产品的标准行为。

4.3 JTable 绑定数据库数据：自定义表格模型和渲染

JTable 的默认模型不适合直接拿ResultSet塞进去。正确做法是继承AbstractTableModel，底层用一个List<Article>保存数据，这样表格和数据库查询解耦。

class ArticleTableModel extends AbstractTableModel { private String[] columns = {"ID", "标题", "分类", "发布时间", "浏览量"}; private List<Article> data = new ArrayList<>(); public void setData(List<Article> dataList) { this.data = dataList; fireTableDataChanged(); // 通知JTable刷新 } @Override public int getRowCount() { return data.size(); } @Override public int getColumnCount() { return columns.length; } @Override public Object getValueAt(int rowIndex, int columnIndex) { Article a = data.get(rowIndex); switch (columnIndex) { case 0: return a.getId(); case 1: return a.getTitle(); case 2: return a.getCategory(); case 3: return a.getCreateTime(); case 4: return a.getViewCount(); default: return ""; } } }

注意fireTableDataChanged()这行代码，它是后台数据更新后通知界面刷新的关键。很多读者遇到"数据明明改了，表格不刷新"的玄学问题，就是因为把数据设置到了局部变量但没通知模型刷新。之后在主界面调用方式如下：

ArticleTableModel model = new ArticleTableModel(); articleTable.setModel(model); model.setData(articleDao.findAll());

4.4 事件监听与 Swing 单线程模型：为什么界面会卡住

Swing 是单线程模型——所有界面操作必须在事件分发线程（EDT）上执行。如果你在按钮点击事件里直接执行数据库查询，而网络恰好有延迟，界面的按钮会一直处于按下状态，窗口拖动也会卡死。

处理方式是使用SwingWorker做后台异步查询。比如点击"查询问答"按钮时，后台线程取数，完成后在 EDT 上刷新表格：

JButton searchBtn = new JButton("搜索问答"); searchBtn.addActionListener(e -> { String keyword = searchField.getText().trim(); new SwingWorker<List<Question>, Void>() { @Override protected List<Question> doInBackground() { return qaDao.searchQuestions(keyword); } @Override protected void done() { try { List<Question> result = get(); qaTableModel.setData(result); } catch (Exception ex) { JOptionPane.showMessageDialog(frame, "查询失败：" + ex.getMessage()); } } }.execute(); });

SwingWorker的doInBackground在后台线程里执行，完成后 Swing 会自动把done()方法切回 EDT 上执行，所以更新表格是安全的。这套机制不掌握的话，项目演示过程中窗口假死会非常尴尬。

5. 六个翻车点排查：从连接失败到中文乱码，这些坑每个项目都会遇到

5.1 MySQL 连接报错：Public Key Retrieval is not allowed

现象：第一次连接数据库时抛出Public Key Retrieval is not allowed异常，程序无法启动。原因：MySQL 8.0 默认使用caching_sha2_password认证，客户端首次连接需要从服务器取公钥，而 JDBC 驱动默认不允许自动取。解决：在 JDBC URL 末尾追加allowPublicKeyRetrieval=true。这个参数和useSSL=false是 MySQL 8.0 连接最常见的两个配套参数，漏了任何一个都会导致项目直接跑不起来。

5.2 中文乱码：控制台显示正常但 GUI 界面出现问号

现象：数据库 Console 里执行查询，中文显示正常，但 Java 界面里的中文全是????。原因：JDBC 连接的字符集参数没设置，MySQL 连接字符串缺了characterEncoding=utf8。解决：把完整的 JDBC URL 统一为jdbc:mysql://localhost:3306/maternal_db?useSSL=false&serverTimezone=Asia/Shanghai&characterEncoding=utf8。同时确认你的 Java 源文件保存编码为 UTF-8，IDE 的编译编码也设为 UTF-8。这三个地方只要有一个不一致，表现就是界面上乱码。血泪经验：先查数据库连接串，再查源文件编码，最后检查 IDE 控制台编码，按这个顺序排查 90% 的乱码问题都能解决。

5.3 框架版本不一致：Swing 控件显示异常，按钮不响应

现象：在部分高分辨率屏幕上，Swing 界面字体模糊，按钮点击后没反应。原因：Java 9 之后模块化系统导致部分 Swing 应用在高 DPI 下渲染异常。解决：在main()方法开头加一句System.setProperty("sun.java2d.dpiaware", "true")，或者直接换用 Windows 缩放兼容模式运行。这是很典型的环境类故障，代码本身没毛病。

5.4 窗口关闭时数据库连接泄漏

现象：项目跑了一整天后，MySQL 的show processlist里显示大量 Sleep 连接，最后把数据库连接数耗尽。原因：写代码时只关了 ResultSet 和 Statement，没关 Connection；或者用了自定义的close()方法但没正确释放。解决：统一使用 try-with-resources 或finally块里逐个关闭。用 Druid 连接池时，dataSource.getConnection()拿到的连接，调用close()是归还给连接池而不是真正关闭，所以可以大胆关。

5.5 外键关联数据删除失败，主键冲突

现象：删除一个用户时，控制台报Cannot delete or update a parent row。原因：文章表的外键引用着用户表，直接删除用户违反外键约束。解决：有两种策略。其一，删除用户前先删掉他的所有文章和评论，这是应用层处理；其二，在数据库设计时，把外键加上ON DELETE CASCADE，让数据库自动级联删除。课设项目建议用第二种，SQL 里加一行即可，演示时更加省心。

5.6 打包成 JAR 后运行报 ClassNotFoundException

现象：在 IDEA 里点运行一切正常，导出为可执行 JAR 后双击报找不到 JDBC 驱动类。原因：IDEA 默认的打包方式不带第三方依赖 jar 包。解决：用 IDEA 的 Artifacts 配置里选择 "JAR from modules with dependencies"，或者用 Maven 的maven-assembly-plugin打 fat jar。如果是手动管理 jar，则需要把lib目录加进 Class-Path 清单文件。这个坑出现在交付阶段，很多读者项目做得很好，最后卡在打包这一步，非常可惜。

6. 让演示效果翻倍的四个进阶技巧：曲线图、模糊搜索、数据导出与答辩预演

6.1 用 JFreeChart 画孕期体重走势曲线

系统如果只停留在增删改查的层面，功能上是完整的，但视觉冲击力不够。JFreeChart 是一个成熟的 Java 图表库，可以用来画每周体重记录曲线。这个功能的实现极其简单：体重记录表每一条记录对应一个点，createTime作为 x 轴，weight作为 y 轴。答辩时切到这一页，图表曲线比表格数据有说服力得多。JFreeChart 的ChartFrame可以直接嵌进 Swing 窗口，代码量大约 20 行。

6.2 用参数化查询实现标题+内容联合模糊搜索

把搜索框做成一个真正可用的搜索引擎，而不是只按标题过滤。SQL 改成WHERE title LIKE ? OR content LIKE ?，两个参数都传%keyword%。再进一步，可以加最热排序、按分类筛选、发布时间范围筛选。这些功能展示的是你对数据库设计、SQL 编写和界面联动的综合能力，属于答辩高频加分项。

6.3 知识文章内容导出为本地文件或直接打印

把正文显示区的JTextPane内容通过JFileChooser保存为.txt或.html文件，是另一个工程能力和产品化思维的体现。实现方式：调用JTextPane.getText()获取文本内容，再使用JFileChooser.showSaveDialog()选择路径，配合FileWriter写文件，最后弹窗提示导出成功。注意导出路径里不能有非法字符，Windows 上尤需检查文件名中不能包含\ / : * ? " < > |。

6.4 答辩演示前的环境预演清单

演示前花 10 分钟完成以下检查：确认 MySQL 服务已启动；确认数据库maternal_db存在且已导入init.sql数据；确认 IDE 运行配置里的 JDK 版本是 8 而不是 17；最后把窗口尺寸调整到 1366x768 以内，避免在投影时窗口被外扩看不到按钮。

最后分享一个我的个人习惯：每次交付这类系统，我都会建一个docs/README.md，里面写明 JDK 版本、MySQL 版本、数据库密码、启动步骤和常见错误对照表。这个文档不仅能在答辩时放在目录页展示你的工程规范意识，更能让几个月后的自己回头查看时，不用再花一晚上回忆环境是怎么配起来的。我见过太多项目因为换了一台电脑就再也跑不起来，最后归因于"环境问题，无解"。环境从来不是玄学，对着清单一项项核，总能找到那个被忽略的参数。希望帮到你。

本文还有配套的精品资源，点击获取