首页
学习
活动
专区
工具
TVP
发布
精选内容/技术社群/优惠产品,尽在小程序
立即前往

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

原文:https://segmentfault.com/a/1190000013376765?utm_source=channel-hottest

前言

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

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

统计结果

排除掉了 , , 这类文件,得到了93117个文件名。

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

结果这里写不下,可以[点击这里看所有结果]https://github.com/hujiulong/blog/blob/master/demo/data/themostfrequent_names.md,我画了个图大家感受一下就行了

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

顾名思义, 是源代码, 就是测试,同样 , , 这些目录名都很直观。

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

常用名称

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

src,source

源代码,用 居多

test,tests

测试文件,也经常用 ,facebook的测试框架 默认的测试文件目录就是

docs

文档

lib

库文件,library的缩写

dist

用来放打包编译后的文件,应该是distribution的缩写

build,scripts

构建脚本

utils,tools,helpers

工具代码

controllers,views,middlewares,models

MVC对应的models,views,controllers,还有中间件middlewares

router

路由

server

用来放服务端代码

adapters

适配器,适配器模式是一种很常用的设计模式 栗子:https://github.com/hubotio/hu...

legacy

一般用来放兼容历史版本或兼容旧浏览器的代码 栗子:https://github.com/julianshap...

config

配置文件

benchmarks

benchmarks测试,又叫基准测试或性能测试。用来测试版本的性能变化

unit,spec

单元测试,一般在 目录下

e2e

端对端测试,一般在 目录下

assets,vendor

资源,一般用来放图片或css文件

static

静态资源

examples,demo

示例

component

组件

plugins

插件

bin

命令脚本,命令行工具经常会用到 栗子:https://github.com/vuejs/vue-...

common

公用的文件

packages

很多项目会打包出多个npm包,用来减小体积,一般会用 来放不同的包 栗子:https://github.com/babel/babe...

misc

杂项,miscellaneous的缩写 栗子:https://github.com/babel/babe...

core

核心文件 栗子:https://github.com/mrdoob/thr...

还有一大堆,总共500多个,我不一一解释了,有兴趣可以点击看[统计结果]https://github.com/hujiulong/blog/blob/master/demo/data/themostfrequent_names.md

后话

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

  • 发表于:
  • 原文链接http://kuaibao.qq.com/s/20180226A0ILUR00?refer=cp_1026
  • 腾讯「腾讯云开发者社区」是腾讯内容开放平台帐号(企鹅号)传播渠道之一,根据《腾讯内容开放平台服务协议》转载发布内容。
  • 如有侵权,请联系 cloudcommunity@tencent.com 删除。

扫码

添加站长 进交流群

领取专属 10元无门槛券

私享最新 技术干货

扫码加入开发者社群
领券