转眼就快到春节了，是时候来一个不大不小的总结了。

今年发生的事情比较多，也没有想过要去逐个去进行记录。

说起年度总结，已经有很长一段时间没有进行记录了。

还是按照上一次的总结的提纲来进行简单记录吧。

公司项目

回顾之下，2020 年做的项目太少了。公司项目只有一个，已经够了。个人项目有点散乱，在之前的项目维护的基础上进行了一番修订。

负责参与的项目为公司内部的核心 A 级项目，本人将负责的内容分阶段进行阐述。

第一季度

刚入职，那个时候刚巧碰上疫情，在家里远程办公，持续到 3 月份才返回职场。远程的效率其实远远没有现场高，诸多权限限制，得到无法顺利进行编译代码，开发效率不可谓不低。饶是如此，还是取得了不少的进展。

内部几个迭代之后发布的效果还算令人不错，我在其中负责多个模块的管理与开发，包括“企业信用管理”，“任企付”（后改名叫“易企发”），“疫情减息活动”，“数字证”，“数字保管箱”，“数字融资”（涉及到中小企业贷款），“企业资讯”等。

第二季度

由于公司高层的战略调整，我们的 APP 的功能点与公司内另外一个 APP 的功能点高度重合，于是有了项目合并的操作。合并之后还是叫数字口袋，内部叫法只是在前面加了一个新字以示区别。

新 APP 的功能略有调整，“易企发”由于有高度重合的现有产品，被裁撤。数字融资为两边都有的功能，进行合并。“企业信用管理”由于对接的第三方存在诸多问题，被无限期挂起。“企业资讯”改名叫“企业头条”（后定名为“数字头条”）。

可以看到，数字化运作是我们项目的一大亮点，也是一种运营手段。

期间，“数字证”，“数字保管箱”，“数字头条”是本人核心负责的模块，也参与“数字融资”的部分开发与管理工作。同时发挥自己的技术优势，开始对前端 WEB 开发进行规范性指导，解决开发团队面对的重点和难点问题。

第三季度

是的，大概从第二季度结尾期间，业务侧准备搞一点大事件，做营销活动。我被指派为营销活动的前端开发负责人。

之前原本计划负责的数字头条内部 CMS 系统建设由于本人的技术重心变更，业务也放弃了这方面的规划。

整个团队之前从未进行过营销活动方面的开发，可以说是毫无经验，我持有的部分经验无法带动带现有体系当中，所以做起来也多半是吃力不讨好的。

经过一番苦战，我主要负责新客大礼包的相关开发和管理，这也是业务准备重点推广的拉新活动。截止到 11 月份，新客大礼包的活动取得的效果卓著，拉新效果远远高出其他所有活动的总和。这一点也是令我们感到荣幸的。

部分开发人员由于合约到期，不能再进行驻场，也是经历几波迎来送往。

第四季度

团队内部对模块的管理出现了严重的分歧，管理层商议之下之后，决定将几个可以分离的模块分离出去以进行单独管理，以达到快速发版迭代的要求。于是本人被授命担任营销活动模块整体分离的负责人。由于分离需要进行全功能覆盖范围和迁移相关的兼容性测试，工作量较大，好在整个迁移过程平稳并未出现问题。迁移期间由于开发人员和测试人员配合到位，新客大礼包的营销效果一如既往的卓越。

迁移完成之后，由于当时的前端开发体系混乱（甚至有提到前端不需要架构、没有架构可言），本人被指派为前端架构优化整改的负责人之一。虽然说之一，但实际上之一可以拿掉的，另外几个负责人实际上由于各种各样的原因，并没有参与到其中。

在这期间，本人利用自己的技术优势，提供了大量的通用方法，也综合考虑不同的前端页面场景，着重探索了原生 APP 与 HTML5 页面之间的交互问题。提出的一些建议很快得到落实，给团队的整理开发能力上升了一个台阶。

另外，对于部分开发人员的代码风格混乱的场景，将之前建议的 lint 校验工具升级为强制校验。本质上是利用了 git hooks 在提交代码的时候进行代码检测。也算是自己对 Git 工程化辅助能力的一种很好的使用。

综合回顾

在梳理和整合前端体系的时候，出现了很多令我捉摸不透的问题。这可能跟团队的性质有关。之前我们的团队的主要工作内容是创新性质的，而之后团队整合，变成了求稳。也或许是因为这样，诸多优秀的技术无法得到顺利的落地，在提升效率的道路上遇到了极为严重的阻碍。

在既有资源的支撑下，本人不遗余力的将诸多优秀的工具引入团队中，其中不乏包括优秀的 webpack 插件，极具指导性的风格指导，eslint，shelljs，git hooks，stylus 等。

核心依赖在确保不会出现重大问题的前提之下进行了升级，比如 axios，core-js，vuex 等工具，解决了一些已经被公开的安全漏洞。

期间也发现了团队内部的开发人员的水平普遍具有鲜明的个性，团队建设很多时候变成了一句空谈。可能心还是比较散漫吧，据说是被惯的。

关于敏捷不得不说的一些事

从我入职的时候开始，团队里面是有一个敏捷教练协助我们进行敏捷化转型。抛开敏捷转型的必要性和可执行性不谈，团队内部对于敏捷教练的态度是令我感到最为困惑的地方。

之前在拥有敏捷教练的团队里面待过，教练拥有非常高的权限，基本上是没有人敢顶撞教练的。然而在我们团队中间，敏捷教练仿佛成为了一个摆设，令不行，禁不止，转型过程谈不上成功。敏捷教练后半年退场，之后团队继续陷入混沌状态。

有一说一，在面对如此的一个团队的时候，可能没有人敢跳出来指正和纠偏吧。

本人对于敏捷的理解可能跟很多人的并不一致，我内心从来没有赞同过敏捷机制，但我尊重这个机制，毕竟在没有找到更加有效地方式之前，敏捷机制给团队带来的效果是显著的。

个人项目

zob

得益于团队内部开发团队能力的建设，我将搁置许久的 zob 项目捡了起来，并且更新了 eslint 插件，添加了一些规则。

zmin

尚未整理和进行发布的执行压缩的工具，借助于 image-min 的能力，对常见图片 jpg 和 png 进行压缩，以减少其体积。

人来人往

有人来

是的，新冠疫情缠绕我们一整年的时候，到目前为止还并未有丝毫退散之意，这足以令人唏嘘。在疫情笼罩一下，本人有幸能陪伴自己的爱人一路走来，并在 6 月份喜结连理，从此生命中多了一个至关重要的人。9 月份的婚宴，虽然不大，但已然是生命中美好的记忆点了。

有人走

逝者已去，生者不息。

舅舅因疾病救治无效离开人世，给家族带来了悲伤难以挥去。文字太过悲伤，就不再对其进行描述了。

吃喝玩乐

再回母校

受限于疫情，妻子不太方便离深，故而并未去其他地方游玩。非要说一个，那就是我的母校湖南大学了。因为自己的身体原因，需要去大医院进行诊治，请了一个礼拜的假，带妻子一起去了长沙。在湘雅医院看病完成之后，便带她去了湖南大学。

彼时，地铁已经开通，可以直达我的母校。

云南之行

已经好几年没有出去旅游了，这一次，我们携手去往了云南，游玩了丽江古城，嬉戏于泸沽湖之上，还特意去探索了木府，本来应该有一篇游记进行记录的，奈何那个时候自己的重点压根不在文字上面，所以也就没有及时进行记录。等到后续有空，自己的记忆还没有淡去，进行添补也未尝不好。

其他散点

像洪湖公园，锦绣文化村，玫瑰海岸，大梅沙，海景公园此类市内景点，也是去游玩了一番的。只可惜莲花山的勒杜鹃画展妻子没有能够赶上，翻看单反随手拍的一些照片也算是一种参与方式吧。

厨艺

没错，因为要照顾妻子的缘故，我将多年搁置的厨艺捡了起来，也尝试许多不同的菜式。以前从来没有做过大菜的我，也进行了尝试。好在效果还算不错，味道也不是那么差，可以继续加油呢。

总结

已经很久没有进行总结和展望了，或许混沌的前两年给自己带来的改变，或许是抑郁抗争从未停止，我已经不太愿意去跟其他人谈论自己的总结和梦想，甚至连自我总结也不会再轻易提及。

随风来，随风去。

最后，总要说点什么新年愿望的，那么我的愿望很简单，就是希望她们母女平安健康，这也是我接下来很长一段时间的核心任务。

至于自我成长，太过遥远，我们先放一放，能将自己的博客或者 camphor 项目捡起来就已经是对自己最大的回报了。

加油！

1. 天安门及周围

天安门广场附近是夜北京最美的地方之一。白日里端庄威严的天安门城楼此时被灯光映衬晶莹剔透，仿佛一处玉雕殿堂。城楼前高低起伏的硕大喷泉，仿佛随歌起舞的仙子，轻灵、飘逸潇洒自如，引得无数游人驻足，甚至有不少年轻人走到喷泉近前，伸出双手去迎接那一朵朵四溅开来的珠花。

前门大街可以考虑去逛逛。

前门大街是北京著名商业街。位于京城中轴线，北起前门月亮湾，南至天桥路口，与天桥南大街相连。明嘉靖二十九年(1550)建外城前是皇帝出城赴天坛、山川坛的御路，建外城后为外城主要南北街道。

前门大街悠久的历史，造就了这里的许多中华老字号，如六必居酱园、同仁堂药店、瑞蚨祥绸布店、长春堂药店、内联升鞋店、张一元茶庄，还有月盛斋的酱肉店、都一处的烧卖店等16处老字号分列道路两侧。

长安街也是绝佳的去处。

长安街在北京，以致全国的的地位十分重要，中国的象征——天安门和天安门广场，就在长安街上，长安街两侧还有人民大会堂、中南海和公安部、商务部等其他中央政府的机关。

东单/西单

位于天安门广场的两侧。西单有商业街，东单有很值得一逛的银街小店。东单离王府井不远，可以一并逛逛。

2. 什刹海

强烈推荐。可以去看看钟楼和南锣鼓巷，还有一个很有意思的烟袋斜街。

这里风光优美，而且人文积淀深厚，既有南国水乡的清幽秀丽，又兼具北方皇家的雍容气度，既能感受普通百姓的生活气息，亦能寻访帝王将相昔日的烙印与足迹，是了解老北京历史与文化的绝佳之地，也是目前北京城内老北京风貌保存最完好的地方。

什刹海景区包括前海、后海、西海等水域以及沿岸众多名胜古迹和胡同民居，这里有宋庆龄故居、郭沫若故居、恭王府花园、广化寺、火神庙、钟鼓楼和银锭桥等古迹。

什刹海的夜，层次丰富、韵味浓厚，什刹海的夜，五彩斑斓、光怪陆离。这里可以乘船游览、赏花、游胡同、享美食，街边的小店更是藏满了神秘与诱惑。夏夜，灯火通明的酒吧一条街人头涌动，中外游人云集，古典与现代在这里完美交融，传统与前卫在这里激情碰撞，品酒眺湖，微风扑面，湖光粼粼，游船杨柳，窃窃私语，别有一番风味。

什刹海景区具有大量典型的胡同和四合院，如金丝套地区的大、小金丝胡同，南、北官房胡同和后海北沿的鸦儿胡同以及白米斜街、烟袋斜街等。

依托胡同和四合院，什刹海地区自古以来就有许多富有特色的民裕活动，如放荷灯、泛舟游湖、宴饮赏荷、冰床围酌、大阅冰鞋等。至今，一些有生命力的民俗活动仍然在什刹海地区大量存在，如钓鱼、游泳、划船、赛艇、下棋、弹唱、消夏舞会等。

3. 簋街

北京簋街的美食一条街可谓是不容错过。嘉陵楼馋嘴城、两岸一家、哈哈镜鸭脖子、宽板凳老灶火锅、胡大饭馆、金簋簋街小山城、俞家小院猪脚巷、兰溪小馆、江边城外烤全鱼等店子都可以去逛逛。

