要说这“sup gap”的问题，我好早之前就碰到了，只不过那时候没当回事儿，觉得小打小闹，随便应付一下就过去了。结果嘞，越往后搞，这坑就越大，搞得我项目几次差点儿搁浅。今天就跟大家唠唠，我是怎么一点点把这几个“坑”给填平的。
刚开始的时候，我是真没经验。领导随手甩过来一个活儿，说要搞个啥啥小系统，看着不难，就那么几个页面，几个功能。我当时想，这不就是平时做的那些吗？手到擒来！于是我吭哧吭哧就开始写代码，界面很快就出来了，基础逻辑也跑通了。结果往后一联调，问题就来了。好些个地方，总感觉缺点跑着跑着就报错，要么就是数据对不上。我当时就懵了，明明看着没毛病？
第一次填坑：瞎猫碰上死耗子
我那会儿经验不足，遇到问题不是先琢磨原理，而是直接上手改。哪里报错改哪里，哪里数据不对就加个判断。那段时间，我的代码里全是if else，简直就是灾难。有时候碰巧了，一顿乱改还真能把问题压下去。但第二天，新的问题又冒出来了。我感觉自己就像是个灭火队员，东边着火西边跑，永远也解决不完。那时候，我就隐约觉得，这根本就是治标不治本，肯定有什么“基础”的东西我没搞明白。
后来有个老同事看我愁眉苦脸的，就过来问了两句。我把代码给他一看，他直接就乐了，指着我的屏幕说：“你这根本就没有统一的规范，数据字段对不上，接口调用方式也乱七八糟的，这不就是典型的‘sup gap’嘛缺了好多关键的辅助支撑。”他简单跟我点了几句，说我得先把项目的整体结构理清楚，把数据流向、接口定义这些玩意儿都统一起来，不能想到哪儿是哪儿。
第二次填坑：规范先行，统一标准
听了老同事的话，我像抓住了救命稻草，赶紧把手头的活儿停下来，开始反思。我翻了很多我们自己团队以前的项目文档，也找了一些行业里关于项目管理的资料。我发现，确实很多项目在开始前都会有非常详细的规划，包括：
小编温馨提醒：本站只提供游戏介绍，下载游戏请前往89游戏主站，89游戏提供真人恋爱/绅士游戏/3A单机游戏大全，点我立即前往》》》绅士游戏下载专区
- 数据字典的定义： 每一个字段代表类型是范围是都要写得明明白白。
- 接口文档的统一： 哪个接口干啥的，入参是出参是都要有固定格式。
- 错误码的设计： 各种可能出现的错误，都要有对应的错误码和提示信息，方便定位。
- 权限体系的规划： 谁能干谁不能干一开始就要想
我就按照这个思路，硬着头皮开始干。我先是把我们项目里所有用到的数据字段都拉出来，一个一个对着需求文档和原型图，跟产品和前端一起确认。确认完了，我用个简单的表格把它都记录下来，这就是我们的“数据字典”。然后，我又把所有接口都列出来，跟后端同学沟通，把入参出参都定死，形成了一个“接口规范文档”。
这过程可真不容易，前后拉扯了得有两三周。尤其是前期，大家都不习惯，改来改去的，烦得很。但是我坚持下来了。虽然前期花了不少时间，可等我们真正开始写代码的时候，效率一下子就上来了。以前因为字段不匹配、接口传参错误导致的各种问题，基本就没有了。大家只需要对着文档去写代码就行，沟通成本也大大降低了。
第三次填坑：自动化工具的引入
光有文档还不够，因为人总会犯错，总会有疏漏。我发现，虽然我们有了规范，但有时候新的同事来了，或者时间一长，大家还是会不自觉地“跑偏”。我就琢磨着，有没有什么办法能让这些规范“硬”起来，让大家不得不遵守？
我开始研究一些自动化工具。我尝试用一些代码审查工具，把一些常见的命名规范、代码风格问题给跑出来。这个效果不错，能提醒大家注意自己的代码质量。后来我又想到了，既然我们有接口文档，那能不能根据文档自动生成一些代码骨架，或者自动校验接口的入参出参？
我找了一个开源的API管理工具，稍微研究了下它的原理。然后，我周末花了点时间，写了点脚本，让我们团队可以在编写接口文档的时候，就能自动生成一部分接口的调用代码，包括参数校验的逻辑。这样一来，前端和后端在对接的时候，直接用这些生成的代码，就避免了很多人为的失误。而且每次接口有变动，只要更新文档，重新跑一下脚本，相关的代码也会自动更新，省去了大量手工修改的麻烦。
从根子上解决问题
这么一通折腾下来，我发现解决“sup gap”的关键，就是把项目开发中那些“辅助性”但又“关键性”的工作，从一开始就提上日程，并且通过“规范化”和“自动化”的手段，把它们固定下来。你不能等问题出现再去弥补，而应该在问题出现之前就把“坑”给填
现在我们团队搞新项目，第一步就是拉着大家一起定规范，写文档。数据字典、接口规范、错误码设计，这些在项目还没动工前，就得先有个清晰的框架。然后配合我们自己搞的一些小工具，基本能保证在开发过程中，大家都在一个频道上，效率也高了很多。
虽然每次搞这些前期工作，都会觉得有点烦，想赶紧上手写代码。但我现在明白，磨刀不误砍柴工，把这些“sup gap”都填好了，后面的路才能走得顺畅。希望我的这些小经验，也能帮到正在受“sup gap”困扰的朋友们！
