📅 发布时间：2026/6/19 23:41:32

软件工程实践课程总结

一、学期回顾

1.1 回顾我对于软件工程课程的想象

学期初，我对“软件工程”的理解更多停留在“按部就班写代码”的层面：即“需求明确→分工开发→交付验收”的线性流程。然而，经过一学期的实践，我才深刻意识到课程的核心更在于“工程协作”与“可交付能力”。接口联调、测试保障、文档同步、版本管理——这些非编码工作不仅工作量不亚于功能开发，更是决定项目能否真正跑通的关键。

本学期我的核心收获主要集中在两点：一是思维上从“完成功能逻辑”升级为“保障功能稳定可用”；二是对前后端协作与“接口契约”有了更直观的实战认知（特别是在 AI 聊天模块对接本地 Dify 接口及页面联调的过程中）。

同时，不足之处也十分明确：前期对时间成本与技术风险的评估过于乐观，导致项目后期主要精力被迫集中在“赶集成”和“赶测试”上。这也是我未来希望重点改进的方向——即提前夯实可测试、可回滚、可复现等工程基础，以降低后期的维护成本。

1.2 回顾我在这门课程中的投入与产出

代码量大约1400行

（1）我在团队项目中的角色与职责

在第二次作业/冲刺阶段，我主要担任前端 AI 聊天模块开发与图表展示的角色。具体职责包括：构建聊天对话框 UI、实现消息收发的动态显示、配置 AI 开场白、对接本地 Dify 接口，以及对页面样式与相关展示功能进行优化。

（2）时间投入

作业/阶段	主要内容	花费时间 (h)
第一次团队作业	智能体任务清单 + 测试/接口传参改造	6
第二次团队作业	CRUD+List 测试脚本编写、图表与文档配合	10
第一次团队项目作业	前端页面搭建 / 联调环境熟悉	12
第二次团队项目作业	AI 聊天模块开发 + 接口深度对接	16
第三次团队项目作业	样式优化 / 边界问题处理 / 集成配合	18
第四次团队项目作业	收尾、回归测试、汇报材料准备	14

累计时间：76h（按 15 周估算，周均投入约 5h，实际随冲刺阶段波动较大）。

1.3 印象最深刻的一次作业/答辩

我印象最深的是AI 聊天模块从页面搭建到接口联调跑通的阶段。

看似简单的前端展示，要真正做到稳定，必须处理大量细节（如消息气泡自适应、Loading 状态管理、异常反馈、历史记录回显、接口返回结构变更的兼容等）。当功能最终顺利跑通时，我对“前后端协作”的理解从抽象的概念真正转化为了具体的工程经验。

二、总结收获

2.1 我的软工实践故事

从“写功能”到“保交付”：
在第一次团队作业中，我致力于“让代码能被稳定调用与验证”。通过将调用方式统一为传参形式并补全测试用例，虽然这些工作在表面上不显眼，但显著降低了后续的集成与联调成本。
从“能用”到“好用”：
在开发 AI 聊天模块时，我不止步于 UI 搭建，更专注于“用户体验细节”的打磨（如消息展示的流畅度、样式一致性、接口调用失败的反馈机制等）。这一过程让我意识到：可用性只是底线，体验细节决定了最终的完成度。
测试价值的“具象化”：
在第二次小组作业中，针对 CRUD+List 的测试经历让我体会到：测试不是为了“最后找茬”，而是让代码修改更有底气——尤其是当多人协作频繁调整数据结构或接口行为时，自动化测试是保障系统不崩塌的安全网。

2.2 学到的新技术/生产力工具

Git/GitHub 协作流：掌握了利用分支（Branch）与提交（Commit）串联多人协作的规范，有效减少了代码冲突与“互相覆盖”的风险。
前端原生三件套（HTML/CSS/JS）工程化：学会了用更符合工程规范的方式编写交互逻辑与样式，告别了临时堆砌页面的做法。
接口联调能力：建立了围绕“请求参数、响应结构、错误处理”编写前端逻辑的思维模式（特别是在 AI 聊天模块对接本地 Dify 接口时收获巨大）。
测试脚本化：能够将 CRUD 与列表查询封装为可重复运行的脚本，将一次性的测试行为转化为可持续复用的“测试资产”。

2.3 技术之外的提升

沟通效率：学会了更精确地描述问题（提供复现步骤、明确输入输出、对比预期与实际），减少了“你那边不行”这类模糊的无效拉扯。
风险与时间意识：建立了对任务复杂度的敏感度，能够识别那些“看起来小但容易爆炸”的风险点（如联调、浏览器兼容、回归测试）。
文档意识：不再只是记录“做了什么”，而是更注重记录“怎么跑、怎么测、哪里容易出错”，提高了文档的可维护性。

2.4 想记录的一句话（给未来的学弟学妹）

别怕做“测试/联调/收尾”这种看似不显眼的活：它们往往决定了一个项目最终是仅仅“能演示”，还是真正“能交付”。

三、致谢

感谢老师为我们设置了多样的课程任务，让我完整体验了软件工程从需求分析、系统设计到实际运行与维护测试的流程；也感谢组员和我自己能坚持走完全过程，在实践中不断成长。

软工学期回顾