4. 三里屯

全北京的时尚中心之一、文化中心之一，世界各地的艺术、戏剧、音乐、商务、时尚、餐饮和购物在三里屯融汇。可以在户外的商业街区随心漫步，也可以享受室内餐饮和娱乐的空间。花园、庭院和小巷点缀其间，格局开阔，整体设计凸现空间无界的概念，让人漫步其中，体会无穷乐趣。从经典到前卫，三里屯带给人的感觉是持续变幻出新的，体验也是多方位的。夜色中的三里屯，是潮人的天堂。

5. 鸟巢

夜幕降临，灯光自鸟巢那盘根错节的无数钢柱中透射出来，加上水中的倒影，柔和之美与力量之美完美融合。而水立方那透亮的蓝光，让人仿佛到了塞班、马尔代夫，置身于清澈的海水中，感受海天一色的美，感受洁白的浪花打在身上时的凉爽。

鸟巢与水立方，一静一动，一刚一柔，相互烘托又相互映衬，加之国家体育场的身份，成为北京夜色的经典。

6. 世贸天阶

世贸天阶地处首都CBD区域，非常适合下班后休闲或谈事。

晚上通常会放映一些灯光秀或设计秀，这里周末都会聚集一大批文艺青年，来拍照摄影。

7. 朝阳公园/蓝色港湾国际商区

一个充满了灿烂阳光、幽静湖水、优雅建筑、浪漫小径的购物公园，一个位于亚洲最大的城市公园——朝阳公园西北湖岸的欧式商业小镇。

8. 中央广播电视塔/玉渊潭

中央广播电视塔是集广播电视发射和旅游观光、餐饮娱乐为一体的综合性建筑，是北京现代化的一个重要标志。中央广播电视塔共分20余层。塔的设计充分考虑首都北京的特殊地理环境，力图表现塔的中国属性和北京特色。中央广播电视塔的夜景照明也是一绝，曾被评为首都夜景照明工作一等奖。在晚上，仰视中央电视塔，如同一个大灯笼一样挂在空中。

玉渊潭公园樱花节，有机会可以去看看。不过鉴于是晚上，估计看不清，另外，要门票 10 块。

9. 清华/北大

凑数的。

转眼已经是 2018 年的最后一天了，是时候来好好做一个全面的总结了。

以上这段文字是抄袭自去年的总结。

不知道该写点什么，后面再说。

元旦前后，忙于事务，未能更新本篇文章。思来想去，一个象征性的总结还是需要的，所以又回来写点什么吧。

今年（应该叫做去年了，仍然还有中恍惚感）在这个博客上面发布的文章数量竟未过十，想来自己的重心确实已经不在文字创作上面了吧。包括对《圣血记》的创作，停滞的状态从来没有变过。

回顾一下 2018 年，令人唏嘘的事情太多，经历的波折也可以专门拎出来写一篇传记了。

其实本篇文章并不是真正意义的总结，真正的总结不在这里。

接手的项目

回顾之下，发现，2018 年做的项目有点多，容我梳理梳理。

嗯，捡重要的简单罗列一下吧。

空港出行管理后台

这个是 2017 年开始接手的项目，2018 年将其做了一番深入开发，重构了页面框架，支持了大部分网约车相关的后台管理场景。

空港专车

一个微信小程序，来实现微信端呼叫网约车的功能。接手之后对齐进行了完全重构，但也是使用的原生的方式进行开发，贴近官方的语法。

车享智能

这个就是 2018 年我们的创业项目，一个妄图赶上共享经济时代的产品。从产品规划到技术实现，包括硬件和软件，我们都深度参与其中，最终做出了一个能面市的小规模产品。

先导客服平台

这是 7 月份加入新公司新团队之后负责的一款产品，该产品分为三个端，前端均由我进行主力开发。解决在 APP 端没有客服系统的尴尬并对数据、订单、投诉反馈进行统一的管理。

先导约车管理后台

从单独扒取 API 到重建系统页面，一个标准的从传统开发模式（即以 jQuery 为核心的一套框架）转向三大框架之一的 Vue 的迁移例子。百分之百的还原了出去按钮权限控制（后台并没有直接给出相应接口）之外的所有功能，并对大部分业务场景做了抽象化封装。

先导约车微信端

类似上面的方式，使用 Vue 技术栈重构微信公众号页面，并解决了诸多之前存在的问题。目前的叫车体验比之前精进的不止一两点。

先导运维管理系统

辅助进行问题跟踪和页面调试。

先导企业用车管理端

可以单独拎出来作为子系统的约车子系统，实现了企业用车的 WEB 操作界面独立化。

个人项目

trademark-classification

出于学习的目的，构建了本项目，用于快速查询商标。

node-wxpay-test

同样也是出于学习的目的，也是为了更好的实现车享智能项目，制作了这个项目，实践微信公众号支付。

draw.io

这个项目是在 2018 年年底萌生的转型想法的雏形项目，是利用在线项目 draw.io 构建流程图的项目载体。

api-test

一个简单版本的 API 测试工具，非常简单，简单到我已经将它给删了。

vue-cli3-demo

听说 Vue CLI 3 更新了新版本，所以就有了这么一个演示版本。

gank

根据干货集中营提供的开放接口，使用 vue 构建了一个 WEB 端。

garden

之前位于博客的花园项目，独立出来了。主要是用来展示一些简单的工具和在线文档的。

新增的技术栈

很惭愧，2018 年在技术栈可谓是毫无建树，并没有追加什么新技术栈。只是稳固了这么久以来使用到的一些技术和知识，特别是 vue，目前已经逐渐变成一个重度使用者了。

node 是用的逐渐多了起来，但很多也只是停留在个人实验性阶段，并没有实际的应用，顶多也只是做一个中间件或者转发请求，这些原本使用 nginx 就可以轻松做到。

尝试过的技术

• react
• dart
• flutter
• redis
• docker

仅仅是尝试，挺有意思的，学无止境，大概说的就是这个吧。

总结

去年提出的展望是这个：

• 遇见更好的自己。
• 让自己内心更加平静。
• 努力提升自己的情商和魅力值。

很遗憾，只有第二条算做到了。第一条勉强也算，但是第三条的话，因为 7 月份的时候一些事情的发生，苗头被迅速抹杀，同时也直接造就了《圣血记外传之萧非玉》的萌芽。相关细节由于过于悲苦，过往不愿再被提起，就此长久搁置。

回顾整个 2018 年，上半年我是阳光灿烂的存在，但是 7 月份的转机过大，灰霾阴郁持续笼罩。经历了长达半年的失眠抑郁，我却依然没有倒下，充满希望的我收拾自己的行囊，重新踏上征程。灰暗存在，或许只是为了衬托光明的存在。

展望 2019

没什么，只有一点：继续让自己更加平静。

加油！

其实，可以看得出来，我已经不太愿意去写博客了，很多东西其实在我的日志项目中已经做了记录，大部分的技术攻略或者资料均做了简单总结。

前路漫漫，珍重。

之前曾经介绍过一个跟扩展相关的文章，那已经是 18 个月前的事情了：Brackets。

近日将再记录两篇文章，一个是跟 VSCode 的扩展，另一个是 Chrome 浏览器的扩展。列出的扩展是本人使用过的。本文讲述 VSCode 的扩展。

话不多说，直接进入正题，本次列举的扩展如下：

Auto Close Tag 和 Auto Rename Tag

这两个扩展通常会放在一起，前者是自动闭合 HTML 标签的，后者是自动重命名 HTML 标签的。

Beautify

代码格式化工具。

Bracket Pair Colorizer

括号匹配高亮。非常实用的一个扩展。

Color Picker

CSS 颜色选择器。

Debugger for Chrome

调试神器。

Document This

自动对代码进行智能注释，兼容 JSDoc，可以作用域 function、class 等地方。默认快捷键为按两次 Ctrl+Alt+D。

ESLint

ESLint 在 VSCode 中的应用。

Git History

管理 Git 提交记录的工具。在多项目中也表现优异。

Guides

空白换行等的可视化标示。

Markdown PDF

将 markdown 文件转换为 PDF，同时支持转换为 html、jpeg 和 png。

Markdown TOC

给 markdown 生成目录并自动更新。

Material Icon Theme

一套 Material Design 风格的文件图标。

Polacode

将指定代码生成一张看起来挺不错的图片。

RegExp Preview and Editor

正则表达式的可视化工具。

Sublime Text Keymap and Settings Importer

使用 Sublime 的快捷键。之前习惯使用 Sublime，所以也将几个常用的快捷键搬了过来。

SVG Viewer

svg 图片直接查看工具。

Toggle Quotes

切换引号。引号组是 "、'、`。

Vetur

是的，就是 vue。

介绍完毕。

下一篇的走起了。

之前曾经介绍过一个跟扩展相关的文章，那已经是 18 个月前的事情了：Brackets。

近日将再记录两篇文章，一个是跟 VSCode 的扩展，另一个是 Chrome 浏览器的扩展。列出的扩展是本人使用过的。本文讲述 Chrome 的扩展。

话不多说，直接进入正题，本次列举的扩展如下：

AdBlock

广告拦截插件，实力拦截不入眼的东西。

Axure RP Extension for Chrome

Axure 原型图工具导出的 HTML 文档的查看工具，直接通过 file 协议查看的话会有所限制，使用该插件之后就可以愉快的浏览 Axure 的制作的原型图了。

目前已经转战墨刀。

GitHub Hovercard

GitHub 辅助工具，鼠标悬浮上去的时候拉取关键信息并进行显示。

Isometric Contributions

在 GitHub 首页，将贡献记录渲染成 3D 视图，更加立体的展现。

JSONView

格式化 JSON 文件。

OctoLinker

快速查看代码中引用的文件或类库。

Octotree

GitHub 项目查看时使用 Code tree 模式进行查看和管理。

Vue.js devtools

Vue 开发工具。

Wappalyzer

检测当前访问的网站所使用到的技术，包含服务器、使用到的工具、框架等等。

以下部分安装在非 Chrome 浏览器上，但是也是在 Chromium 内核的浏览器运行的扩展/插件。

CSSViewer

CSS 查看工具。

Fiddler

简单的 API 侦听工具。

Frameworks

跟上面的 Wappalyzer 的功能类似，但只检测使用到的框架和类库。

Page Ruler

页面尺寸丈量工具。

Postman Interceptor

Postman 拦截器工具。

依然不能愉快的解决跨域问题，所以直接弃用了，采用了客户端软件。浏览器的自己编写了超级简单的一个工具。

QQ空间放大

专门用于放大 QQ空间 里面的图片的一个工具。现在已经基本不逛了。

Redirector

伪装重定向工具，通过某种设置可以做出翻墙工具的效果，但有效性堪忧。

Responsive Web Design Tester

快速切换浏览器大小。

Web Developer

很实用的一套 WEB 开发工具组合。

WhatFont

快速查看 CSS 字体。

好声音

获取当前网页中的音效和音乐的实际地址。

眼不见心不烦（新浪微博）

新浪微博美化工具。

草料二维码

二维码管理工具。

本文直接使用 Buffer 讲述这个对象，该对象翻译成中文，可以叫做“缓冲区对象”。

官方文档的介绍如下：

Prior to the introduction of TypedArray, the JavaScript language had no mechanism for reading or manipulating streams of binary data. The Buffer class was introduced as part of the Node.js API to enable interaction with octet streams in TCP streams, file system operations, and other contexts.

在 ECMAScript 2015 引入 TypedArray 之后，Buffer 类使用了一种更优化、更适合 Node.js 用例的方式实现了 Uint8Array API。

Buffer 类可以视作一个跟 Array 类一样的对象，区别在于 Buffer 的大小是固定的，且在 v8 堆外分配物理内存。Buffer 的大小在创建时就确定了，无法调整。

先来看一段官方文档提供的示例代码：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

