怎样给文件命名才能显得比较专业

写这篇博客的动机很简单，就是我周末闲的无聊，爬了github上star数前1000的js项目的所有文件的名称，看看大佬们都喜欢给文件和目录取什么名字，我跟着学两招也好显得我比较专业。

注意是js项目啊，你要是搞java的搞PHP的，也跟着学搞不好会被拿去祭天。

排除掉了.babelrc，package.json，.github这类文件，得到了93117个文件名。

然后我对文件名计数，同一个项目中多次出现的名称只计算一次。也就是1000个项目中，出现频次最高的名称也不会超过1000。

结果这里写不下，可以点击这里看所有结果，我画了个图大家感受一下就行了

有点意外，出现次数最多的是test，565次，其次才是是src，556次

顾名思义，src是源代码，test就是测试，同样js，css，img这些目录名都很直观。

但是也有一些不太直观的名字在这些项目中也大量出现，比如legacy，benchmarks，fixtures等等。

下面列出了一些常用的名称，并不是按出现频次排序，但是列出来的都是出现频次非常高的
单复数形式都出现了的只列出次数最多的
注意，都是目录名称，不是文件名

• src，source </br>
  源代码，用src居多

• test，__tests__ </br>
  测试文件，也经常用__test__，facebook的测试框架jest默认的测试文件目录就是__test__

• docs </br>
  文档

• lib </br>
  库文件，library的缩写

• dist </br>
  用来放打包编译后的文件，应该是distribution的缩写

• build，scripts </br>
  构建脚本

• utils，tools，helpers </br>
  工具代码

• controllers，views，middlewares，models </br>
  MVC对应的models，views，controllers，还有中间件middlewares

• router </br>
  路由

• server </br>
  用来放服务端代码

• adapters </br>
  适配器，适配器模式是一种很常用的设计模式 </br>
  栗子：https://github.com/hubotio/hubot/tree/master/src/adapters

• legacy </br>
  一般用来放兼容历史版本或兼容旧浏览器的代码 </br>
  栗子：https://github.com/julianshapiro/velocity/tree/master/legacy

• config </br>
  配置文件

• benchmarks </br>
  benchmarks测试，又叫基准测试或性能测试。用来测试版本的性能变化

• unit，spec </br>
  单元测试，一般在test目录下

• e2e </br>
  端对端测试，一般在test目录下

• assets，vendor </br>
  资源，一般用来放图片或css文件

• static </br>
  静态资源

• examples，demo </br>
  示例

• component </br>
  组件

• plugins </br>
  插件

• bin </br>
  命令脚本，命令行工具经常会用到
  栗子：https://github.com/vuejs/vue-cli/tree/dev/packages/%40vue/cli/bin

• common </br>
  公用的文件

• packages </br>
  很多项目会打包出多个npm包，用来减小体积，一般会用packages来放不同的包
  栗子：https://github.com/babel/babel/tree/master/packages

• misc </br>
  杂项，miscellaneous的缩写</br>
  栗子：https://github.com/babel/babel/tree/master/packages/babel-plugin-transform-modules-commonjs/test/fixtures/misc

• core </br>
  核心文件 </br>
  栗子：https://github.com/mrdoob/three.js/tree/dev/src/core

还有一大堆，总共500多个，我不一一解释了，有兴趣可以点击看统计结果

其实大部分文件名看名字就能知道意思，也有一些是约定俗成的缩写。
相比之下更有意义的是对变量和函数名称的分析，我下次把这些项目的所有js文件内容爬下来然后再做一个分析。

打个广告：

我的博客 https://github.com/hujiulong/blog

欢迎star