开发软件时功能点太多时应该怎么设计软件架构

来自夹夹 QQ 群讨论,审核后公开 · 。查看原始讨论

提问

开发软件时功能点太多时应该怎么设计软件架构

回答

这问题问得有点宽,先帮你把它收窄成一个能回答的问题:功能点多不等于架构复杂,真正决定架构形态的是「这些功能之间有没有共享的状态和变化的耦合」。所以我先讲怎么判断该拆还是该合,再讲具体结构。

功能点一多,大多数人第一反应是分层、抽接口、上插件化。这个反射基本错。分层解决的是依赖方向问题,插件化解决的是扩展点问题,它们都不是「功能多」的解药。真正会把你拖垮的是三种情况:一是同一份数据被五六个功能各自改,谁改的、改完还会怎样没人说得清;二是功能之间的调用关系长成交互网状,改一个功能要连带改四五个;三是每个功能都往主流程里塞一段 if,主流程越滚越长,最后没人敢动。

所以第一步不是设计,是盘。把你现在的功能点按「读写哪些数据」列一张表,同一行同一列上交叉特别密的那几坨,就是应该收成一个模块、内部自己管状态、对外只暴露少量操作的地方。这一步做完,架构的形状基本出来了,剩下的是把边界画在你算出来的边界上,不是画在你想象中的图上。

然后说几种有效做法,按收益从高到低排。

第一种,也是最重要的一种:把状态的所有权明确下来。每个数据只有一处可写的入口,其他地方只能读或者发命令。这一条能干掉你 80% 的混乱。具体到代码里就是一个 module 内部持有 state,外部通过方法改,绝不允许两个模块直接写同一份数据。做到这个,功能再怎么加,你至少知道问题会出在哪个文件里。

第二种,主流程保持薄,功能挂到扩展点上。但要区分两种挂法:一种是有严格顺序、有共享上下文的核心流程,这种别硬做成插件,做成显式的 pipeline 阶段,每个阶段签名固定、输入输出可测;另一种是旁路能力——通知、审计、埋点、权限校验,这些才适合用 hook/事件机制挂上去,因为它们不该影响主流程的结果。把核心流程做成插件是个很常见的坑,最后调试时你根本不知道哪个插件改了返回值。

第三种,模块之间只传数据不传对象。跨模块的接口用明确定义的结构体或 DTO,不要在 A 模块内部持有一个 B 模块的实体引用然后到处 set。这条听起来像教科书,但它决定了你后面能不能把这些功能拆到不同进程、不同人手里,甚至拆给 agent 去并行改。

第四种,配置和代码分开。功能开关、阈值、策略这类东西抽出来,不然每加一个客户定制你就得复制一遍逻辑。但别过度,配置项超过两三百个之后它本身就是一份没人看得懂的代码。

然后是有意识不做的三件事。一是不为了「未来可能的需求」预留抽象层,你现在不知道未来那层抽象该长什么样,预留在九成情况是错的,而且挡路。二是不给每个功能都写接口,只有一个实现的接口是纯成本。三是不追求功能模块对称——真实系统里各模块规模差十倍很正常,硬要对称会造出一堆空壳。

如果你想要个具体的结构参考,我的建议通常是三到四层:接入层(协议、路由、鉴权,不管业务)、领域层(按上面盘出来的模块划分,各自持有自己的状态、自己负责自己的不变式)、外围能力层(模型调用、存储、外部 API 的封装,用端口/适配器的形式,方便换),加一个贯穿的横切层管日志、追踪、错误。就这么点东西,别再往上叠了。

最后一句跟你手头做的事相关:你现在功能越来越多,如果是给 agent 改的代码库,那架构设计的第一目标是「可验证」而不是「优雅」。每个模块边界清楚、能单独跑测试、改完能立刻用确定性的东西(单测、类型检查、lint)判对错,比任何分层理论都值钱。agent 在结构混乱的仓库里会互相踩,在边界清楚的仓库里才敢让它并行改。

你手头具体是哪类软件、大概多少个功能点,说一下我能给你落到更具体的划分上。