// Creates a zero-filled Buffer of length 10.
const buf1 = Buffer.alloc(10);

// Creates a Buffer of length 10, filled with 0x1.
const buf2 = Buffer.alloc(10, 1);

// Creates an uninitialized buffer of length 10.
// This is faster than calling Buffer.alloc() but the returned
// Buffer instance might contain old data that needs to be
// overwritten using either fill() or write().
const buf3 = Buffer.allocUnsafe(10);

// Creates a Buffer containing [0x1, 0x2, 0x3].
const buf4 = Buffer.from([1, 2, 3]);

// Creates a Buffer containing UTF-8 bytes [0x74, 0xc3, 0xa9, 0x73, 0x74].
const buf5 = Buffer.from('tést');

// Creates a Buffer containing Latin-1 bytes [0x74, 0xe9, 0x73, 0x74].
const buf6 = Buffer.from('tést', 'latin1');

Buffer 实例一般用于表示编码字符的序列，用过指定字符编码，可以在 Buffer 实例与常规 JavaScript 字符串之间进行相互转换。

这样的描述，可能太过于抽象，直接上代码解释吧：

1
2
3
4
5
6
7
8
9

function btoa(str) {
  const buf = Buffer.from(str);
  return buf.toString('base64');
}

function atob(str) {
  const buf = Buffer.from(str, 'base64');
  return buf.toString();
}

上面的代码，是 node 环境下关于浏览器 atob 和 btoa 方法的实现。

Node.js 目前支持的字符编码如下：

• ascii，仅支持 7 位 ASCII 数据。
• utf8，多字节编码的 Unicode 字符。许多网页和其他文档格式都使用 UTF-8。
• utf16le，2 或 4 字节，little-endian(小字节序)编码的 Unicode 字符。支持 U+10000 到 U+10FFFF 的代理对。
• usc2，即 utf16le。
• base64，即 Base64 编码。
• latin1，即 Latin-1 编码，具体由 IANA 在 RFC1345 中定义。
• binary，即 latin1。
• hex，将每个字节编码为两个十六进制字符。

注意，现代浏览器遵循 WHATWG 编码标准 将 latin1 和 ISO-8859-1 别名为 win-1252。这意味着在进行例如 http.get() 获取到的字符编码在规范列表中，服务器可能返回 win-1252 编码的数据，此时如果使用 latin1 字符编码，可能会得到错误的解码数据。

Buffer 对象可以使用 for...of 进行内部迭代。同样的，实例对象的 .values、.keys 和 .entries 方法都可以创建迭代。

使用 new 操作符实例化一个 Buffer 的方法已经被弃用。注意，已经弃用的方法本文不做介绍。

创建 Buffer 实例的方法有下面几个：

• Buffer.from(array)，从数组进行创建。
• Buffer.from(arrayBuffer[, byteOffset[, length]])，从 arrayBuffer 的实例进行创建。
• Buffer.from(buffer)，直接根据 buffer 创建。
• Buffer.from(string[, encoding])，根据字符串创建，encoding 即使用的编码方式。
• Buffer.from(object[, offsetOrEncoding[, length]])，根据对象创建，该对象需要支持 Symbol.toPrimitive 或者有 valueOf() 方法，比如 Buffer.from(new String('this is a test'));。
• Buffer.alloc(size[, fill[, encoding]])，创建一个指定长度的对象，fill 表示用来填充新建的 Buffer 的值，默认为 0。
• Buffer.allocUnsafe(size)，分配一个大小为 size 的对象。该方式创建的 Buffer 对象是未经过初始化的，内容未知，可能包含敏感数据。

更多的创建方式不在本文的记述范围之内。

创建之后的实例，我们使用 buf 进行表示，buf 的特性跟数组类似。

buf.buffer 指向了 Buffer 底层的 ArrayBuffer 对象。

可以使用 fill 方法进行填充，语法为 buf.fill(value[, offset[, end]][, encoding])。

toString 可以将 buf 转为一个常规字符串，语法为 buf.toString([encoding[, start[, end]]])。

之前做了一个简单的获取网页源代码的方法，代码大概是这样的：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

const http = require('http');
const https = require('https');

module.exports = function getHTML(url) {

  return new Promise(function (resolve, reject) {
    (/^https/i.test(url) ? https : http).get(url, function (res) {
      var html = '';

      res.on('data', function (chunk) {
        // chunk is a Buffer instance, use the method toString to get the string
        html += chunk;
      });

      res.on('end', function () {
        resolve(html);
      });
    }).on('error', function () {
      reject();
    });
  });
}

是的，这里面的 chunk 对象就是一个 Buffer 实例。

真·简介。本文到此就结束了。

阅读本文需要有一定的 ES6 基础。

ES6 模块是 ES6 中的一个非常重要的特性，它收集了多年来各种模块化的优点，解决了其间的差异化，并期望能最终形成一个大家共同遵守的规范。

关于 JS 的模块化历程，可以参考 这篇文章。

本文从 import 和 export 两部分对 ES6 模块做一个基础的介绍，这两部分内容也就是 ES6 模块的全部了。

import

来看一组现有的 import 语法：

1
2
3
4
5
6
7
8
9

import defaultExport from "module-name";
import * as name from "module-name";
import { export } from "module-name";
import { export as alias } from "module-name";
import { export1 , export2 } from "module-name";
import { export1 , export2 as alias2 , [...] } from "module-name";
import defaultExport, { export [ , [...] ] } from "module-name";
import defaultExport, * as name from "module-name";
import "module-name";

以上代码来自 MDN 上面关于 import 的介绍。

import 是模块导入语句的关键字，通过指定具体的导入方式，可以进行相应模块的导入操作。

以下是逐条说明：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

// 导入默认模块
import defaultExport from "module-name";
// 导入所有模块并指定一个新的名称，导入后的对象包含了所有具名模块
import * as name from "module-name";
// 导入指定模块
import { export } from "module-name";
// 导入指定的模块并指定一个新的名称，即直接进行重命名操作
import { export as alias } from "module-name";
// 导入多个模块
import { export1 , export2 } from "module-name";
// 导入多个模块，并对其中的某一部分进行重命名
import { export1 , export2 as alias2 , [...] } from "module-name";
// 同时导入默认模块和其他模块
import defaultExport, { export [ , [...] ] } from "module-name";
// 同时导入模块模块，并将所有模块以新名称进行导入
import defaultExport, * as name from "module-name";
// 直接引入模块，不导入任何东西
import "module-name";

export

export 是模块导出语句的关键字，同样的，来看一组 export 的语法，代码来自 MDN 上面的 export：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

// 导出指定模块
export { name1, name2, …, nameN };
// 导出指定模块，并进行重命名
export { variable1 as name1, variable2 as name2, …, nameN };
// 导出变量
export let name1, name2, …, nameN; // also var
// 导出变量，并对变量直接进行定义
export let name1 = …, name2 = …, …, nameN; // also var, const
// 导出函数
export function FunctionName(){...}
// 导出类
export class ClassName {...}

// 导出一个表达式作为默认模块
export default expression;
// 导出匿名函数作为默认模块，类和生成器函数亦可
export default function (…) { … } // also class, function*
// 导出具名函数作为默认模块，类和生成器函数亦可
export default function name1(…) { … } // also class, function*
// 将指定模块作为默认模块进行导出
export { name1 as default, … };

// 从另一个模块提取所有模块进行导出
export * from …;
// 从另一个模块提取指定模块进行导出
export { name1, name2, …, nameN } from …;
// 从另一个模块提取指定的模块并进行重命名后再导出
export { import1 as name1, import2 as name2, …, nameN } from …;
// 从另一个模块导出默认模块
export { default } from …;

一些说明

1. 在进行 import 的时候，import { export } from "module-name"; 中的 { export } 语法并不等同于对象的解构，这是 import 专门的语法。
2. export 和 export default 的区别是在后续进行引入的时候需要分别使用 import { ... } from 和 import ... from 进行操作。
3. 作为默认模块进行导出时，匿名函数和具名函数在导出之后并无区分。
4. 导出后的模块，如果存在变量，该变量对外是不可变的。可以通过模块内置的方法进行改变。

大体上就是这些内容了，ES6 的模块化给编程领域尤其是前端开发这一块，带来非常大的便利。

由于市面上直接支持 ES6 模块的产品的覆盖率依然不够理想，所以需要通过一些转译工具进行转译之后再进行使用。

目前，本人主要工作是在进行微信小程序的开发，好在小程序现在的开发环境已经基本支持 import 和 export 语法（除了 export ... from），所以可以放心无忧的进行现代化 ES6 代码的编写了。目前使用原生代码进行微信小程序的编写，感觉良好。至于 wepy 和 mpvue 之类的前瞻框架，由于未进行全面使用，所以不做过多评述。

在撰写本文的时候，参考了大量的资料，但是提笔的时候却又感觉很词穷，所以只是简单的做了一个代码层次的注释说明，更多的参考资料罗列如下，请诸君自行参阅。

参考资料与拓展阅读

• ECMAScript 6 modules: the final syntax
• import - JavaScript | MDN
• export - JavaScript | MDN
• Previewing ES6 Modules and more from ES2015, ES2016 and beyond
• ES6 In Depth: Modules
• ES modules: A cartoon deep-dive
• Exploring ES6 - 16. Modules
• eslint/espree - #43 - adds module import and export grammar
• tc39/proposal-export-default-from
• tc39/proposal-dynamic-import
• What do ES6 modules export?
• Understanding ES6 Modules
• CommonJS
• JavaScript Modules
• Choose ES6 modules Today!
• JavaScript Modules: A Beginner’s Guide
• History and Background of JavaScript Module Loaders
• JavaScript Module Pattern: In-Depth

<本文完>

本文根据个人日志中相关记录进行整理而成。

注意，这并不是一篇配置攻略或者是文档性质的，阅读时请不要以本篇文章描述的为主，请适当进行斟酌。

导语中的文本来自于百度百科，不过根据官网的描述，nginx 是这样的一个东西：

nginx [engine x] is an HTTP and reverse proxy server, a mail proxy server, and a generic TCP/UDP proxy server, originally written by Igor Sysoev.

本文将一句个人日志项目中关于 nginx 的记载进行阐述。

最初，在去年 9 月份，我第一次记录了关于 nginx 的东西，是关于如何在 nginx 站点中开启文件目录的浏览：在 location 模块中使用 autoindex on; 指令即可。

然后没过多久，写了一篇关于开启指定域名访问的记录，即设置 server_name 指令。

在 12 月初，写了一篇重量级的文章，安装 nginx，这也是我第一次完全自己部署前端站点的一次尝试。

nginx 的常规依赖：

• zlib，用于开启 gzip 压缩。
• pcre，用于开启伪静态或者重定向。
• openssh，用于开启 ssl，或者换个说法，叫做 https。

安装过程中需要 gcc-c++ 运行库。

紧接着没多久，写了一篇如何配置 nginx 的日志，讲述了如何开启多配置文件模式，主要是 include 指令。顺便阐述了一下过滤非法域名访问的问题，default_server 关键字进行设置即可。

之后在一篇微信支付相关的记录中，提到了关于反向代理转发真实 IP 地址的方法。

过完年之后，由于等级保护评估测试相关的原因，针对前端全站开启了 https 模式。关键配置为 listen 443 ssl;，结合 ssl_certificate 和 ssl_certificate_key 进行相关文件的配置即可完成。

由于 https 的访问模式，页面不能直接使用 http 请求，于是针对之前提到的反向代理 proxy_pass 进行了再一次的阐述，并对负载均衡进行了说明。nginx 的负载均衡是一个非常强大的功能，主要依赖 upstream 来进行相关配置。

之后没多久，有需要页面重定向的需求，于是对 rewrite 指令做了简单的介绍。

因为某一次的服务器改版，转发 https 到 http 的时候，发现端口出现了稍稍的偏差。于是针对 X-Forwarded-Proto 之类的参数设置进行了相关的解释。

