面试要GitHub链接？教你展示GitHub项目的实用建议

编译：伯乐在线/小米云豆粥

如有好文章

你所面试的公司向你索要 GitHub 链接，猎头也找你要 GitHub 链接。“你是否参与过开源项目？”是当下 IT 技术面试中较为常见的问题之一。

他们要 GitHub，那你就得给。本文会阐述在面试中怎样展示你在 GitHub 上的项目。

- 招聘者（身为程序员）可以学习能够从哪些关键要点来评价一个程序员的水平以及软件的质量。

链接一个特定的项目

在你的简历和每一份申请里面都放上你的GitHub链接。

该链接需直连至一个项目。不要给你 GitHub 的主页地址，因其页面无有用信息，难以让人继续浏览。

你必须只展示一个项目。一个就够了，不需要更多。

这个项目会是你的“登录页面”，也是招聘者最先看到的页面。他们通常不会去查看其他页面（其实也没有这个必要）。因此，这个页面本身就应当展示所有的信息。倘若他们查看了其他页面，那就意味着这个主页成功地引发了他们的兴趣，他们希望了解更多关于项目的细节。

我们要写一个项目页面，这个页面能够充分展示你的能力，同时也能给人留下好的第一印象。

项目结构

用5秒时间看软件的架构就可以知道项目优劣。

你能一眼看出一个程序员没有经验。他们的项目通常没有结构。项目文件不是在随便一个地方，就是都在根目录。

一个好的项目结构需要把可执行文件放置在一个文件夹中。

命名的细节，比如使用‘doc’还是‘docs’，这并不重要。以下是 GitHub 项目的文件夹结构：

一个项目有一个组织良好的项目简介文件。

项目简介文件可以提供：

在简介文件里面放软件界面截屏

一张图比一千个字更能说明问题。

人们不会因为要看软件界面就去安装软件。请提供软件界面截图。

在简介中放视频

一张图能抵一千个字，那么一个视频顶一千张图。

在 GitHub 上有一个随机蛇类项目，它有很棒的演示。

注意：GitHub不允许插入视频，你可以使用动态图。

网页链接或安装文件链接

如果该项目属于网络应用，那就请提供网页的地址。并且，所有人都应当可以对该地址进行访问。

如果该项目为单机程序，那就提供安装文件的下载地址。倘若安装文件看起来不专业，用户便不会去安装它。很多时候，专业与否与发布方式存在关联。

整合GitHub工具

GitHub 提供了用于编连的工具，还提供了用于打包的工具，也提供了用于测试的工具以及其他功能的工具。这些工具在专业软件开发中是必不可少的。

以前实现这些功能是很困难的。然而现在，借助 GitHub 一切都变得简单了。你没有不使用它们的理由。

这是一个由C++实现的四子棋的例子。按钮从左到右代表：

在Linux上编连（Travis CI）

在Windows上编连（AppVeyor）

单元测试和测试覆盖分析（Coveralls）

如何处理源代码？

得知没人在乎我的源代码这个事实时，我很吃惊。我在整理代码上花费了不少时间，然而却发现没人在意。重要的并非是代码，而是产品。

猜的话，读一段软件功能描述的速度会比猜慢 10 倍。自己弄明白软件用法时，观看一个介绍基本用法的视频会比自己弄明白快 100 倍。进行逆向工程时，读设计图表会比逆向工程快 1000 倍。可以通过读源代码来搞清楚一切，不过这个过程比较费事。读源代码（解码源代码）是很耗时的。只有在没有其他办法的时候才应该使用。

经验教训1：没人在乎你的代码，也不会有人去读你的代码。

经验教训 2：不要寄希望于他人会去阅读你的代码，同时也不要强制他人去阅读代码。

如果我没有像样的大项目要怎么办？

挺好的。简单的项目具有容易展示的特点，也容易进行解释，并且面试官更容易理解。例如，大家都知晓四子棋的具体情况。

每一个项目第一眼看上去虽简单，但包含诸多工作量。需写好的用户界面，要调整颜色，能允许两人一起游戏，要加上对下一步棋走子的建议，还要加上 AI 选手等。

这个游戏的规则较为简单。然而，要将其制作成优秀的软件，需要做大量的工作。这些方面都是在面对面的面试中，你能够与面试官进行深入探讨的内容。

你知道玩四子棋时先走的选手在不犯错的情况下一定会赢吗？你知道若第一个选手第一步棋不走中间，那么第二个选手一定能够将棋走成平局吗？

来源：一种基于知识的四子棋方法，该游戏已被解决：白方获胜，维克多·阿利斯

面试官真的会去看GitHub么？

事实上他们不会。

GitHub Traffic Statistics

我们进行了测试。这个图是在我们发出一堆简历之后所做的数据统计。这三个点击是我亲自点的。在撰写这篇文章时，我未登录就去点击了 GitHub，这是我的过错。

从我上次找工作的经历来看，经历了十几个电话面试，每次电话面试都有一个技术人员参与，还经历了几个现场面试，现场面试有 4 到 7 个技术人员，在这些面试过程中，只有一个人查看了我的 GitHub 页面。

结论：没有人与 GitHub 相关，没有人会去关注 GitHub。每个人都会提出疑问，这是因为其他人也在进行同样的行为。

好处在于，既然没人真的会去看，那么你就能够拒绝参加这场 GitHub 的假面舞会。你可以借助这个 hello world 终极版本库来回应所有的 GitHub 要求。并且，这个版本库中包含了用一百种语言所实现的“Hello world”。

小抄

项目要有结构

要有项目简介文件

写一段说明软件功能的介绍

放上软件界面截图和使用说明视频

提供安装文件下载地址或者网络应用的网址

整合发开工具（CI，单元测试，打包工具等等）

这世上还有其他软件工程的好范例，不仅仅局限于GitHub。