前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >刚入职新公司,代码看懵逼了咋办?

刚入职新公司,代码看懵逼了咋办?

作者头像
程序员鱼皮
发布2022-04-08 11:12:35
1.6K0
发布2022-04-08 11:12:35
举报
文章被收录于专栏:鱼皮客栈

大家好,我是鱼皮,昨天晚上在我的 知识星球 内开了一场直播,专门给学编程的同学答疑,一场下来竟然回答了 40 多个问题!

其中有个问题是:鱼皮啊,我今天刚刚入职一家公司实习,需要熟悉已有的项目代码。因为是第一次接触已上线的工程代码、且代码量超级大,所以把我看懵逼了。想问下应该怎么快速熟悉代码呢?

这个问题可太真实了,让我瞬间回想起自己进第一家公司实习时的 “恐惧” 。

面对前人堆积的屎山代码、复杂的业务流程图,我当时心里只有一个念头:我要回家!

不过随着自己读过的、写过的代码越来越多,感觉上手新项目也越来越迅速了。下面给大家分享我的一点经验:如果给我一个新项目,我会怎么看?

如何快速上手新项目?

我觉得可以遵循以下几个步骤:

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.xmlbuild.gradle 等。

4. 先把项目跑起来

关于这点没什么好说的,先把代码拉下来、安装依赖、按照文档把项目跑起来,才能更好地了解和调试项目。

比较麻烦的点可能就是环境的搭建,比如本地安装 MySQL、Nginx 代理之类的。不过现在很多公司也会采用开发机、或者远程开发环境的模式,直接连接某个远程库就好了,能省很多事儿,也可以请教一下同事怎么搭建环境比较方便。

5. 阅读代码

终于到了读代码的环节,建议大家遵循两个原则:

  • 由整体到局部:先了解整个项目的目录结构,每个目录都是做什么的,比如在哪里写页面?在哪里改配置?在哪里改接口?怎么切换环境等。 还要了解项目的模块划分,比如哪些代码是用户模块、哪些代码是订单模块,可以通过 JetBrains 等开发工具来自动生成 UML 类图,更清晰地了解。
  • 结合业务:读代码的时候尽量不要裸读、按顺序读,而是可以配合系统去定位代码。比如阅读用户登录功能的后端代码时,可以在前端执行一次登录,然后在浏览器 F12 网络请求中找到登录对应的后端请求,再到代码中全局搜索这个请求即可。阅读用户下订单的代码时,可以先在前端模拟一次下单操作,了解整个过程,从而更好地理解请求之间的顺序和依赖关系。
6. 上手开发

最后也是最关键的一点,读代码不能只读代码,一定要多上手去写、去执行、去调试。

必要时可以专门新建一个分支,在这个分支里无论怎么 “为所欲为” 都不会影响到正常已上线的代码。可以自己复制代码去执行一遍、自己给代码流程加上一些日志来帮助理解数据流转过程、或者 Debug 调试等。

其实刚进一家新公司时通常不会给你安排太复杂的工作,基本就是增删改查、或者给你一个小页面小功能去做,帮助你熟悉代码。有些时候,哪怕你不理解整个项目的架构,通过复制同事已经写过的代码也能完成工作。不过还是建议大家,为了长远的发展,不要只局限于自己负责的小功能,可以多了解系统的上下游和整体架构,提高自己的全局观。

本文参与 腾讯云自媒体同步曝光计划,分享自微信公众号。
原始发表:2022-02-22,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 程序员鱼皮 微信公众号,前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体同步曝光计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 如何快速上手新项目?
    • 1. 获取项目相关信息
      • 2. 了解业务流程
        • 3. 阅读项目文档
          • 4. 先把项目跑起来
            • 5. 阅读代码
              • 6. 上手开发
              相关产品与服务
              云数据库 MySQL
              腾讯云数据库 MySQL(TencentDB for MySQL)为用户提供安全可靠,性能卓越、易于维护的企业级云数据库服务。其具备6大企业级特性,包括企业级定制内核、企业级高可用、企业级高可靠、企业级安全、企业级扩展以及企业级智能运维。通过使用腾讯云数据库 MySQL,可实现分钟级别的数据库部署、弹性扩展以及全自动化的运维管理,不仅经济实惠,而且稳定可靠,易于运维。
              领券
              问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档