后来因个人项目，部署的时候想尝试一下路由的 history 模式，于是 nginx 的 try_files 指令被提上日程，但是目前我并没有进行日志记录。

至此，本人日志项目关于 nginx 的记录就回顾完毕，这大概也就是本篇文章的主要内容了。

另外，在阅读子项目中，曾经记录了一篇跟 nginx 密切相关的书籍《Nginx 开发从入门到精通》，该书是 tengine 开发团队主笔的。

• nginx 官网
• nginx documentation
• Module ngx_stream_upstream_module
• ngx_http_proxy_module.c in nginx/src/http/modules – nginx
• If Is Evil | NGINX
• Nginx开发从入门到精通
• Nginx/Apache: set HSTS only if X-Forwarded-Proto is https - Server Fault

那么，就直接开门见山呗。本篇博客根据个人日志记录整理而成。

项目地址：https://github.com/xovel/node-wxpay-test

其实大部分的文档，微信官方开发文档里面都提供了，我们只需要按照其说明严格执行就可以达到目的。

注意，这里只讲述公众号支付相关的情形，其他的基本类似，本人未作深入实践，故此不敢多言。

这次的讲解，主要从四个方面进行说明：

1. 相关账户配置
2. 后台的搭建
3. 前端页面的展示
4. 支付流程

账户

首先，肯定是需要一个微信公众号的。公众号的性质需要满足开通商户号和微信支付，并且实际上已经开通好了。这次我用的账号是认证好了的服务号。

进入公众号设置界面，对相关的域名进行配置，本次调试，我使用的域名是 z.hdk4.com，故此在公众的管理页面的 【设置】-【公众号设置】-【功能设置】 中对 业务域名、JS接口安全域名、网页授权域名 全部进行了相应的设置。

至于开发者的添加和公众号密钥和商户号密钥等数据的获取，属于入门级别，这里不再赘述。

要做微信支付，需要事先对 支付授权目录 进行设置，在商户号管理页面就能够找得到，直接进行设置即可。注意这里是 支付目录 的设置，即浏览器访问下的 location.pathname 对应的访问路径，结尾必须以 / 结束且区分大小写。

后台

这一块最为重要也是核心所在，由于只是演示与测验，所以采用了简单粗暴的 express 来作为后台服务器。详情容后再禀。

前端

前端页面相对来说简单一些，在引入微信的官方 js，即 http://res.wx.qq.com/open/js/jweixin-1.2.0.js 之后，调用 WeixinJSBridge 的 API，发起 getBrandWCPayRequest 请求即可。

1
2
3
4
5
6
7
8
9
10

WeixinJSBridge.invoke('getBrandWCPayRequest', {
  appId: data.appId,
  timeStamp: data.timeStamp,
  nonceStr: data.nonceStr,
  package: data.package,
  signType: data.signType,
  paySign: data.paySign
}, function (res) {
  // ...
});

当然，在这里之前，需要先获取用户的 openid。

当然，在获取 openid 之前，还需要获取一下用户的访问 code。

那么，这个访问的 code 如何获取呢？

根据微信开发文档提供的链接 https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1421140842，我们先判断链接是否有 code 字段，如果没有则跳转到微信的链接去进行获取。获取到了之后再进行 openid 的获取。文档方面的信息这里不详细展开，直接上代码进行说明吧！

1
2
3
4
5
6
7
8
9
10
11
12
13
14

var code = getUrlParam('code') || sessionStorage.code;
var openid = sessionStorage.openid;

// 没有 openid 则尝试获取 code
// code 获取之后跳回原链接进行临时存储
if (!openid) {
  if (!code) {
    var redirect_uri = encodeURIComponent('http://z.hdk4.com/d.html');
    window.location.replace('https://open.weixin.qq.com/connect/oauth2/authorize?appid=wxbce0a3daf503097c&redirect_uri=' + redirect_uri + '&response_type=code&scope=snsapi_base&state=7');
  } else if (!sessionStorage.code) {
    sessionStorage.code = code;
    window.location.replace('http://z.hdk4.com/d.html');
  }
}

几点说明：

• redirect_uri 中的 state=7 是随便写的一个值。
• window.location.replace 用于直接替换，如果不想要替换效果，可以修改为 window.location.href = '...'。
• 采用 sessionStorage 进行数据的缓存。
• getUrlParam 为提取链接中的 querystring。
• 不要管 yoda 什么的了

前端差不多能说的就这么多了。

支付流程

整个支付流程浓缩起来就是：

1. 获取 code
2. 获取 openid
3. 开始进行支付操作
4. 后台发起预支付订单
5. 后台将获取到的预支付信息返回给前端
6. 前端尝试唤起微信支付
7. 进行支付
8. 前端/后台处理支付回调。是的，都进行处理。前端无所谓，后台必须处理，不然微信会发很多次请求。
9. 支付完成
10. 后续一些相关操作。由于本次只是演示与测验，就不做处理了。

现在来说一下核心的重点，即后台的相关逻辑处理与接口的设计。

后台

相关的库的引入与声明，这里就不赘述了。

/api/getopenid 接口

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

// 获取 openid
app.get('/api/getopenid', function (req, res) {
  const code = req.query.code;
  const access_token_url = `https://api.weixin.qq.com/sns/oauth2/access_token?appid=${config.app_id}&secret=${config.app_secret}&code=${code}&grant_type=authorization_code`;

  request.post({ url: access_token_url }, function (error, response, body) {
    wFile('openid', body);
    if (error) {
      res.json({ error: body });
    } else if (response.statusCode === 200) {
      if (body.errcode === 40029 ) {
        res.json({ error: body });
      } else {
        body = JSON.parse(body);
        res.json({ data: body });
      }
    } else {
      res.json({ error: -1 });
    }
  });
});

wFile 是日志记录相关操作，可以无视。

该接口是用来获取用户的 openid 的，要求的东西是 code，这个 code 就是上面前端花费一番周折得到的东西。

前端调用方式：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

function getOpenId() {
  return new Promise(function (resolve, reject) {
    if (sessionStorage.openid) {
      resolve(sessionStorage.openid);
    } else {
      $.get('/api/getopenid?code=' + sessionStorage.code).then(function (res) {
        var data = res.data;
        if (data && data.openid) {
          sessionStorage.openid = data.openid;
          resolve(data.openid)
        } else {
          reject();
        }
      });
    }
  });
}

• 是的， $ 就是大名鼎鼎的 jQuery。
• 采用了 Promise 对象。

/api/unifiedorder 接口

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52

// 获取微信支付的统一下单相关数据
app.get('/api/unifiedorder', function (req, res) {
  const openid = req.query.openid;
  const ip = getClientIp(req);

  // 商户订单号
  const out_trade_no = 'test' + new Date().getTime();

  // 统一下单的相关参数
  const paramUnifiedOrder = {
    appid: config.app_id,
    attach: 'test',
    body: 'desc',
    mch_id: config.mch_id,
    nonce_str: createNonceStr(),
    notify_url: config.notify_url, // 微信付款后的回调地址
    openid: openid,
    out_trade_no: out_trade_no,
    spbill_create_ip: ip,
    total_fee: 1,
    trade_type: 'JSAPI'
  };

  // 签名
  paramUnifiedOrder.sign = getSign(paramUnifiedOrder);

  // 请求微信支付下单接口，获取预订单编号
  request.post({ url: 'https://api.mch.weixin.qq.com/pay/unifiedorder', body: JSON.stringify(getUnifiedOrderXml(paramUnifiedOrder)) }, function (error, response, body) {
    wFile('unifiedorder', body);
    if (error) {
      res.json({ error: body });
    } else if (response.statusCode === 200) {
      let prepay_id = ''; // 预订单编号
      // 微信返回的数据为 xml 格式，需要进行解析
      xml2jsparseString(body, { async: true }, function (error, result) {
        prepay_id = result.xml.prepay_id[0]; // 获取预订单编号
        const paramWCPay = {
          appId: config.app_id,
          timeStamp: parseInt(new Date().getTime() / 1000).toString(),
          nonceStr: createNonceStr(),
          package: 'prepay_id=' + prepay_id,
          signType: 'MD5'
        };
        paramWCPay.paySign = getSign(paramWCPay); // 微信支付签名
        res.json({ data: paramWCPay });
      });
    } else {
      res.json({ error: -1 });
    }
  });

});

• getClientIp 是获取客户端真实 IP 地址的方法。
• createNonceStr 是生成随机串的方式，非常简单粗暴。
• out_trade_no 是商户自定义的订单号。
• getUnifiedOrderXml 是用来拼接发送给微信支付统一下单接口的数据，要 xml 格式的，所以就给一个封装。
• xml2jsparseString 是解析 xml 文件的库。微信支付统一下单接口返回的数据是 xml 格式的，需要进行相应的解码。
• getSign 是生成签名的方法。

如果不出意外，下单接口会返回一个 xml 数据，然后我们就可以提取到 prepay_id 这个核心的信息了。

/api/wxresponse 接口

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

// 处理微信支付的回调
app.post('/api/wxresponse', function (req, res) {
  wFile('response', req.body);

  let xmlData = req.body.xml;
  let ret = '';
  if (xmlData.sign === getSign(xmlData)) {
    ret = `<xml>
  <return_code><![CDATA[SUCCESS]]></return_code>
  <return_msg><![CDATA[OK]]></return_msg>
</xml>`;
  } else {
    ret = `<xml>
  <return_code><![CDATA[SIGNATRURE_ERROR]]></return_code>
  <return_msg><![CDATA[FAIL]]></return_msg>
</xml>`;
  }
  res.send(ret);

});

该接口是用来处理 notify_url 指定的回调链接的相关数据的，本次用的具体值就是 http://z.hdk4.com/api/wxresponse。

如果不对该接口做回应，微信支付会一直发请求，直至系统判定失败。

注意，使用 express 进行开发时，会收不到 req.body，采用以下方法进行解决即可：

1
2
3
4
5
6
7
8
9
10
11
12

const bodyParser = require('body-parser');
require('body-parser-xml')(bodyParser);

// 解决微信支付通知回调数据
app.use(bodyParser.xml({
  limit: '1MB',   // Reject payload bigger than 1 MB
  xmlParseOptions: {
    normalize: true,     // Trim whitespace inside text nodes
    normalizeTags: true, // Transform tags to lowercase
    explicitArray: false // Only put nodes in array if >1
  }
}));

签名算法

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

// 签名算法
function getSign(paramSign) {
  // 按 key 值的 ascii 排序
  const keys = Object.keys(paramSign).sort();
  const temp = [];
  keys.forEach(v => {
    if (paramSign[v] && v !== 'sign') {
      temp.push(`${v}=${paramSign[v]}`);
    }
  });
  temp.push(`key=${config.mch_key}`);

  const ret = temp.join('&');
  // 生成签名
  return crypto.createHash('md5').update(ret, 'utf8').digest('hex').toUpperCase();
}

非常简单粗暴的算法，嗯，如上所示。如果是其他语言，在生成 MD5 值的时候方法可能会有所不同，使用对应的方法即可。

随机字符串方法

1
2
3

function createNonceStr() {
  return Math.random().toString(36).substr(2, 15);
}

是的，这一条是滥竽充数的。

参考资料

• 获取openid
• 微信网页授权
• 微信内H5调起支付
• 签名算法
• 统一下单
• wxpay/WXPay-SDK-Node.js
• nodejs 微信公众号支付开发，大部分代码参考于此。
• 微信公众号支付开发全过程 –JAVA
• 微信公众号支付详细步骤(整理)
• Nginx向ExpressJS转发真实IP地址
• Nodejs 部署到阿里云全过程
• 利用 Express 托管静态文件
• proxy_pass

千呼万唤始出来，犹抱琵琶半遮面。

在这一天发布的日子里面，其实 gulp 一口气是出了四个版本的：

• v4.0.0-alpha.1
• v4.0.0-alpha.2
• v4.0.0-alpha.3
• v4.0.0

前面三个是打了 pre-release 的标签的。

