如何接手一个新项目

项目好与不好，它就在那里；架构优雅或者丑陋，它就在那里；注释有或者没有，它还在那里；文档乱或者不乱，它始终都在那里。不论它是什么样子的，线上就那样跑着。

一般来讲，项目分为两种：

1、为业务服务的项目，比如公司内部项目、电商项目、各种 app 项目；

2、为技术服务的项目，比如开源中间件项目（dubbo、spring cloud、各种数据库中间件、各种缓存方案等）；

首先说第二种项目，它专注于提供某一个或几个特定的功能。相对来说，这种项目技术实现上可能需要对这一领域有比较深的要求，但职责单一，目标明确。而且这种项目都是面向开发人员的，所以设计文档、接口文档、使用文档都会比较齐全。而且这种项目一般都会承担比较核心、比较重要的功能，并且还会在公司内部开放，甚至直接开源到社区。所以要经得起考验，代码都会写的比较规整。

开放出去，如果架构和代码不规整，就不会有人在 github 上 star，也不会有多少人使用。没人用事小，被人骂事大，让团队和公司丢脸更了不得了。所以这种项目比较容易接手，因为在文档和代码都比较规整的情况下，只需要在技术上下功夫就可以了。

本来项目应该有齐备的文档的，而现实中的好多项目往往不是这样的。由于各种各样的原因，比如框架比较老，人员变动，业务变动等，可能造成项目结构变的比较混乱。那么当我们应该如何快速的接手这样一个项目呢。

1、首先需要了解项目的的表现形式，什么是表现形式呢，就是说这个项目是提供 web 端服务，还是提供 App 端服务，还是其他形式的服务，又或者是混合了多种形式。我们比较容易理解具体的东西，而对于抽象的事物理解起来有一定的难度。所以看到项目最终的表现形式，可以对应到我们的项目结构中，这样一来，对于理解项目就比较容易了。

2、了解项目的部署架构。部署架构包括从客户端一直到数据访问层。这其中包括服务器系统版本，后端服务器软件类型（tomcat 、jetty 等），负载均衡配置，配置了多少台，用的是 nginx 还是 HA ,有或者是其他的。前后端交互方式，缓存是用到什么方案，是 redis 还是其他的，单机主备还是集群方案。数据库用的什么，有没有集群，有没有异地。数据库中间件用的什么框架等等。这个时候，最好有部署架构图拿来看一眼，如果是比较复杂的项目，肯定开发和运维会有部署文档的。如果没有完备的文档，建议要了解清楚之后，自己手动画一下部署架构图。

3、了解项目的代码架构。其中包括项目使用的基础框架，比如是 Spring mvc ，还是 Spring boot ，又或者是其他的框架，有没有用到 Netty 等其他的比较大的框架。有没有用到分布式 SOA 或者是否使用了微服务。用到分布式方案是 dubbo 还是 spring boot ，其中重点关注这些框架所用的版本，有些框架的版本可能比较老旧。

4、了解项目功能模块。到这里就和业务有关了，功能模块的划分一般和业务有关，比如注册登录模块、用户管理模块、订单管理模块、财务相关的服务模块等等。以及模块之间的依赖关系，是不是存在项目引用，是不是存在 RPC 调用或 http 服务调用关系等。这个时候，最好有完整的模块或服务依赖结构图，如果没有，最好在了解了项目结构之后，自己手动画一张。

5、最后，就是要理解具体的业务了，然后根据业务查看、调式对应的代码以及数据结构。

总体上要遵循从整体到细节，从高纬到低维的一个过程。如果能做好以下几点就最好了：

1、如果项目不是很复杂，最好可以有测试环境或者本地环境搭建起完整的项目架构。

2、如果项目很复杂，至少要保证自己负责的部分可以通过一些方法能在本地搭起来。

3、如果要在项目上做功能扩展，要遵循团队或项目的规范，不要独树一帜，这样会给后期维护带来麻烦。

4、修改功能之后，要维护好对应的文档。

想到哪儿写到哪儿，好多东西没写到位。