微人事 star 数超 10k，如何打造一个 star 数超 10k 的开源项目

看了下，微人事(https://github.com/lenve/vhr)... star 数超 10k 啦，松哥第一个 star 数过万的开源项目就这样诞生了。

两年前差很少就是如今这个时候，松哥所在的公司业绩下滑严重，关门倒闭已成定局，不少同事在谋划的新的出路，松哥则被公司留下来善后，在一段并不太忙碌的日子里，作了两个 Spring Boot + Vue 的先后端分离开源项目，以期能给本身来年找工做增长一点筹码，没想到这两个项目后来受到不少关注，也帮助了不少人。有很多小伙伴在公司使用微人事项目作脚手架开发项目，也有国内 top20 的高校研究生借鉴微人事作毕设，我本身也所以收到一些大厂的橄榄枝，能够说仍是收获满满。

关于这个项目诞生的故事，松哥以前写过一篇文章，感兴趣的小伙伴能够看看：

• 公司倒闭 1 年了，而我当年的项目上了 GitHub 热榜

今天，我想和小伙伴们聊聊如何从零开始打造一个 star 数过万的开源项目。松哥把这些经验总结为三点：

• 文档详细
• 项目有料
• 适当宣传

这些经验不是什么惊世骇俗的大道理，都很普通，关键在于执行。

1. 文档详细

其实在作微人事和 V 部落以前，松哥在 GitHub 上已经作过多个开源项目了，比较有意思的一个是一个 Android 上的自定义控件，我作了一个歌词展现的控件，这个控件引入到本身的项目中之后，能够根据当前歌曲的播放进度动态滚动歌词，效果如以下：

还有一个比较好玩的就是 Android 上自动抢红包的 App。不过这些开源工具和项目最终都石沉大海了。

究其缘由，我以为是本身对待这些项目不够认真，项目开源以后基本上都没有再继续维护了，一个项目提交次数通常都是个位数，项目作完以后，写一篇博客介绍下就算完事了。一个本身都不怎么重视的项目，其实很难引发别人的重视。

因此在 V 部落和微人事中，我就吸收教训，尽可能把项目的文档写的详细一些，让不懂先后端分离开发的小伙伴看到我写的开发文档后，就可以快速理清项目的思路。就这样，我每写一个功能点，就写一篇技术文档，微人事项目前先后后一共写了 30 多篇文档：

同时我考虑到不少小伙伴第一次接触到这个项目，一个庞然大物很差处理，所以我在每一次项目提交以前，都会对项目打一个 tag，这样你们经过 git clone 命令获取到项目以后，就能够经过 tag 很是方便的定位到项目的任意时刻，例如只想看登陆设计的，能够根据文档介绍回到 v20180107 这个版本：

小伙伴也能够点击 GitHub 上的 release 下载不一样时期的项目。我一开始担忧有的小伙伴不熟悉 Git 上的 tag 操做，还针对此写了个教程，就是上面文档的第 17 篇。

能够说，这个项目我从头至尾考虑了不少小伙伴们可能遇到的问题，不是自嗨，确实是但愿可以带着小伙伴们一块儿飞。

这么详细的文档固然也获得了小伙伴和一些平台的承认，项目刚刚发布的时候，也就是 2018 年年初的时候，慕课网在它的官方知乎帐号、微博帐号上都有推过个人介绍项目的文章，当时这个项目就受到了不少小伙伴的关注，收获了很多 star，小伙伴们的关注也鼓励我继续把这个项目向前推动。

这是我介绍的第一点经验，文档详细。

2. 项目有料

项目有料，也就是这个项目对你们而言是有价值的，可以真正帮到你们。

不少小伙伴看到微人事会以为奇怪，这个项目还有一些功能没有实现，怎么就有这么多人关注呢？其实缘由很简单，这个项目的价值不在于它的业务，而在于它解决了不少小伙伴在先后端分离开发中遇到的问题，这也是我作这个项目的初衷之一。

做为一个 Java 攻城狮，我很是明白不少小伙伴去接触 Vue、接触 Nodejs、接触 SPA 以及接触前端工程化这些概念时所面临的困惑，由于这些困惑我也曾经遇到过。

例如先后端分离后，开发环境下先后端如何进行数据交互、权限管理怎么作、文件上传怎么作、项目怎么部署等等，事无巨细，我以为小伙伴们可能会困惑的地方，我在微人事中直接用代码作出样例，而后再辅以详细的文字解释，这样对于大部分小伙伴而言，都可以快速理解这个项目了。

这个项目创建之初，一开始就定位是一个学习项目，目的就是帮助你们创建先后端分离开发知识体系，搞定先后端分离开发中常见的坑，所以，一旦将项目的框架搭建成功，你们理解了先后端分离架构中的各个细节，剩下的业务不过是堆代码，技术上已经没有挑战了，这也是这个项目最近一段时间更新慢的缘由。

这是我和你们分享的第二点经验，项目要有价值。

3. 适当宣传

微人事和 V 部落刚刚上线的时候，个人相关文章被慕课网猛推过几回，当时就让微人事受到了比较多的关注，印象中，大概不到一个月的时间，star 数就超过 1k 了。

因为文档比较详细，不少大佬在整理相关资料的时候都会加上微人事项目，不少小伙伴可能见过标题相似下面这样的文章：

• 13个优秀的 Spring Boot 学习项目
• 开源的13个Spring Boot 优秀学习项目！
• 六月份 GitHub 上最受欢迎的开源项目
• 七月份 GitHub 上最受欢迎的开源项目

....

这一类的文章大部分都会收录微人事项目，进而将微人事项目曝光给更多小伙伴去学习。

今年七月份，有感于 1 年前公司倒闭时的无助，松哥写了一篇文章介绍了微人事项目的诞生过程：

• 公司倒闭 1 年了，而我当年的项目上了 GitHub 热榜

没想到这篇文章被不少大佬转发，单单在知乎上这篇文章的阅读量就超过 12w，那一段时间，微人事项目也被不少有须要的小伙伴关注到了。

宣传这一块，个人经验是若是项目确实帮助到了不少小伙伴，对不少人而言有价值，你会发现平台，一些有影响力的技术牛人会天然的帮你推。因此，我仍是建议将重心放在项目上。所谓家有梧桐树，引得凤凰来。

这是我介绍的第三点经验，适当宣传。

好了，一点点不太成熟的经验分享给小伙伴们，但愿能帮到你们。
关注公众号【江南一点雨】，专一于 Spring Boot+微服务以及先后端分离等全栈技术，按期视频教程分享，关注后回复 Java ，领取松哥为你精心准备的 Java 干货！