更新记录这里就不赘述了，简单来说一下发布带来的新特性吧。

首先是 API 的变化，新增了两个非常重要的改进：gulp.parallel 和 gulp.series。这一点我之前在个人日志项目里面也进行过记录，当时的说明还是略显简陋的。

gulp.parallel 是用于执行并联任务的，相对的 gulp.series 则用于执行串联任务。

gulp 任务的处理内核由之前的 orchestrator 迁移到为 gulp 而生的 undertaker。迁移之后的处理方式更加高效便捷。支持的任务命名方式也灵活许多。

gulp.task 调整，删除之前第二个任务列表的参数，前置任务之类的全部并入到上面的两个 API 中进行处理，可以更好的控制 gulp 任务的执行顺序。

gulp.watch 改进，在 chokidar 的基础上支持各种文件操作方式的监视。

另外新增了几个 API：

• gulp.symlink 用于创建 symlinks。
• gulp.lastRun 用于获得指定任务上一次的执行时间。
• gulp.tree 用于获取当前任务的树形结构。
• gulp.registry 用于获取或者设置注册任务。

所有 API 的详细说明可以在这里找到：https://github.com/gulpjs/gulp/blob/v4.0.0/docs/API.md。

另外，对于命令行执行方式，也添加更加丰富的指令，详情可以参阅：https://github.com/gulpjs/gulp/blob/v4.0.0/docs/CLI.md

更新之后，对现有的生态系统影响不会太大，因为还是保留了 v3.9.1 的安装方式。要安装 v4，需要使用 npm install gulp@next 命令来进行安装和获取。这些也都在其 README.md 文件里面有详细说明。

鉴于发布的太过于突然，我来不及反应，也暂时没有想法要将现有系统的构建脚本升级到适配 gulp v4 的版本。

前不久在 parcel 爆发之后，自己曾经说过，gulp v4 发布遥遥无期，这还不到一个月，我就被打脸了，想想也真是如梦如幻啊。

转眼已经是 2017 年的最后一天了，是时候来好好做一个全面的总结了。

以上这段文字是抄袭自去年的总结。

今年的总结就换一个方式吧。

先做检讨

2017 年设定了许多的目标，但是很遗憾，基本上没有完成。最为痛心的是继续弃坑《圣血记》，这一部当初踌躇满志气势恢宏的小说，如今也只剩一声叹息。或许是现实生活与我的理念背道而驰，或许是自己的诸多想法不切实际过于天真，导致我没有太多的心思去创作。近期我每每念及此处，都不禁哀叹遗憾。

工作方面，没有能够稳定住现有的工作。是的，我在 11 月份的时候从上一家公司离职了。上一家公司对我很好，同事之间相处也非常融洽，领导也很是器重我。我选择离开，无论如何，都是工作不稳定的一种体现。原本自己是想打算在上一家公司静静打拼两年，积攒一些人脉，但是事实上我并没有这样去做。这也可能是促使我做出离职决定的一个重大原因吧。

生活方面，说来也甚是杯具。我依然在人生的道路上孤军奋战，我内心多么渴望能有一个人和我一起共同面对未知的旅途呀。说多了都是泪的节奏，归根结底都是因为自己自身的原因。所幸，2017 年，我到底还是学会了如何去勇敢面对。有时候内心面临崩溃，身边又孤立无援的时候，我不再像之前在杭州那般堕落消极，而是努力寻找解决方案。

挖过的坑

2017 年，我给自己是挖了很多的坑的。这里也稍作罗列，希望还能有时间和精力去填补。

1. zob 项目。该项目最初设定的是解决 MVVM 框架的问题，后来项目失败，项目的定位迁移成了代码和写作风格指导。
2. moonlight 项目。该项目原本计划是在 2017 年产出至少两个的子项目，但是很遗憾，目前只有一个半成品的小项目。
3. lui 项目。这个坑挖的太大了，导致项目直接崩盘。该项目的定位是用于解决终端之间的样式风格问题，而目前市面上的大多数 UI 库都致力于解决这个问题，并不是一朝一夕的事情。L 是法语单词 libellule 的首字母，意思为_蜻蜓_。
4. 创作系列之内心小剧场。这其实也算是一个不大不小的坑，最初的灵感来源是国庆假期的时候去见了她。一直想用一些文字来描述自己的内心世界，开设这个小项目，也是为了释放一下自己心中的情感。
5. 代码风格统一化。这也算团队协作的一个组成部分吧，然而目前只是做到了自己编码风格的统一，并没有对团队成员做统一规范要求。

有过的想法

在 2017 年有过的想法，但是一直没有去执行的事情：

1. 日历项目。记录所有重要的日期。
2. 运营一个微信公众号。
3. 收集某一垂直领域的相关资料。拟定的方向有两个，分别为养生和建筑。
4. 成为 vue.js 的贡献者。

可以将理由统一定性为懒惰，不思进取。这些事情也逐渐让我明白了一个道理：一个人的精力毕竟还是有限的。

下面来总结一下 2017 可圈可点的事情：

接手的项目

中小学装备管理系统

上一家公司拳头产品，我在其中负责前端的开发。

集中采购系统

上一家公司的另一款采购物品的管理后台产品，与装备管理系统密切相关。同样的，我也是前端主程。

数据直报系统

与上一个项目基本类似，用于学校端的数据填写上报，行管端的审批与汇总，方便管理系统进行数据的统一管理。

以上各个项目的版本因为公司的战略计划，统一都是 V9。

实验教学平台

该项目分为三个迭代阶段，我都参与了。第一个阶段为项目雏形时期，采用传统的 jQuery/Bootstrap 搭建，该阶段直接被第二个阶段替代。第二个阶段为采用 angular.js 进行搭建，我参与了主框架的搭建，并进行了路由配置以及懒加载方案的探索与实现。第三个阶段为 vue.js 阶段，此阶段为项目前端正式转型之后采用的框架，我只参与了部分主框架的搭建，之后因公司战略调整，我回到了装备开发团队。

空港出行管理后台

这便就是当前自己经手的核心项目。

与工作相关的子项目

sinput.js

一个用于列表模糊检索的 jQuery 插件。因前面提到的装备管理系统中，存在大量的模糊检索的需求，为了应对复杂的产品需求，在采用了诸多现有的插件之后，便有了这样一个子项目的诞生。主要目的是解决千奇百怪的需求。插件性能和效果表现均十分良好。

dreport-xlsx

因数据直报系统中使用到了大量的表格导入导出功能，后台人员在制作模板的过程中，需要面临大量重复冗余的操作，遂在 node-xlsx 的基础之上，为缩短人工操作的时间和避免操作失误，开发了这一款用于生成数据模板的子项目。

不过，因为离职走的匆忙，相关的代码我没有带走。

util.js

单独将此拎出来是因为该文件的定位至关重要。该项目收集并整理了部分在前端开发中使用频率非常高的工具方法。在上一家公司之后，又加入诸多方法比如重新封装 ajax 方法，表格组件的支持更加丰富，加入了部分类似与 vue 和 angular 过滤器的概念方法等等。

个人项目

htree

一款用于 node.js 环境的类似于 Linux 系统的 tree 命令的命令行工具。更多介绍可以参考之前在博客中发表的这篇文章：htree，一款模仿 tree 命令的本地文件结构查看工具。

最合拍

一款面向羽毛球运动的微信商城项目。后该项目因为迭代升级原因，我个人退出下一个版本的开发。

第五空间文学网

一款面向小说后台管理的静态页面实现。

新增的技术栈

• angular.js。开始对大型应用的 MVVM 模式做深入的了解与应用。
• jenkins 的使用，本人的日志项目中有许多记录是关于 jenkins 这一款 CI 系统的。
• gulp 构建复杂的大型应用。配合简单的 node 命令完成各种场景需求。
• node.js 编写简单基础的应用。如上面提到的 dreport-xlsx，上一条提到的 gulp 生成 config 配置文件，均采用 node 执行文件来产出。
• nginx 搭建与配置，代理纯前端站点。多文件的配置模式。
• xshell 连接远程主机进行调试。主要是操作 nginx 和查看 tomcat 的后台日志记录文件。
• webpack 技术，使用 vue 进行项目的骨架搭建。
• vue，非常优秀的前端框架，算是入了门。组件库的使用这里就不赘述了。

阅读与写作

说来惭愧，2017 年，自己的写作任务全面处于弃坑状态，所以这里就针对自己的阅读情况做一个简单的记录。

• 《圣血记》的创作，持续搁置。“她”的原型再度丢失，我失去了创作的方向。
• 购买了一些技术方面的书籍，如《代码整洁之道》、《深入理解 ES6》、《HTTP 指南》等。基本上都是下半年购买的，远远没有达到年初既定的目标（≥ 10）。
• 图书馆去的次数大概在 20 次，每次借阅的书籍数量平均为两本。也是没有能够达到最初的目标的。书籍的范围大都是技术和哲学相关的。希望 2018 年能够借阅更多类型的书籍来拓展自己的知识视野。
• 各大博客和站点，以掘金、简书、开发者头条、干货集中营、前端之巅、前端日刊等为代表，几乎推送过来的文章，跟前端和 UI 相关的都进行了阅读，并针对部分文章做了收藏与整理记录。
• 个人博客的创作，2017 年的产出量不超过 10 篇，能拿得出手的其实只有两篇，一篇是介绍 brackets 插件的，另一篇是介绍 htree 的。
• 个人日志项目，坚持了下来。虽然每天都记录了，但是个人认为有效记录的比率在 60% 左右（即有大约 30% ~ 40% 是并没有什么实际意义的记录或者是流水账式的记录）。我会抽一个时间对 2017 年写下的日志做一个整理，看看自己的技术成长路线是个什么样子的。嗯，这又算是给自己挖了一个坑。

关于音乐

截止目前为止，我在网易云音乐上面的听歌总数达到了八千多首，主要类型可以分为两类，一类是纯音乐，包括史诗、空间、纯电音、新世纪等等；另一类是柔和舒缓类型的。

自己的音乐梦想，到目前为止，已经中断将近 20 年了。说起来也甚是滑稽可笑，我其实是有条件进一步接触音乐的，但我一直没有勇气将其拎起来。我并不知道何时才能重拾年幼时的梦想，也可能一辈子都不会再捡起来了吧。

自己的歌唱水平比以前好了很多很多。以前 100% 走调的我，现在也能逐渐掐准节奏了。深情，有故事，这是我得到的最多的评价。

展望 2018

说了这么多，我其实也是在一直犹豫，对于 2018 年的规划是什么样子的，其实早在 2017 年 7 月份，我就已经做出了明确的规划。

有些事情，是不方便明说的。2017 年没有来得及完成的事情，2018 年也不会特意去处理，毕竟各有各的规划。若是刻意去完成某件事情，是否又偏离了原定计划呢？

简单粗暴的总结一下 2018 年的展望：

• 遇见更好的自己。
• 让自己内心更加平静。
• 努力提升自己的情商和魅力值。

嗯，后面两点是充数的。

知道的越多，就越发现自己不知道的其实更多。这句不是鲁迅说的，是古希腊大哲学家芝诺说的。

因此而产生恐惧，那是万万不可取的。

2018 年，加油！

不想引述大段现有的资料。

打算设立一个项目，就是针对开启高强度的模糊搜索效果的商标范围在线搜索。

为什么不提供精确的商标查询效果？说来惭愧，没有能够顺利破解 商标网 提供的 API。前天听后台开发的同事讲解了一些开放平台和网关拦截的知识，我想我是碰到了。我没有找到合适的破解方案，时间一到就告知权限失效或者查无数据了。所以，暂时先提供一个商标范围的搜索项目，名字就叫做 trademark-classification。所有数据来源来自商标网的官方数据，采集时间为 2017-10-31。

部分参考资料：

• 商标注册用商品和服务分类说明
• 中国商标网

