有童鞋在问:刚刚入职一家公司,需要熟悉已有的项目代码,而且是已上线的工程代码,且代码量超级大,这种情况应该怎么快速熟悉代码呢?
这个问题可太真实了,让我瞬间回想起自己进第一家公司实习时的 “恐惧” 。
面对前人堆积的屎山代码和复杂的业务流程图,我当时心里只有一个念头:我要回家!
不过随着自己读过的、写过的代码越来越多,感觉上手新项目也越来越迅速了。
今天给大家分享我的一点经验:如果给我一个新项目,我会怎么看?
我觉得可以遵循以下几个步骤:
1. 获取项目相关信息
进入一家新公司后,如果遇到不负责任的同事呢,可能直接甩给你项目地址,然后就让你自己研究了。这就好比产品经理直接甩给你一个需求让你直接上线一样,怎么实现我不管。
这种情况下,我们首先要做的事情是尽可能多地获取项目相关信息,来帮助自己了解项目。比如项目介绍文档、项目功能说明文档、业务流程图、项目历史迭代情况、项目架构文档、技术选型背景等等。
像我的话,就会询问同事:这个项目背景是什么呀?这个项目有没有啥文档呀?之类的。
不过有些公司或项目可能过于敏捷,平时光做需求,不写文档,逻辑全靠口口相传!
也没关系,请同事给你介绍一下项目的业务和技术信息就好。
刚进公司有问题一定不能憋着,要多问,让自己尽可能多地了解项目代码之外的东西。
2. 了解业务流程
技术是为业务服务的,千万不要连自己项目是干嘛的、有什么功能、为什么要做这个功能都不知道,就去看代码、想着快速把需求完成。最好不要把自己当成临时工,而是要当成项目的负责人 。
我的话一般会先阅读文档或者请同事来给我介绍项目的背景 ,即为什么要做这个东西;然后对着产品本身(可能是网页或者 APP)来体验项目的功能;最后再重点关注自己要做的业务、负责的功能模块,了解它的历史、业务逻辑等。
整体的思想就是从整体到局部,由大到小吧。
这里为什么我反复强调要了解项目的背景呢?聪明的朋友一定能想到。因为你刚进一家新公司或者接触一个新项目,如果自己啥都不懂,别人说啥你就做啥,就很有可能出现这个项目 / 功能本身根本没有任何意义、你只是帮忙收拾了个烂摊子的情况。。。
3. 阅读项目文档
阅读公司的项目过程,其实和阅读开源项目是一样的,基本上项目的代码仓库都会有一个 README.md
文件。
这个文件往往会介绍项目的背景、功能、技术栈、如何启动、如何贡献代码等等。
我会先整体扫一遍文档的目录 ,然后优先关注项目的技术栈以及如何启动。
一般 GitHub 等项目平台都会帮你生成文档目录,可以很快地跳转。也可以把文档下载到本地,用 Typora 之类的 Markdown 编辑器打开,从而清晰地看到文档的目录。
因为如果你了解了项目用到的技术,而你正好会用这个技术的话,心里就多了几分底气,项目的架构也能大致了解了,后面再去看代码就轻松得一批。
举个例子,看到技术栈中出现了 Ant Design Pro,我正好用过!我就知道这个项目大概率使用了 React、Ant Design、Webpack、Dva、Umi 等技术了,它的代码结构如何、配置文件在哪里、页面文件在哪里、如何启动也差不多能 get 到。
Ant Design Pro
像我平时在 GitHub 上找开源项目时,除了功能外,就是关注技术栈,如果项目文档中提到的技术我都会用,那么我就很有自信这个项目我肯定能学得动、学得懂。
所以这也是为什么要多了解和积累一些技术。
补充一下,如果作者没在文档中写明技术栈怎么办?这里有个小技巧,去看项目的依赖管理文件,比如前端的 package.json
、Java 的 pom.xml
或 build.gradle
等。
4. 先把项目跑起来
关于这点没什么好说的,先把代码拉下来、安装依赖、按照文档把项目跑起来,才能更好地了解和调试项目。
比较麻烦的点可能就是环境的搭建,比如本地安装 MySQL、Nginx 代理之类的。不过现在很多公司也会采用开发机、或者远程开发环境的模式,直接连接某个远程库就好了,能省很多事儿,也可以请教一下同事怎么搭建环境比较方便。
5. 阅读代码
终于到了读代码的环节,建议大家遵循两个原则:
由整体到局部:先了解整个项目的目录结构,每个目录都是做什么的,比如在哪里写页面?在哪里改配置?在哪里改接口?怎么切换环境等。还要了解项目的模块划分,比如哪些代码是用户模块、哪些代码是订单模块,可以通过 JetBrains 等开发工具来自动生成 UML 类图,更清晰地了解。
结合业务:读代码的时候尽量不要裸读、按顺序读,而是可以配合系统去定位代码。比如阅读用户登录功能的后端代码时,可以在前端执行一次登录,然后在浏览器 F12 网络请求中找到登录对应的后端请求,再到代码中全局搜索这个请求即可。阅读用户下订单的代码时,可以先在前端模拟一次下单操作,了解整个过程,从而更好地理解请求之间的顺序和依赖关系。
6. 上手开发
最后也是最关键的一点,读代码不能只读代码,一定要多上手去写、去执行、去调试。
必要时可以专门新建一个分支,在这个分支里无论怎么 “为所欲为” 都不会影响到正常已上线的代码。可以自己复制代码去执行一遍、自己给代码流程加上一些日志来帮助理解数据流转过程、或者 Debug 调试等。
其实刚进一家新公司时通常不会给你安排太复杂的工作,基本就是增删改查、或者给你一个小页面小功能去做,帮助你熟悉代码。有些时候,哪怕你不理解整个项目的架构,通过复制同事已经写过的代码也能完成工作。不过还是建议大家,为了长远的发展,不要只局限于自己负责的小功能,可以多了解系统的上下游和整体架构,提高自己的全局观。
- END -