GitHub参与开源项目图文教程

时间:2022-04-07 08:53:41

1. 在GitHub上找到自己想要参与的开源项目,然后Fork一份到自己的仓库,这里我们以目前相当火的开源项目LEP为例,先简单介绍一下LEP: LEP 的全称是 Linux Easy Profiling(Linux 易用剖析器),核心特点在于 Easy(简单),主要功能在乎 Profiling(剖析)。LEP 的网址是 http://www.linuxep.com,网站基于 Docker 部署,代码仓库位于:https://github.com/linuxep,LEP 的设计目标是:便利 Linux 的程序员,以最快最直接的方式,定位到系统里面一些 bug的源头,以及一些性能瓶颈的原因。Linux 有很多现成的调试和剖析工具,比如 top、vmstat、iotop、perf、valgrind、powertop、free 、 pmap 、 slabtop 等,这 些 工 具 通 过 读 取 /proc 、 /sys,分 析 硬 件 的 PMU(Performance Monitor Unit)数据、监控内存的申请释放以及读写等手段,获知单一进程或者系统的运行状态,以及进行故障分析。 LEP 除了在功能上是这些工具的超集以外,在可视、交互、深度分析、数据比对、场景贴合等角度对这些工具进行进一步的增强。

GitHub参与开源项目图文教程

点击Fork之后,该项目就会出现在你自己的仓库中,如下图所示:

GitHub参与开源项目图文教程

2. 参与开源项目前,我们先正常运行一下这个项目,首先,我们把Fork过来的lepd和lepv克隆到自己本地,然后安装好所需依赖,lepd参考https://github.com/linuxep/lepd/blob/master/README.md编译运行,lepv参考https://github.com/linuxep/lepv/blob/master/README.md运行,如下图所示(环境已经配置好,所以直接编译运行):

lepd:
GitHub参与开源项目图文教程
GitHub参与开源项目图文教程

lepv:
GitHub参与开源项目图文教程
GitHub参与开源项目图文教程

浏览器访问 localhost:8889,如下图所示:

GitHub参与开源项目图文教程

3. 为开源项目贡献代码:

(1) 先来看一下远程分支情况:

GitHub参与开源项目图文教程

(2) 切换到new-ui-with-socket-io 分支:

GitHub参与开源项目图文教程

(2) 编辑文件(要和远程仓库的分支状态保持一致),在README.md文件的第三行插入一句话,提交修改并推到远程仓库,这里描述要明确,不要太随意(我这里测试就随意先描述一下):

GitHub参与开源项目图文教程

(3) Create pull request:

GitHub参与开源项目图文教程

GitHub参与开源项目图文教程

GitHub参与开源项目图文教程

描述示例:
GitHub参与开源项目图文教程

点击Create pull request按钮后,就成功提交了请求。

附Git教程链接: 易百Git教程
       廖雪峰的Git教程