前端的发展真是日新月异，这不，打包工具方面最近又出了一个爆款，名字叫做 parcel。本篇博客转载其 README.md，暂不做翻译。原文请移步：parcel-bundler/parcel。

Blazing fast, zero configuration web application bundler https://parceljs.org

Features

• 🚀 Blazing fast bundle times - multicore compilation, and a filesystem cache for fast rebuilds even after a restart.
• 📦 Out of the box support for JS, CSS, HTML, file assets, and more - no plugins to install.
• 🐠 Automatically transforms modules using Babel, PostCSS, and PostHTML when needed - even node_modules.
• ✂️ Zero configuration code splitting using dynamic import() statements.
• 🔥 Built in support for hot module replacement
• 🚨 Friendly error logging experience - syntax highlighted code frames help pinpoint the problem.

Getting started

1. Install with yarn:

1

yarn global add parcel-bundler

or with npm:

1

npm install -g parcel-bundler

2. Parcel can take any type of file as an entry point, but an HTML or JavaScript file is a good place to start. If you link your main JavaScript file in the HTML using a relative path, Parcel will also process it for you, and replace the reference with a URL to the output file.

1
2
3
4
5

<html>
<body>
  <script src="./index.js"></script>
</body>
</html>

3. Parcel has a development server built in, which will automatically rebuild your app as you change files and supports hot module replacement for fast development. Just point it at your entry file:

1

parcel index.html

4. Now open http://localhost:1234/ in your browser. If needed, you can also override the default port with the -p option.

See parceljs.org for more documentation!

Benchmarks

Based on a reasonably sized app, containing 1726 modules, 6.5M uncompressed. Built on a 2016 MacBook Pro with 4 physical CPUs.

Why parcel?

There are many web application bundlers out there with huge adoption, including webpack and browserify. So, why do we need another one? The main reasons are around developer experience.

Many bundlers are built around configuration and plugins, and it is not uncommon to see applications with upwards of 500 lines of configuration just to get things working. This configuration is not just tedious and time consuming, but is also hard to get right and must be duplicated for each application. Oftentimes, this can lead to sub-optimized apps shipping to production. parcel is designed to need zero configuration: just point it at the entry point of your application, and it does the right thing.

Existing bundlers are also very slow. Large applications with lots of files and many dependencies can take minutes to build, which is especially painful during development when things change all the time. File watchers can help with rebuilds, but the initial launch is often still very slow. parcel utilizes worker processes to compile your code in parallel, utilizing modern multicore processors. This results in a huge speedup for initial builds. It also has a file system cache, which saves the compiled results per file for even faster subsequent startups.

Finally, existing bundlers are built around string loaders/transforms, where the transform takes in a string, parses it, does some transformation, and generates code again. Oftentimes this ends up causing many parses and code generation runs on a single file, which is inefficient. Instead, parcel‘s transforms work on ASTs so that there is one parse, many transforms, and one code generation per file.

How it works

parcel transforms a tree of assets to a tree of bundles. Many other bundlers are fundamentally based around JavaScript assets, with other formats tacked on - for example, by default inlined as strings into JS files. parcel is file-type agnostic - it will work with any type of assets the way you’d expect, with no configuration.

parcel takes as input a single entry asset, which could be any type: a JS file, HTML, CSS, image, etc. There are various asset types defined in parcel which know how to handle specific file types. The assets are parsed, their dependencies are extracted, and they are transformed to their final compiled form. This creates a tree of assets.

Once the asset tree has been constructed, the assets are placed into a bundle tree. A bundle is created for the entry asset, and child bundles are created for dynamic imports, which cause code splitting to occur. Child bundles are also created when assets of a different type are imported, for example if you imported a CSS file from JavaScript, it would be placed into a sibling bundle to the corresponding JavaScript. If an asset is required in more than one bundle, it is hoisted up to the nearest common ancestor in the bundle tree so it is not included more than once.

After the bundle tree is constructed, each bundle is written to a file by a packager specific to the file type. The packagers know how to combine the code from each asset together into the final file that is loaded by a browser.

Community

All feedback and suggestions are welcome!

• 💬 Chat: Join us on slack.
• 📣 Stay up to date on new features and announcements on @parceljs.

License

MIT

Parcel 中文文档。不得不佩服这个网站，以飞快之速完成了对文档的翻译。当然，现在的官方文档内容其实也不多。

目前这个项目吸引了很多的开发者，诸多在 webpack 中的特性也会逐步加入进来，不出意外的话，这个是继 rollup 之后，又一个与 webpack 争天下的项目。

There are only two hard things in Computer Science: cache invalidation and naming things. – Phil Karlton

正如上面这一句经典的话语，道出了计算机领域两个最大的难题：命名与缓存。

本文就“命名”这个东西，做一个浅显的解读。

匈牙利命名法

该方法也叫做 HN 命名法，通常认为是微软的一个雇员 Charles Simonyi 发明的，通过微软的各种产品和文档资料传播开来。这位雇员是一个匈牙利（Hungarian）人，这也就是这个命名方法的名字由来。

匈牙利命名法的基本原则是：变量名依次由属性、类型、描述组成。

这里就通过举例来进行直接的说明：

1
2

int iUserName; // i 为 int 类型缩写
char cItemList; // c 为 char 类型缩写

1

var bInitLogin; // b 为 布尔值 boolean 缩写

1

dim frmInfoDetail; ' frm 为窗体 form 的缩写

驼峰命名法

驼峰命名法 camelCase，来自于 Perl 语言普遍使用的大小写混合格式，后来被 Java 广泛采用，逐渐成为更加通用的命名方法。

驼峰命名法的基本规则是变量名或者函数名是由一个或者多个单词连接在一起，构成唯一识别符，第一个单词以小写字母开始，后面的单词首字母大写，这样看起来跟驼峰一样此起彼伏，故此得名。

1

int myStudentCount;

1

fs.readFileSync

帕斯卡命名法

跟驼峰命名法类似，帕斯卡命名法 PascalCase 的不同之处在于第一个单词首字母为大写。在一些构造器命名和全局特殊变量命名的时候通常会采用这种命名方法。

鉴于跟驼峰命名法的相似，也有人将帕斯卡命名法称之为 大驼峰命名法，而上面的就称之为 小驼峰命名法。

蛇形命名法

蛇形命名法 snake_case，变量名由多个部分组成，每个部分之间使用下划线 _ 进行连接，所以也称之为 下划线命名法。

脊柱命名法

脊柱命名法 spinal-case，跟蛇形命名法类似，不过连接符为连接符 -。也称之为 kebab-case、train-case。在 URL 命名，HTML 属性、CSS 属性、Lisp 语言比较常见，所以也称之为 lisp-case。

kebab 意思是阿拉伯烤肉，与 train、spinal 一样，因为其生动的形象，跟连字符风格类似，均以此得名。

混杂大小写

Studly caps，这一种命名方法，其实我不知道该如何去翻译和描述，算是一种很非主流的命名方式。就是杂乱无章的大小写混拼方式。比如这种命名方式来命名自己的名称，可以是 StUdLyCaPs 或者 STuDLyCaPS。

总结

其实上面的种种命名方式，在语义学上面，统称为 case。这也是为什么其英文名称中大都出现了 case 这个词眼的原因。

现罗列一下常见的各种 case，每一种都是用自身的方式进行书写的。

• CamelCase
• snake_case
• kebab-case
• StUdLyCaPs

另外加上两个凑数：

• lowercase
• UPPERCASE

嗯。是的，一个是小写，一个是大写。

在如今的编码过程中，并不会总是遵循某一种规则，而是各种风格混合使用，这样也能更好的适应当前的业务场景。

首先，介绍一下 htree 这一款工具。htree 是一款用于在 node 环境下运行的工具，安装之后可以直接在 node 命令行窗口输入 htree 进行使用。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

E:\Git\xovel\htree
├─index.js
├─LICENSE
├─package.json
├─README.md
├─bin
│  └─htree
├─docs
│  └─help
├─node_modules
└─util
   ├─genText.js
   ├─getByteLength.js
   ├─getSize.js
   ├─getTextList.js
   └─walk.js

以上代码为在 htree 开发文件夹的命令行工具下执行命令 htree 生成的结果。

参数简介

htree 目前版本为 0.2.0，支持的参数如下：

ignore

忽略列表，为一个数组，包括文件和文件夹。在列表之中的值均会跳过不进行处理。

exclude

排除的文件夹。该值如果设置，应该是一个正则表达式。符合正则表达式匹配的文件夹会跳过。

maxDepth

读取文件夹的最大深度。该深度是基于当前传入的文件夹。

gap

布尔值，为真则在文件/文件夹名称前面添加一个空格。

concatLength

节点前缀和文件/文件名之间的连接符的长度。

indent

布尔值，为真则在子文件/文件夹前面添加空格作为缩进。

indentLength

上面的缩进的空格的长度。

suffix

布尔值，是否在文件夹后面添加一个后缀，默认不添加。

strSuffix

上面的后缀的文本，默认为 /。

strComment

注释标识符，类型为字符串。如果设置为非空字符串，htree 会自动计算文件/文件夹最大长度，然后再拼接 padLength 长度的空格，之后拼接 strComment 作为列表文本。非最大长度的行会使用空格进行补正对齐。

padLength

补齐 strComment 所用的空格的长度。

dir

htree 的执行主目录，默认为当前命令行窗口所在的文件夹。

folder

布尔值，为真时只读取文件夹，跳过非文件夹的部分（即普通文件）。

sort

布尔值，为真时对同级的文件/文件夹列表进行排序。通常这个设置没有什么效果，但在处理一些特殊字符开头的文件/文件夹之时会用到。默认为真。

如下划线 _ 开头的文件/文件夹默认排在后面。

size

布尔值，为真时显示文件的大小，如果 strComment未指定，则将其设置为 #。

order

对同级文件/文件夹进行归类显示的参数。为字符串 after 时，文件会被统一放在文件夹后面；为真的其他情况时，文件会统一放在文件夹前面；为假则不做任何处理。

showDir

布尔值，为真时在最开始处显示当前执行的文件夹路径。

dot

布尔值，为真时处理以点号 . 号开头的文件夹，否则跳过。

underline

布尔值，为真时处理以下划线 _ 开头的文件夹，否则跳过。

命令行参数

上面的所有设置均可以通过命令行方式进行参数指定，指定方式为小写连字符风格的字符串加上 -- 的前缀。如要指定最大文件夹访问深度 maxDepth 为 10，则使用命令：htree --max-depth 10，或者 htree --max-depth=10。

支持的短命令列表如下：

• -v，即 --version，显示当前 htree 的版本号。
• -h，即 --help，显示当前 htree 的帮助文件。
• -f，即 --folder。
• -d，即 --dir。
• -i，即 --ignore。
• -o，即 --output。
• -s，即 --show-dir。
• -m，即 --max-depth。

为布尔值的参数，可以通过前缀 --no- 设置为 false 值。

在设置 --dir、--output、--exclude、--str-comment 的值之时，必要时请对特殊字符进行转义操作。

缘起

为什么要开发这一款工具呢？其实很早以前就有过这样的想法，但是后来由于工作忙碌就搁置了。直到最近在处理一个树形结构的展示的时候，需要通过设置自定义数据来实现多级树结构的嵌套生成。这个方式与之前设想的文件夹结构展开方式类似，于是决定将这个项目正式开发出来。

经过陆陆续续的改动，对参数配置进行了较大幅度的修改，版本号目前 0.2.0。项目已经趋于稳定，想来应该是没有什么太大的改动了。

模块化

这个项目里面，算是体验了一把模块化编程。大部分功能都抽离成了模块，虽然也没多少个。

递归

在获取多级文件夹时候用到了以前上学时期学过的一个技术：递归。

原则上，没有无限极的目录深度，所以递归调用肯定会有某个结束的场景。但是我还是设定了默认的最大目录深度为 5。

npm 相关

在进行本地开发的时候，我并没有创建 node_modules 文件夹，实际开发中，也没有依赖其他的项目，而在本地连接发布 npm link 的时候会自动进行创建。这也是为什么上面的目录中会有这个文件夹而上传到 github 上面的时候由于默认机制的原因忽略了。之前进行 npm 发布的遇到过一个不大不小的问题，这一次的发布又遇到了，是的，我又设置了淘宝的国内镜像源。

遇到的问题

开发过程难免碰到一些乍看起来不可思议的问题，比如在获取 windows 磁盘根目录下的文件列表时，由于部分系统文件夹默认禁止访问，如 System Volume Information。即便是开启了管理员权限，也不能直接访问这些文件/文件夹。经过一番思考，目前采用了 try/catch 命令来避免程序报错，并退出当前操作。一些经过特意设置的文件夹如加密过的，也是不能直接读取其属性的，这就无法判断是否是文件夹了。

当然，根据提供的 ignore 和 exclude 参数，可以跳过这些文件/文件夹的访问。

另一个问题是命令行执行的时候，获取当前文件夹错误，原因是最开始的命令行文件 bin/htree 没有对执行的环境进行指定，亦即在最开始的部分并没有这样一句代码：#!/usr/bin/env node。这段代码的作用的是让程序在运行时候的运行环境变为 node，设置为这样之后在获取目录的时候调用 process.cwd() 等方法就表现正常了。

在处理字符串长度的时候，获取字符串的实际占用长度的时候存在一个不大不小的问题，部分字符会占据两个字母的长度，比如中文。由于本人当前主要是在中文环境下面工作，故此在获取字符串长度的时候直接将中文汉字和标点转成了两个字母长度的，再返回其长度，这样来保证设置了 size 或者 strComment 参数的时候，右侧的标识符能够对齐显示。

文件字节长度的计算，这里是采用下面这段代码来实现：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

function getSize(size) {
  let suffix = ['B', 'KB', 'MB', 'GB', 'TB', 'PB', 'EB', 'ZB', 'YB', 'DB', 'NB'];
  let i = 0;

  while (size >= 1000) {
    size /= 1024;
    i++;
  }

  if (i >= suffix.length) {
    return '...';
  }

  return (i === 0 ? size : size.toFixed(2)) + ' ' + suffix[i];
}

为此还特意去查阅了一下计算机中的相关单位，还是挺有意思的。

关于代码规范

htree 其实并没有遵循特定的编码规范，当前的编码风格是自己设定的一套风格，即 zob，同样的由于各种原因，该项目并没有进行公布。参考了部分谷歌的JS 编码风格以及一些当前项目常用的 ESLint 规则。

参考项目

所谓前人栽树，后人乘凉，在完成 htree 这个项目的过程中，遍寻了大量的资料。

命令行代码主要是仿照 marked 项目下的 bin/marked 来编写的。该项目也是已经长久搁置的 zmd 项目的核心参考资源。原本在实现命令行参数的读取的时候要采用某些依赖，比如 yargs 和 commander.js，但后来心想，干脆就自己尝试编写纯粹的命令行读取方法吧，就写成了现在这个样子的了。

nodejs.org 的官网上的 API 文档也提供了不少解决方案，主要是文件读取与写入方面的。

htree 项目的名字来源，看起来是 h + tree 的组合，粗看之下不会有人知道 h 代表了什么，但是我想要说的是其实这个是一个名字的谐音。嗯，是的，文本到底就结束了，希望后续能做制作一些方便使用的工具，这样也比较符合清风工具的总纲：简易、实用。

本文根据 URLSearchParams 的官方规范文档和 MDN 文档整理而成。

URLSearchParams 是一个 WEB 接口，它定义了一些方法来处理 URL 的查询字符串。

构造函数 URLSearchParams() 返回一个 URLSearchParams 对象，这个对象没有特别的属性，也不继承任何方法。

URLSearchParams 的构造实例的方法如下：

append

插入一个新的搜索参数。该方法接受两个参数，无返回值，调用形式为 URLSearchParams.append(name, value)，name 为插入搜索参数的键名，value 为对应的值。

delete

删除指定名称的所有搜索参数。接受一个参数 name 即要删除的键值名称，无返回值。

entries

不同于 Object.entries，这里的 entries 方法会返回一个 iterator，可以遍历所有键值对的对象。每一个键值对均为 USVString 对象。

• iterator 是迭代协议 Iterator 对象的实例。
• entries 方法通常在 Web Workers 中使用。
• USVString 为 unicode 标量值（unicode scalar values）。

代码示例：

1
2
3
4
5
6
7

// Create a test URLSearchParams object
var searchParams = new URLSearchParams("key1=value1&key2=value2");

// Display the key/value pairs
for(var pair of searchParams.entries()) {
   console.log(pair[0]+ ', '+ pair[1]);
}

get

获取指定搜索参数的第一个值。

getAll

获取指定搜索参数的所有值。返回一个数组。

has

判断是否存在指定的搜索参数。

keys

返回 iterator 对象，包含了键/值对的所有键名。其他说明与上面的 entries 一样。

set

设置指定搜索参数对应的值。接受的参数跟 append 中的一样，如果存在多个搜索参数对应的值，则删除其他所有值。

sort

按键名排序。排序规则为按键名的 unicode 码点，该规则是稳定排序，对相等的键值的相对顺序不做变更。

toString

返回一个字符串，由所有搜索参数组成的字符串，可以直接用在 URL 上。

values

返回 iterator 对象，包含了键/值对的所有值。其他说明与上面的 entries 和 keys 一样。

forEach

扩展方法，提供接近于数组 forEach 的遍历方式，但它并不是一个数组，也不是一个类数组。

1

searchParams.forEach((...args)=>console.log(args))

上面的代码中，args 依次为键名、值、对应的 searchParam。

参考资料：

• URL Standard
• URLSearchParams - Web APIs | MDN
• URL | Node.js v8.4.0 Documentation
• Can I use - Feature: URLSearchParams

原本没有想要做这样一篇文章，但是契机到了，一方面是因为自己最近从事的工作是教育方面的，对于一些教育方面的认知不够；另一个方面的原因是自己在意的一些人和事近期的动态都在表明，是时候好好了解一下古今中外相关教育界的代表人物了。

那么，我们就开始吧。

孔子

作为有着 至圣 之称的儒家学派创始人，孔子在每一个中国人心中的印象都不可磨灭，我们从丫丫学语开始就在接触着孔子的教诲。

孔子在教育界领域也是鼎鼎大名，这主要体现在下面四个方面：

1. 《论语》。由孔子弟子及后人编纂的这一部《论语》是四书五经中的代表，是孔子与其子弟对话的浓缩精炼。诸多脍炙人口的名句至今读来仍然是掷地有声，发生深省。
2. “有教无类”、“不愤不启不悱不发”、“学而不思则罔，思而不学则殆”的教育思想。
3. 在教学原则方面崇尚启发性教学和因材施教。
4. 探索出典型的教学过程：学 - 思 - 行。

孔子对教育的认知在当时是极为先明的，其创立的儒学思想对中国和世界都有着深远的影响。

孟子

“亚圣”孟轲，中国另一位伟大的思想家、教育家，儒家学派代表人物，与孔子并称“孔孟”。

在《孟子·尽心上》，“教育”一词被最早提及。推崇的教育理念是内发论，认为教育的目的与 17 世纪提出的“个人本位论”如出一辙。

内发论，强调人的身心发展的力量主要源于人自身的内在需要，身心发展的顺序是由身心成熟机制决定的。

个人本位论，主张以个人为本位，根据个人发展的需要确定教育目的和进行教育的一种理论。

孟子认为人性本善，万物皆备于我心，是仁义礼智四性的根源，人只要善于修身养性，向内寻求，这些品质就能得到发展。

孟子学派崇尚的教学过程总结起来是：博学之、审问之、明辨之、慎思之、笃行之。

朱熹

程朱理学代表人物，南宋著名的理学家、思想家、哲学家、教育家、诗人，有“朱子”之称。朱熹的理学思想对元、明、清三朝影响很大，成为三朝的官方哲学，是中国教育史上继孔子后的又一人。

朱熹是最早使用“课程”这个词语的人，有“宽着期限，紧着课程”的理念。朱熹长期从事讲学活动，《四书集注》为其精心编撰的教材，该书也被明清两代列为科举考试的内容。

朱熹认为 8~15 岁为小学教育阶段，主要任务是培养“圣贤坯璞”；15 岁以后为大学教育，其任务是在“坯璞”的基础上再加“光饰”，把他们培养成国家所需要的人才。这种见解为中国古代教育思想增添了一些光鲜。

苏格拉底

苏格拉底是古希腊著名的思想家、哲学家、教学家、公民陪审员，与其学生柏拉图，以及柏拉图的学生亚里士多德并称“古希腊三贤”，是公认的西方哲学的奠基者。

在教学方法上，苏格拉底总结出了一套独特的方法，人们称之为“苏格拉底方法”，但他本人则称之为“产婆术”（一作助产术）。苏格拉底把教师比喻为“知识的产婆”，这一教育理论是西方最早的启发式教育，本文上面提到的孔子则是中国最早提出启发式教育的教育家（不愤不启，不悱不发）。

苏格拉底方法是以师生问答的形式进行，所有又称之为“问答法”。教师在教学生获得某种概念时，不是直接把这种概念告诉学生，而是先向学生提问，让学生回答；如果学生回答错了，不进行纠正而是提出另外的问题引导学生思考，从而一步一步得出正确的结论，这为启发式教育奠定了基础。直到今天，问答法仍然是一种重要的教学方法。

柏拉图

柏拉图是古希腊伟大的哲学家、教育家，西方客观唯心主义哲学的创始人，是苏格拉底的学生，其创造的柏拉图思想、柏拉图主义、柏拉图式爱情对后世影响深远。

柏拉图是西方教育史上第一个提出完整的学前教育思想并建立了完整的教育体系的人。

柏拉图主张唯心教学，认为人的一切知识都是由天赋而来，教学的目的是为了恢复人的固有知识，教学过程即是回忆理念的过程。柏拉图反对强制灌输知识，提倡通过问答形式，提出问题揭露矛盾，然后进行分析、归纳、综合、判断，最后得出结论。

《理想国》（一作《共和国》）是柏拉图重要的对话体著作，包括哲学、伦理、教育、文艺、政治等内容。在这本对话录中，柏拉图以苏格拉底之口通过与其他人对话的方式设计了一个真善美相统一的政体，即可以达到公正的理想国。

昆体良

古罗马时期著名的律师、教育家，是教育史上发展和完善教育方法和思想的先驱。

昆体良主张对儿童的教育应是鼓励的，能激发他们的兴趣，并认为教学质量的关键在于教师，重视学生记忆能力的培养，提倡因材施教。

昆体良的教育理论和实践都以培养雄辩家为宗旨。在他退休后，著述了《雄辩术原理》（即《论演说家的教育》），这部著作是他自己约二十年教育工作的经验总结，是古希腊、古罗马教育经验的集大成者，也是西方最早的教学方法论著。

夸美纽斯

17 世纪捷克伟大的民主主义教育家，西方近代教育理论的奠基者，被称为“近代教育之父”。

夸美纽斯受到人文主义的深刻影响，主张通过教育使人获得和谐发展，并通过教育改良社会，实现教派和民族的平等。夸美纽斯是最早的公共教育的拥护者，这中理念在其著作《大教学论》中有提出，该书也是近代第一本系统的教育学著作。

夸美纽斯在教育史上的另一个重要的贡献是最早从理论上详细阐述了班级授课制以及相关的学年制、学日制、考查、考试制度，是最早提出“班主任”概念的教育家。

夸美纽斯主张义务教育和泛智教育，“把一切知识教给一切人”，在当时的历史条件下，打破了封建主义的禁锢，加速了社会的发展。

夸美纽斯还提出了许多教育原则，如直观性原则、启发诱导原则、量力性原则、循序渐进原则、巩固性原则、因材施教原则等等。

赫尔巴特

19 世纪德国哲学家、心理学家、教育家，是科学教育学的奠基人，“教育科学之父”。

反映其教育思想的代表作《普通教育学》是公认的第一部具有科学体系的教育学著作，这本书也使得教育学开始成为一门独立的科学。

赫尔巴特明确提出教育学的科学性问题，“教育学作为一种科学，是以实践哲学和心理学为基础的。前者说明教育的目的，后者说明教育的途径、手段与障碍。”

赫尔巴特主张的教育原则为教学的教育性，明确指出“不存在‘无教学的教育’这个概念，正如发过来，我不承认有任何‘无教育的教学’”，“德育问题是不能同整个教育分离开来的，而是同其他教育问题必然地、广泛深远地联系在一起的”，这极大的推进了教育理论的发展。

赫尔巴特将教学过程分为四个阶段：清楚、联想、系统、方法。

杜威

美国哲学家、教育家，实用主义的集大成者。

杜威从实用主义经验论和机能心理学出发，批判了传统的学校教育，并就教育本质提出了“教育即生活”和“学校即社会”的观点。杜威认为，教育过程在它的自身意外无目的，教育的目的就在教育的过程之中。

教学论方面，杜威提倡“从做中学”。从“思维五步”出发，杜威认为教学过程也相应的分为五步：

• 教师给儿童提供一个与社会生活经验相关联的情境；
• 使儿童有准备去应付在情境中产生的问题；
• 使儿童产生对解决问题的思考和假设；
• 儿童自己对解决问题的假设加以整理和排列；
• 儿童通过应用来校验这些假设。

思维五步：疑难的情境、确定疑难所在、提出解决疑难的各种假设、对这些假设进行推断、验证或者修改假设。

舒尔茨

首先，这个人更多的身份应该是经济学家。当然，他并不是星巴克的创始人，他是获得 1979 年诺贝尔经济学奖的一位经济哲学家西奥多·舒尔茨。

西奥多·舒尔茨提出的“人力资本理论”对当代教育影响很深，并在美国第 73 届经济学年会上的演讲“人力资本投资”中证明了教育对经济发展的巨大贡献。

舒尔茨的人力资本理论主要观点有两个：人力资本的积累是社会经济增长的源泉和教育也是使个人收入的社会分配趋于平等的因素。

舒尔茨论述到教育对个人收入的影响：

• 工资的差别主要是由所受的教育的差别引起的，教育可以提高收入的能力。
• 教育水平的提高会使因教育不同而产生的相对收入差别趋于减缓。
• 人力资本投资的增加还可以使物力资本投资和财产收入趋于下降。

行文到此，本文就算是完结了，没有什么要特别进行说明的。嗯，就是这样。这十个名单我也忘记了从哪里看到的了。看到的时候做了一个记录，但是上面的资料很简陋，我重新查阅了网络上的一些资料，并进行一番整理，于是就有了这一篇文章。

本文主要参考自 2ality 的文章：ECMAScript 2017 (ES8): the final feature set。部分章节会有修改，加入自己的一些理解与观点。阅读本文需要有一定的 ES 基础。

官方公告：Standard ECMA-262。

主要特性

异步函数

ES6 发布的时候，引入了 Promise 来处理异步操作，一个常见的 Async 函数如下：

1
2
3
4
5
6
7
8
9
10
11
12

function fetchJson(url) {
  return fetch(url)
  .then(request => request.text())
  .then(text => {
  return JSON.parse(text);
  })
  .catch(error => {
  console.log(`ERROR: ${error.stack}`);
  });
}
fetchJson('http://example.com/some_file.json')
.then(obj => console.log(obj));

现在，使用 ES2017 中新增的关键字 async 和 await，我们可以实现以看起来像是同步的代码来处理异步的操作。如上面的代码可以写成：

1
2
3
4
5
6
7
8
9
10

async function fetchData(url) {
  try {
  let request = await fetch(url);
  let text = await request.text();
  return JSON.parse(text);
  }
  catch (err) {
  console.log(`Error: ${err.stack}`);
  }
}

异步函数还有一些变体，罗列如下：

• 异步函数声明：async function foo() {}
• 异步函数表达式：const foo = async function () {};
• 异步方法定义：let obj = {async foo () {}};
• 异步箭头函数：const foo = async () => {};

更多资料可参阅：tc39/ecmascript-asyncawait: Async/await for ECMAScript，Simplifying asynchronous computations via generators (section in “Exploring ES6”)

共享内存和原子

共享内存 shared memory 主要是处理并行事件对于资源调用的一种机制。

该功能引入一个新的低级别 Atomics 命名空间对象和一个 Shared Array Buffer 构造函数来作为高级别并发抽象的原始构建块。这样可以使得开发人员可以使用多个 service worker 和核心线程之间的 Shared Array Buffer 对象的数据。通过这种方式，可以更轻松的在 worker 之间进行数据共享，改善它们之间的协调性。

• tc39/ecmascript_sharedmem: Shared memory and atomics for ECMAscript
• ES proposal: Shared memory and atomics

次要更新

Object.values/Object.entries

对象为键值对的数据结构时，每一个键值对都是一个 entry。Object.entries 提供将对象转换为其可枚举的每一个对象的集合的方法。而 Object.values 提取出对象中可枚举的字符串键值属性的所有值。

Object.values 跟 Object.keys 功能类似。

举个例子，有一个这样的对象：foo = {a: 1, b: 2, c: 3};，上面提到的三个方法的结果分别为：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

> foo = {a:1,b:2,c:3}
< Object {a: 1, b: 2, c: 3}
> Object.values(foo)
< (3) [1, 2, 3]
> Object.keys(foo)
< (3) ["a", "b", "c"]
> Object.entries(foo)
< (3) [Array(2), Array(2), Array(2)]0: Array(2)1: Array(2)2: Array(2)length: 3__proto__: Array(0)

------
> Object.entries({ one: 1, two: 2 })
[ [ 'one', 1 ], [ 'two', 2 ] ]

> Object.entries({ [Symbol()]: 123, foo: 'abc' });
[ [ 'foo', 'abc' ] ]

• ES proposal: Object.entries() and Object.values()
• Object.values/Object.entries

字符串填充

针对 String 对象，引入了 String Padding 的规范，为字符串的处理添加了两个字符串填充的方法：padStart 和 padEnd。

String.prototype.padStart

字符串的头部填充。接收两个参数 String.prototype.padStart(maxLength, fillString=' ')，第一个参数为填充的最大长度，第二个参数为指定填充的字符串。

假设我们有一个这样的操作：s.padStart(n, f)，s 为待填充的字符串，n 为填充后的长度，f 为填充的字符串。如果 f 的长度不够 n，则会重复使用，直到填充的长度达到了 n。如果 s 本身的长度已经超过 n 则不会进行填充。

String.prototype.padEnd

跟上面的方法类似，填充的位置在后面，其他处理方式一致。

• ECMAScript spec proposal for String.prototype.{padStart,padEnd}

Object.getOwnPropertyDescriptors

该方法是 Object.getOwnPropertyDescriptor 的复数形式：

1
2
3
4
5
6
7

function getOwnPropertyDescriptors(obj) {
  const result = {};
  for (let key of Reflect.ownKeys(obj)) {
    result[key] = Object.getOwnPropertyDescriptor(obj, key);
  }
  return result;
}

旨在简化对象复制的过程，它允许装饰器能够轻松的从另一个类或对象中提取出所有描述符，并将它们分配给一个新的对象。

由于 Object.assign 方法不够完美，这个是用一种吞噬行为的方式复制对象，也就是依然会出现键值覆盖的情形。

配合 Object.create 可以实现一个对象的深拷贝：

1

const clone = obj => Object.create(Object.getPrototypeOf(obj), Object.getOwnPropertyDescriptors(obj));

更多 Object.getOwnPropertyDescriptor 的使用场景可以参阅：ES proposal: Object.getOwnPropertyDescriptors()。

函数的拖尾逗号

以前的函数在参数定义时或者调用时，不允许出现拖尾逗号，如下面的代码：

1
2
3
4
5
6
7
8

function foo(
  bar,
  baz,
) { ... }
foo(
  param1,
  param2,
);

在之前的版本中是错误的，但是新规范中，这可以的，拖尾逗号将被忽略，如同数组和对象字面量中的拖尾逗号。

拓展阅读

• The final feature set of ECMAScript 2016 (ES7)
• tc39/proposals - Active proposals

npm install本身有一个别名，即npm i，可以使用这种缩写方式来运行命令，打到简化的效果。

以下为指定的一些命令行参数的缩写方式：

-g

--global，缩写为-g，表示安装包时，视作全局的包。安装之后的包将位于系统预设的目录之下，一般来说

-S

--save，缩写为-S，表示安装的包将写入package.json里面的dependencies。

-D

--save-dev，缩写为-D，表示将安装的包将写入packege.json里面的devDependencies。

-O

--save-optional缩写为-O，表示将安装的包将写入packege.json里面的optionalDependencies。

-E

--save-exact缩写为-E，表示安装的包的版本是精确指定的。

-B

--save-bundle缩写为-B，表示将安装的包将写入packege.json里面的bundleDependencies。

https://docs.npmjs.com/cli/install，参考来源。

好吧，这篇算作是滥竽充数，六月计划提前开始吧。做一个有内涵的技术写作者是得有多大的勇气呢？

阅读本文需要一定的jQuery基础。

在函数组件中，angular提供了许多方便使用的功能，下面我将按照官方文档的顺序一一做介绍。

angular.forEach

遍历数组或对象。功能类似jQuery.each。不同的是angular.forEach支持传入一个上下文作为第三个参数：angular.forEach(obj, iterator, [context]);。

angular.extend

扩展对象。功能类似jQuery.extend，不过这里是个浅复制。

angular.merge

合并对象，深度合并，可以视为深复制。

angular.noop

空操作，即：function () {}。

angular.identity

返回第一个参数本身，用于函数式编程。

angular.isUndefined

判断参数是否为undefined。

angular.isDefined

判断参数是否被定义过，与angular.isUndefined的结果相反。

angular.isObject

判断参数是否为对象。

不同于typeof，null将被视为非对象，数组视为对象。

angular.isString

判断参数是否为字符串。

angular.isNumber

判断参数是否为数组，包括NaN、+Infinity以及-Infinity。

angular.isDate

判断参数是否是一个日期对象。

angular.isArray

Array.isArray的别名，判断是否为数组。

angular.isFunction

判断是否为函数。

angular.isElement

判断是否为DOM元素或者jQuery元素。

angular.copy

复制对象或数组，深复制。

angular.equals

判断两个参数是否相等。

符合以下条件之一的均视为相等：

• 通过严格等于===的判断
• 对象的类型一样并且其所有属性通过angular.equals判断均相等
• 两者均为NaN
• 两者为正则表达式，并且其表达式相等

angular.bind

对函数进行绑定对象。angular.bind的参数形式类似函数的call方法。

通常用于偏函数和柯里化。

angular.toJson

转为JSON风格的字符串。这个过程可以称之为序列化。

angular.fromJson

将一个JSON字符串还原，即反序列化。

angular.bootstrap

手动启动AngularJS的应用程序。

angular.reloadWithDebugInfo

以调试模式重载当前的应用程序。

angular.injector

注入器的声明与使用。详情可参阅：dependency injection

angular.element

以jQuery风格包裹DOM元素或者HTML String。如果未引入jQuery，则采用angular自带的jqLite简化版。jqLite提供常见的jQuery API，可以满足大部分的情况。

angular.module

angular的核心，用于声明或者获取模块。

angular.errorHandlingConfig

错误处理的配置。

至此，angular自带的函数组件就梳理完毕了。更多详细的介绍，就请诸君自行查阅相关文档了。

接下来的空余时间里面，将会逐步针对angular里面的知识点做一个全面的介绍。

通常来说，本系列博文对应的angular的版本为1.6.x+。

部分函数，诸如angular.lowercase，angular.uppercase已经被废弃，故此这里也不再列出。