运营公众号已经两年多时间了，之前时间还好，原创不少，大家也都挺愿意看的。但最近我观察发现，我的公众号「进击的 Coder」呈现出几个不健康的状态：

• 总体阅读下滑

• 粉丝粘性下滑

• 粉丝数量下滑

其实根本原因还是原创变少了，当然还有其他的影响因素一起导致了这样的情况。

原创是公众号的至关重要的一部分，是公众号的血液，没有原创内容的文章是很难脱颖而出的，粉丝关注关注的其实就是能从中获取一些独到的价值。

但由于最近一段时间原创文章确实少，都在转载一些文章，和其他技术公众号大同小异，都是转来转去的，久而久之，读者就觉得没什么意思，取关什么的那就是自然而然的了。

那为什么原创变少了呢？总结下来有这么几点原因：

• 我工作比较忙，现在处于项目的关键阶段，项目周期比较赶，确实写原创文章的时间变少了。

• 由于最近半年和一年写的文章都是爬虫书的一部分，所以不好提前发出来，所以这就导致了公众号的原创文章变得很少。

• 最近我也开了一个新的公众号「崔庆才丨静觅」，当时就是想在这个小号上简单记录自己的一些想法的，所以在这个小号上写了一些原创，但由于我当时太基于追求小号的质量和增长了，所以不论是技术文章还是个人感悟都发到小号上，「进击的 Coder」就直接转载这个小号上的文章，所以一些原创被分流了。

当然除了原创变少，还有几个导致目前不健康状态的原因：

• 由于最近我大多为转载的文章，所以读者的一些留言询问一些问题我可能不了解细节，那就可能回答比较浅或者干脆放出来不予回答，跟读者的互动越来越少。

• 公众号生态的变化，公众号生态早已一片红海，越来越多的创作者都加入公众号，都在竞争流量，转载和广告大量出现，导致读者现在对公众号的打开率越来越低，不论是单个还是总体。

• 微信公号本身的推荐算法应该也有一定的作用，比如原创文章的权重相比之前我感觉更高了，反而转载过多的文章权重比例进一步下滑。

嗯，基本上就是这样的现状，导致了公号出现了不健康的状态。

经过一些思考和跟小伙伴的讨论，我们得到了一些思考，决定后面转变一下运营思路，大致总结下：

• 依然坚持原创是根本，唯有原创才是公众号经久不衰的秘诀，所以以后会继续坚持原创，当然由于本人时间原因，每周每个号 1-2 篇应该算是一个小目标，也就是两个号「进击的Coder」和「崔庆才丨静觅」两个号每周会发 2-4 篇原创文章。

• 关于原创我们也在联系一些渠道，比如如果大家有不错的原创文章，也欢迎前来本公众号投稿。

• 之前为了每天都发文章，可能着急忙慌地找几篇就转了，质量并不高，最后导致阅读也不好，给读者提供的价值也不够，所以调整了一下策略——非必要不发文。也就是说，如果今天确实没有什么好发的，那就不要制造信息垃圾了。要发就发一些有价值的，高质量的，所以会更加严格控制公号的文章质量。

• 区分好「进击的 Coder」和「崔庆才丨静觅」两个号的定位，之前我对两个公号的定位并不清晰，甚至有一段时间不论技术文章还是个人感悟都发到「崔庆才丨静觅」上面，「进击的 Coder」一直是转载文章，这样会导致「进击的 Coder」出现上述我说的不健康的状态。所以后面，「进击的 Coder」会侧重于发技术文章，也就是说我平时写的有关技术的所有文章都会放到这个号上面来，包括网络爬虫、技术总结、工具推荐、Web、AI、小知识点等等。「崔庆才丨静觅」更加私人一点，就会发我日常的一些感悟，比如我的工作感想、我的生活状态、我的碎碎念、我的读书笔记等等。如果大家感兴趣的话可以关注下。

• 增加和读者的互动，之前的一些留言，跟读者的互动性不好，后面会注意多增加一些互动和交流，增加读者粘性。

• 不定期搞一点小互动，比如送一些小礼品、书等等。

PS：当然毫不避讳地说，由于我也需要公号来获取一些收入，所以有时候公号也会接一些广告的，但是我也会控制好广告的频率和质量，广告也都是一些技术课程类的，大家如果感兴趣希望如果也可以支持下，感激不尽！

就是这样啦，如果大家还想到什么好的点子也欢迎告诉我哈。我还是非常希望我能够通过两个公众号为大家提供更好的内容和价值的。

Fighting！

更多精彩内容，请关注我的公众号「进击的 Coder」和「崔庆才丨静觅」。

这件事是前几天发生的，端午假期我出去参加同学婚礼，假期最后一天我坐高铁回北京。

高铁上，一个小男孩子在说话比较大声，而且看起来比较调皮，敲了小桌板几下，发出了一些声响。然后他爸爸就很生气，应该是呵斥了他几句，然后那个孩子就哭了起来。

其实哭得还挺大声的，一直哭了好几分钟，如果一般情况下，听到孩子哭其实是很让人心烦的，但是这次发生的事情让我唯一的感觉却是替孩子感到惋惜和同情。

那个孩子中间说了好几次：“爸爸，是我做的不对吗？”

爸爸一开始没搭理，孩子问了好几次之后，他爸爸就回答：“别说话，你看别人都不说话，你也不要说话啊。”

孩子应该是听到并不是自己想要的答案，然后就接着问：“爸爸，是我做的让你感到失望了吗？”

爸爸还是那句话：“别说话，安静一点。”

然后孩子还在继续问：“爸爸，我不想让你生气和失望，爸爸是我那里做的不对呢？”

爸爸依然还在说：“别说话，你看别人都不说话，你也不要说话。”

卧槽，听到这里我真的感觉这爸爸怎么这样啊！

后面反复了几句，爸爸依然就是那个回复，后来孩子也不再问了，也就不说话了，火车上又安静了起来。

但我内心还是久久不能平静，直到现在想起来真的想说孩子爸爸几句，真的我感觉这件事让我真的很同情这个孩子，而且对爸爸这种态度感到非常的愤怒，怎么能这么培养和教育孩子呢？

孩子在成长的过程中，尤其在这个阶段，他对整个世界没有很好的认知，不知道自己做的事情是不是对的，而且对世界充满了好奇，所以他遇到自己不明白的事情的时候，非常迫切需要得到一个答案和反馈，如果这时候家长可以给予好的引导，对孩子的成长简直太重要了。

而且更让我感到惋惜的是，这个孩子真的算很懂事了，他已经可以说出“爸爸，是我做的让你感到失望了吗？我不想让你生气和失望。”这样的话了，孩子都能表达自己的感受和想法，这真的已经非常好了。

但是他爸爸的回答简直太让人失望和生气了，他非但没有正面回答孩子的所有问题，而且一直在命令孩子不要讲话，完全没有一点正向的反馈，跟孩子好好说说不好吗？

比如就说，宝贝我没有生气和失望，就是刚才的你声音比较大，会影响到其他的乘客，我们要做一个好的孩子，在火车上不要大声讲话以免影响他人，以后我们火车上安静一些，这样就更好了。首先能够正面回答孩子的疑问，然后通过一些正向的激励来帮助孩子了解一些知识和让他认识到应该做的事情，这样不好吗？这孩子听了之后，一方面就知道自己做的是不是对的，应该怎么做才能更好，因为这个孩子本身已经很懂事了，他也想成为一个好的孩子，知道了哪些是对的，我相信这个孩子后面会注意的。而且经过这些事，孩子也能明白一些道理，这是从生活中学到的，对孩子特别重要。

虽然我没有孩子啊，但站一个旁观者的角度，真的觉得家长应该提供一个更好的引导和教育，这样孩子才能更好地成长。

更多精彩内容，请关注我的公众号「进击的 Coder」和「崔庆才丨静觅」。

今天比较忙，等到写这篇文章的时候已经第二天了，但是还是不得不写写，因为杜兰特这场天王山之战的表现是在是太牛逼了！

我平时是看 NBA 的，是杜兰特的死忠粉，喜欢杜兰特有十年了，从高中的时候经常听到同学议论 NBA，说雷霆队有个叫杜兰特的很厉害，跟着看了几场球，后来就成了杜兰特的球迷。

我也习惯称杜兰特为阿杜、KD，所以后面文章我就叫阿杜了，感觉比较亲切。

当然现在我也是毫无疑问的的篮网球迷，因为阿杜去哪个球队我就支持哪个球队。从雷霆到勇士到篮网，他也经历过低谷、经历过高光，勇士的两连冠真的发自内心为他感到高兴，但前年他遭遇了跟腱断裂大伤，我也一直在关注各种消息期盼他能王者归来。

这个赛季，终于盼来了阿杜的复出，我特别希望他能回到当时巅峰的状态，希望跟腱的伤势对他的影响尽量是最小的，但也免不了的每场比赛都会担心他的跟腱伤势会不会复发。尤其是到了现在的季后赛，对抗强度上升，更是每场都在祈祷阿杜不要受伤。

幸运的是，这个赛季没有再看到阿杜的跟腱伤势有任何复发迹象，当然他也在尽力保护自己，比如落地的时候会用摔倒的方式缓冲一下力量。每多看一场，我对阿杜跟腱的恢复情况就会越乐观一些，应该算是彻底好了吧，谢天谢地。

扯远了，今天我来就是专门来说说今天阿杜的超神表现的。

可以说，今天的表现，任何华丽的词藻都不足以表达阿杜的牛逼了，简直就是天神下凡！打满全场 48 分钟，一分钟都没有休息，23 投 16 中，砍下 49 分 + 17 篮板 + 10 助攻的超级三双，外加 3 抢断 2 盖帽，率领篮网在一度落后 17 分的情况下、在两大巨星队友都遭遇伤病的情况下、在众多队友都失准的情况下，带领球队完成惊天大翻盘赢下雄鹿，最后一节真的是把我都看哭了，太悲壮了！

关注这场比赛的朋友都知道这场比赛对阿杜来说意味着什么，本来篮网的形势一片大好，但是和雄鹿的系列赛第一场哈登就因为腿筋伤势退场，第四场欧文又被字母歌垫脚无法出战。虽然说哈登今天出战了，但是状态远不及正常水准。上半场一开场就大比分落后，这时候靠的就只有阿杜了。最后的结果大家也都知道了，阿杜天神下凡般的表现把这场比赛硬生生拿下了！把字母哥彻底打服了，把众多对阿杜一直持怀疑态度的群众打服了，把国内第一杜黑徐静雨打服了。我愿称这场比赛就是阿杜彻底的封神之战，是迄今为止阿杜职业生涯最牛逼的一场比赛，没有之一。

先说说徐静雨吧，他是网上一个比较知名的说球的。客观来讲，他确实对一些比赛或者球员的分析有自己的独到见解，这方面我是认可他的。他是库里球迷，一说到库里那就可劲吹，但经过观察，我发现他是阿杜的黑粉，可能是因为阿杜抢了库里两个 FMVP 的原因吧，一直耿耿于怀，然后一个劲说 MVP 比 FMVP 含金量大多了，反正就是库里有的就可劲吹，没有的就可劲贬。一听到他说阿杜不好的我就来气，甚至连 CJ 单换阿杜的话都说出来，就觉得他真是一个无脑黑子，中间我还把他拉黑了一段时间。但最近发现，徐静雨的口风发生了变化，一方面的原因可能是库里没有进季后赛，另一方面却是也是阿杜打出的表现的确让人心服口服，身体条件也观察到愈发硬朗，攻防两端的表现的确是非常超群。今天我专门去看了徐静雨怎么说，一进去就看到几个大字「全力杜已超全力詹」，好家伙，这是彻底被阿杜打服了，视频中他也对阿杜各种赞誉，被阿杜的表现深深折服，甚至都已经说全力杜已经超过 12 年全力詹这样的话了，全网第一杜黑被打服了。

然后说说我心里的感受吧，其实徐静雨说的一番话我也是认同的，就是阿杜需要一个契机来证明自己的超群价值。这时候有人可能就说了，阿杜的能力还需要证明吗？其实在我看来，需要的。

• 首先在雷霆时期，阿杜的表现足够牛逼了，尤其 13-14 赛季已经证明了自己单核带队的能力，并勇夺得常规赛 MVP，但这毕竟是常规赛。

• 在雷霆最后一个赛季，阿杜在跟勇士的鏖战中最后被翻盘，最后阿杜就加入了勇士，这也成了阿杜一生中的一个巨大的黑点，网上一众黑子各种骂。当然我不认为这是黑点哈，我觉得阿杜去到更好的地方，先实现自己的冠军梦就好，他做的决定我是完全支持的。

• 阿杜在勇士夺得了两个冠军，但是在很多人看来，这两个冠军似乎都太简单了，毕竟勇士这个球队本身就太强大了，银河战舰级别的配置，所以外界都觉得这两个冠军没有什么含金量，也在质疑阿杜要是单核带队是不行的。

• 阿杜的内心是很敏感的，他也很在意外界对自己的看法，想要赢得外界的尊重。所以他离开勇士的一个原因就有想再证明自己的价值。

• 篮网今年阵容经过一番操作机会变得非常豪华了，阿杜、哈登、欧文，篮网整个阵容可以说都能比得上 17-19 赛季的勇士了，阿杜伤停一段时间，哈登又带队打出逆天表现，于是又有人开始质疑阿杜的带队能力，说阿杜单核带队不行，只能作为一个强力终结点，不能很好地带动队友。

综合以上几点，加上现在特殊的情况，三巨头除了阿杜其他两个都伤了，而且篮网刚刚经历了从 2-0 到 2-2 点局面，被雄鹿连扳两盘，而且上一场欧文刚刚伤了，不论是阵容上还是士气上，篮网都处于很大的劣势。而天王山之战的重要性不言而喻，此时篮网能依靠的就只有阿杜了。

所以如果这一场，阿杜能够爆发并带领球队获胜，就是对自己非常非常好的证明，这是天时造就的机会，证明自己的时候到了！

不负众望，阿杜天神下凡般的表现大家也看到了，不管是进攻终结还是防守盖帽，攻防两端打出来了统治级表现。另外阿杜不仅仅作为一个终结点，还送出了 10 次助攻，不光得分还能串联球队，就是以往的阿杜和哈登的超强结合体，攻防、串联，所有的所有都做到淋漓尽致。另外阿杜对胜利的渴望也是到了极致，打满了全场 48 分钟，一个个无解中投，一次次突破上篮，还有最后的压哨三分，死神镰刀挥舞起来，彻彻底底的统治级表现，这就是一场封神之战，打破所有的质疑，赢得了足够的尊重。所以这也是我愿意把他称之为阿杜生涯最牛逼的比赛，没有之一。

最后，希望篮网全员能够恢复健康，继续向前征战。

篮网总冠军！阿杜 FMVP！

更多精彩内容，请关注我的公众号「进击的 Coder」和「崔庆才丨静觅」。

大家知道我平时会写一些文章，有的朋友也会经常问我：你是用的什么软件写作的？用什么软件管理这些文章的？

我之前其实有介绍过我正在使用的支持跨平台写作的解决方案，是基于苹果的 iCloud Drive 来实现的。

首先我是非常喜欢用 Markdown 来写内容的。在电脑上，我可以用文本编辑器 Typora，工作空间都是在 iCloud Drive 上，写完之后就会自动同步，然后我在手机上是用了另外一款软件叫做 Blockquote，也能直接打开 iCloud Drive 的文件，手机上也可以编辑 Markdown 文件。

手机上的软件类似这样子：

但是呢，说实话手机上的这款软件我觉得并没有那么好用，但主要因为他能直接打开原生的 md 文件，而且没有那么花里胡哨的功能，所以当时就选它了。

但这几天由于我出门了，不方便带电脑，所以有时候就想用手机来写，平时我大多数都是用电脑比较多，这次改成手机直接用 Blockquote 还觉得有些不习惯，逐渐感到有些乏力。

于是就想着看看有没有更好用的替代品。

基本需求

我先说一下我的基本的需求：

• 第一点呢就是我必须要做到跨平台的同步，因为我有好多台设备，在不同的时间在不同的设备上工作，比如上班时间在公司的 iMac 上，下班了在家里的 iMac 上，周末又会带着 Macbook Pro 出去，路上又在用 iPhone，偶尔还会用用 iPad。在这个过程中我想要随时随地把一些东西记录下来，所以我想要实现无缝的协作切换和高效率的实时同步。所以，我的所有的文本和笔记都必须要是跨平台协同同步的，这个是一个最基本的要求。由于我使用的是苹果全家桶，所以说我之前基于 iCloud Drive 就可以很轻松的实现这所有的功能，然后不同平台上用不同的编辑器来编辑就行了。

• 第二点我想要保留原生态，即文本的平台无关性。我想编辑的内容是实实在在存在的一个 md 后缀的纯文本文件，好多 md 文件就放在一个文件夹下，也有对应的放图片的文件夹，以便于我随时随地能够把一个 md 文件分享出去或者切到另外的软件打开，甚至加到 Git 中保存起来。比如说我之前调研过「熊掌记」，它对 Markdown 支持挺好的，但是当我想获取原始的 Markdown 文件树的时候，发现「熊掌记」已经把它做到平台里面了，我是很难获取整个的 md 文件夹的，所以我就没法用 Git 来管理我所有的 md 文件了。

基于这两点，之前的方案是能实现的，但是手机上的 Markdown 编辑软件我实在觉得乏力。

所以我也在反思，为什么我一定要执着于原生的 md 文件的编辑呢？我思考了一下，我真正想要的就是第一点——跨平台的同步，是不是我在编辑一个真实的 md 文件不重要，如果我用的平台能够支持导入 md，支持导出 md，那不就好了吗？甚至版本控制我也不用做了，如果一个笔记软件能支持版本控制那我直接用不就好了吗？想到这里，觉得之前似乎走到坑里去了，现在其实很多的厂商都已经提供了这样的解决方案，比如说印象笔记、有道云笔记、还有 Notion 等等。各种各样的笔记软件，其实都已经做到全平台的支持和跨平台的同步了。

Notion

经过一番勘查，我找到了 Notion。经过这么几年的发展，Notion 的功能也变得越来越强大了。而且它对 Markdown 也有一定的支持，虽然说它的语法并不是完完全全的 Markdown，但一些特色功能的确很能打动人心。

首先 Notion 的设计思路就挺好的 —— 万物皆是 Block，即一个块。比如一段文本、一张图片、一个视频、一段代码，只不过 Block 有自己的类型，每个 Block 就像一个个小组件，最终组合成了一篇文章。有了 Block 的设计，一些实现上的灵活性就更高了。要添加新的功能只需要加新的 Block 就好了。

另外 Notion 的功能还是很强的，因为 Block 的加持，所以文档不仅仅可以是文档，又可以是一个项目管理图、一个课程表、一个思维导图、一个计划表等等，All in One！

但不能光说好啊，对于不好的地方，我也进行了一番查阅，Notion 有什么不好的呢？其中很多人反馈的就是它的服务器在国外，所以说一些加载延迟比较高，网络同步效率一般。另外一个反馈就是 Notion 对于中文的支持不好，现在我看到 Notion 只支持了韩文还有英文，然后据小道消息，中文的支持。还在计划和测试中，但是不确定什么时候正式上线。还有就是 Notion 因为是一款国际化软件，所以对国内生态支持不好，比如微信登录、国内手机号登录等等。

反正这些问题还是蛮受诟病的。

遇见 wolai

然后找着找着，我就又发现了另外一款软件。叫做我来 wolai，就基本上是一个国内版的 Notion。

wolai 这名字的确有点奇怪啊，但这影响不大，重要的还是功能。

我一开始对这个软件其实还是持有怀疑态度的，因为我总觉得国内的一些公司可能作为刚初创的公司，它的这个质量的把控可能并不是很好，或者是说服务不稳定。另外可能用着用着这个公司就跑路了，倒闭了，这也是有可能的。

但怎么说呢？我个人试用了一下这一款软件，整个我觉得还是挺符合我的需求的。虽然说它是对标了国外的 Notion 所有的一些功能键。和 Notion 非常的相似。但我觉得只要做到好这个软件好用。能够满足我的需求。那他不妨成为我的一个候选。

我还专门去查了一下这个公司的创始人以及他们做事情的一些态度理念。

看了之后，发现 wolai 其实才上线了一年的时间，但功能已经相对完善了，我觉得现在的功能点做的还算不错了。

wolai 的创始人叫马锐拉，知乎主页是：https://www.zhihu.com/people/marila。

他们做 wolai 的初衷是这样说的：

最初开始做 wolai ，出于一个非常简单的原因——作为一个管理者，面对当时公司中几十个互相割裂的内部系统、平台，我往往需要通过拼凑信息碎片并手动构建关联，才能完成信息的追溯与重组。循环往复、极为低效地搜寻信息需要耗费巨大的心力，更别说一群人通过这样的方式来进行协作，可想而知是多么痛苦。而一些相对简单的部门内部协作流程，和协作本身，也没有很好地系统可以承载、实现，最后都变成一个个微信群。每个人都要在忍受无数“信息噪音”的同时，随时留意与自己真正相关的聊天内容。我们都被绑架在工作群聊中。凡此种种，让我觉得信息必然有更好的组织方式，大量日常协作流程也不应该依赖于在群聊中共享信息流。我开始意识到，我们缺少一个真正解决这些问题的工具。

他们对 wolai 的定位是这样的：

1. 可以更好地组织信息，不论是组织方式还是交互体验；

2. 可以让每个人都能自由构建流程与应用，满足团队日常工作所需；

3. 可以进行更好的分享与协作；

4. 不能是一个呆板严肃的被老板逼着用的办公软件；

5. 团队或企业可以完成日常 80% 以上的协作，让 Office 回归专业软件，让微信回归即时通讯……

到今天为止，已经累计发布了将近 900 个版本，平均一天发布近 3 次，优化、迭代、完善了无数产品功能；也有了 Windows 、Mac 、Linux 、iOS 、Android 全平台客户端；建立了云服务的空间计划体系，夯实了云端协作平台的基础……终于也算变成了一个有模有样的产品。

卧槽，牛逼，能一年搞得这样，真的很佩服了，尤其还支持 Linux！

而且这个界面设计感，我觉得很不错！

其实我本来想好好介绍一下这个软件的，但是我感觉我自己写了之后，和原来官方写的文章其实也大差不差。而且我感觉人家的这篇文章写的也挺好的。

所以大家可以直接来看看原介绍文章吧：https://zhuanlan.zhihu.com/p/379723832。

功能

我就简单说几个让我觉得眼前一亮的功能吧。

界面

大家可以发现，我每次介绍软件都要先评论一下界面，就简单放个官方的图吧：

文章支持 Markdown 绝大多数语法，而且文章上面可以放头图，而且还有专门的 icon，五颜六色的 tag 支持，整个风格是 Material 风格设计，一些边距、图标让人感觉很舒服。

他们自己也说了：

在调性上，区别于千篇一律使用蓝色为主色调的企业应用，我们反其道而行，以暖色为主色调。去除矩形的锋利棱角，用圆润的边角体现 wolai “专业却不失温度”的企业文化和产品理念。

一些文章可以灵活分类组织，每个分类还有单独的图标，井然有序，给单调的列表增加了几分活力有木有！

我爱了。

看看我这篇文章就用 wolai 写的，就看这个图标设计吧，左上角可以选一个图标，支持 Emoji，各种颜色的扁平图标，甚至是动态日历，比如这就是个动态日历：

同时设置完了之后还能显示在文章标题前面，这细节到位了！

全平台同步

另外很重要的当然就是这个全平台的同步了，我看了一下，它支持 Mac、Windows、Android、iPad、iPhone 各种各样的平台，尤其还支持 Linux！这个一上来就把这个好感度拉满了。

而且 Mac 也专门为 M1 芯片做了适配。

很妙！

导入导出

另外我测试了一下，它支持 Markdown 的导入和导出功能，也就是说，只要我有一个 md 的文件，那我可以立马将它转到这个平台里面去，同时他还支持 pdf、md 文件的导出。

这不算什么，我比较欣赏的是 wolai 的一个批量导入的功能，也就是说我可以把我之前所有的 md 文件，然后直接压缩成一个 zip 包。一键上传，wolai 可以解析然后转换，然后所有的文章就导入进来了，牛逼！

编辑历史

还有一个比较特色的功能是它可以保留每一个 Block 的修改历史，那也就是说如果我们想要回滚一些版本的话，是可以非常方便的查看的。这就类似于他比较好地集成了 Git 版本控制工具，但这个功能得高级版才能支持。

情怀

还有个加分项，就是整个团队他对一些细节的把控，甚至可以称作一种情怀。

比如吧，说他们为了呈现团队成员列表，自己还开发了自己的头像小程序，而且甚至还开发了一个头像创作系统，自己捏自己的脸，放一个对比图吧：

卧槽，右边那个我感触太深了，我实在是看不下去哪些乱七八糟的图像混杂排布的效果。wolai 这真的牛逼了！我看到之后太舒服了！

而且这些头像不是死的！这是他们的头像制作小程序，自己可以给自己捏脸，如图所示：

这个我觉得做的确实很有情怀了。

还有一个，为了将传统文化瑰宝融入 wolai ，他们还与故宫博物院取得联系，并获得文物图片的使用授权。只有在 wolai ，我和你才能….使用故宫文物作为页面题头图。

卧槽，情怀拉满了！

细节

另外再说个细节吧，就是这个中英文的混合排版。

我其实对于排版是非常严格的，就是我如果看到一个中文和一个英文单词之间没有一定的间距的话，会觉得很难受。

所以说在公众号排版的时候，中英文中间我都会留一个间距，比如说就中英文之间加一个空格。

不同于 Notion，wolai 它对中英文的排版支持的这个细节把控就做得很到位。比如说我这里敲一个中文和英文，那它会自动的在这两个之间加一个空白，如图所示：

这个真的是很细节了！感动。

有一点需要说明，wolai 在中英文之间插入的间隔并非实际空格，只是样式上的限定。一旦将文字复制或者导出为本地文件，却是没有空格的。

最后

现在我已经用起来了，它可以支持多个工作空间，比如我这里就创建了三个，「进击的 Coder」可以作为团队型的空间，可以支持多人协作。另外还有两个空间就专门留给我，一个用来写技术，一个用来写生活，如图所示：

再告诉大家个好消息吧，我在写这篇文章的时候，使用的是 wolai 的个人免费版，它的 Block 数量是有限制的，最多是 5000 个，也就是说，按照一篇文章 100 个 Block 来算，那写 50 篇文章就没 Block 数量了，那就得收费了。

但是！！！从 2021 年 6 月 15 日开始！也就是 wolai 一周年到来之际，个人免费版开始不再限制块儿的数量了，那也就是说我们不管写多少文章，那都不会有限制了！

我当时看到这个消息的时候，看了下日期，6 月 14 日，哦？幸福来得也太突然了吧！

这次我真的不是为这个软件专门打广告的，确实是真心的推荐。

我现在也不能完全承诺，以后我就一定会在这个平台上来管理我的所有的文档。因为我刚开始用，可能还得适应一段时间，要是中途遇到什么 bug 也会看看开发团队的解决问题的态度。

我也不能承诺这软件一定是你中意的，但至少我看到的这个软件提供的一些功能点是我想要的。各个方面是很契合我的需求，而且里面的一些细节确实让我感动满满。

我也不能承诺这个团队以后会不会因为各种原因停止运营和开发这个软件。但我相信，能做出这个产品的团队，能把细节把控到这个地位的团队，也一定不会差了。

最后大家如果想试用看看，可以扫个码注册下：

希望对大家有帮助～

更多精彩内容，请关注我的公众号「进击的 Coder」和「崔庆才丨静觅」。

昨天（准确说是前天了），鸿蒙 2.0 发布了，当时没来得及看，睡觉之前看了看回放，说实话这次的更新发布的确让我眼前一亮，甚至自己还有点小心动。因为我现在用的苹果全家桶，所以之前一直对安卓并不太关注，但发布会看到鸿蒙现在建立起的生态还有一些互联的体验，着实让我惊叹一把。甚至我心里都有一点想把自己现有的小米之家的一套以后换成华为全屋智能。

别说，还真有可能哈哈。

扯远了，说回正题。

发布会上宣布了一个消息，那就是现有的很多华为手机都可以开始升级鸿蒙系统，所以一个明显的感觉就是花粉们都开始纷纷尝鲜，从朋友圈就能看得出来大家的期待和热情。

然而，还有一些声音又开始热闹起来了，一些人又开始问了，甚至喷起来了——鸿蒙系统 2.0 到底是不是基于安卓？鸿蒙真无耻，明明基于安卓，还把安卓的名字抹掉叫做鸿蒙。看了这些问题和评论，我心里说有点嗤之以鼻吧又觉得太极端，我就单纯觉得争论这个真的挺无聊的，争论这个有什么意义呢？

看完这篇文章，你可能就更了解我为什么这么说了。

一些渊源

因为众所周知的一些原因，美丽国开始打压华为，断供芯片等关键元器件，而且华为不能再使用谷歌的移动服务。

断供芯片就不说了，说说后者。

谷歌移动服务有一个简称，就是 GMS，英文是 Google Mobile Service，比如 Gmail、Google Play 等等都属于其中。华为不能使用 GMS，这对华为的海外市场可谓是一个巨大的打击。我们国内没法用谷歌的服务自然大家也习以为常了，所以这个变化对国内市场影响不大。然而华为主要消费群体不会局限于国内，国外也是一个非常重要的市场。GMS 之于国外用户就像微信之于国内用户，华为手机没法用 GMS，也就没法用 Google Play，没了 Google Play，那就连应用都没法好好地装了。有人会说，那我把 Google Play 等 App 的 apk 下载下来安装不就好了吗？不行的，没有 GMS，那就相当于就得不到 Google 的认证，所以即使是把 Google Play 的 apk 下载下来也是没法用的。所以，所有 GMS 的生态都没法用了，尤其对于那些已经重度依赖 GMS 的国外用户来说，对买不买华为手机是有非常大的顾虑的。

在去年的第一季度，华为的手机销量在全球是位居第一的，然而今年第一季度，华为的全球手机销量已经跌至第六，被三星、苹果、小米、OPPO、VIVO 赶超了，第五的 VIVO 是 10%，而华为今年第一季度已经跌到 4% 了。

嗯当然对于这种情形，华为也有自己的应对措施了。比如华为打造了 Huawei Mobile Service，即 HMS，但显然这个相比 GMS 还是有很多不成熟的地方，或者让用户从 GMS 迁移到 HMS，也一定是有很多顾虑和成本的。

万般艰难之下，一个重磅消息就诞生了，那就是鸿蒙操作系统的宣布！还记不记得华为宣布鸿蒙的那一天，朋友圈、微博炒的是那么火热，连国家的各个媒体号都在疯狂宣发。为什么？因为当时宣称，这是我们中国人的操作系统！

哇，你就想象吧，那种大国自豪感，虽然说网友们平时天天在网上喷来喷去的，但是鸿蒙宣布的那一天，每个人都怀着一种大国自豪感，显得是那么团结。

后来一段时间，鸿蒙宣布开放源代码，当时记得有一段时间华为在挤牙膏，放出来了一些源码，当时一些热心网友研究之后就炸锅了，这开发工具怎么和 Android Studio 这么像啊？然后开始从 SDK 或者各处去扒安卓的影子，争先恐后去当第一个扒出安卓蛛丝马迹的人。然后一些套壳安卓的声音就不绝于耳了，骂声变得此起彼伏。我当时其实没有太关注这些，也没去深究这些，但当时给我的感觉就是，某些人就开始揪着套壳安卓这个事不放下，喷来喷去。

当时我的态度其实比较坦然，因为我也算懂些安卓，深知从 0 开发出一套安卓系统是一件多么难的事，安卓这发展了十几年才发展成这样子。如果从 0 开始造一个操作系统，即使抛开开发成本，其生态的建立也是极其漫长的过程，如果真有了，而市面上大多数软件都不兼容，微信都没法跑，大批大批的软件运行不了，那谁还会去用呢？几乎是必死的一条路了。所以当时鸿蒙发布会宣布兼容安卓应用的那个时候，我就觉得底层肯定和安卓脱不了干系了，内核肯定基于 Linux，至于多么像，那就得看把安卓改到哪个地步了。

是否基于安卓

好，那下面就来说说，鸿蒙到底是不是基于安卓。

要回答这个问题，我们得首先知道，安卓究竟是什么，要说安卓，就不得不先说一个名字，叫做 AOSP。

AOSP，就是 Android Open Source Project 的简称，翻译过来就是安卓开源项目，官网是 https://source.android.com/。

官网长这样：

AOSP 是开源的，主要是谷歌贡献的，当然其他的厂商也贡献了，比如华为、三星，甚至千千万万普通开发者。

那么 AOSP 和我们常说的安卓有什么关系呢？简单来说，安卓是谷歌在 AOSP 的基础上增加了 GMS（前文提到了），AOSP 是开源的，GMS 是闭源的，二者结合起来就成了现在的安卓系统，最纯正最原生的安卓系统大家可以到谷歌官方下载个 Android Studio 开个虚拟机体验下，现在已经发布到 11 了，网址是：https://developer.android.com/。

OK，但是我们平常用的一些手机的系统和原生安卓也还是有些许不同的，比如小米的 MIUI、三星 OneUI、OPPO 的 ColorOS，锤子的 Smartisan OS，这些都是基于 AOSP 开发的 ROM，而且用也上了 GMS，虽然国内因为某些原因没法用，但它也是有的，况且它们也没有像华为一样被禁。另外小米等公司也大大方方承认这是基于 Android 的，所以你可以看到小米手机的系统里面就写着，MIUI 什么版本，安卓内核什么版本。

OK，那鸿蒙呢？因为安卓 = AOSP + GMS，而 GMS 已经被禁了啊，那何必还称自己基于安卓呢？是吧，那就叫鸿蒙。

是的，就是这样。

所以，AOSP，它是开源的，谷歌放弃了它的所有权。AOSP 人人都能用，人人都能基于它开发。可以认为，AOSP 是安卓和鸿蒙的妈，安卓和鸿蒙是 AOSP 的孩子，只不过不同一个时间段，安卓在 AOSP 基础上多了个 GMS，而鸿蒙没有。

很多人就是像通过 AOSP、安卓、鸿蒙之间的关系想努力证明安卓和鸿蒙是一样的，鸿蒙是套壳安卓的，何必呢？

而且，我们必须要承认，华为的鸿蒙基于 AOSP 做了很多修改，基于鸿蒙的一些设计战略，分布式互联系统的出发点，少不了底层的一些修改和优化。至于难度怎么样？小米、锤子人家都能做成这样，对于华为这么大的公司来说，还会难吗？

而且我相信，将来鸿蒙虽然基于 AOSP 改，但未来也会离 AOSP 越来越远，甚至慢慢面目全非都有可能。

鸿蒙的核心优势

但其实我想说的重点不是上面的内容，不是为鸿蒙和安卓的区分做一个辩驳，因为我认为这是没有意义的。

因为真正有意义的点在于，我们应该关注华为借着鸿蒙，怎样发挥了公司的本身优势，建立了怎样一个基于鸿蒙的巨大生态。

华为不会纠结于到底是不是真正自己从 0 开始实现一个系统，这真的没有意义。华为是站在 AOSP 的基础上，想着怎么把自己的优势发挥出来，怎么将无法使用 GMS 的损失降低，怎么建立一套新的生态体系，怎样重新让华为的市场振作起来，甚至还可以证明，我们中国做的系统也一样可以引起一些可以称之为颠覆性的浪潮。

OK，大家相比也看到了发布会的一些演示了，我觉得华为有一个点做得非常好，那就是充分发挥了自己公司的优势。

华为是什么公司？是一家通信公司，通信技术在世界都是名列前茅，而且华为也一直在着眼于打造物联网全屋智能。

所以，这些碰撞在一起，将鸿蒙定位成一个分布式智能终端操作系统，这就一下子把鸿蒙的局限性从安卓手机这个层面抬高了，格局就不一样了。

华为很聪明，鸿蒙一下子被抬升到这个高度，那自然把名字也扩展到其他的设备上吧。

• 比如说，华为家的智能手表，其实本来说智能也智能，但没个很正式的名字，那就叫鸿蒙！

• 比如说，智能家电里面的芯片吧，其实就是个嵌入式的设备，很多厂商都能做啊，智能饮水机、智能燃气灶，智能加湿器，小米家不也做得挺好的吗，也能通过 App 控制，但你说小米家的智能加湿器里面运行的系统叫啥名？说不上来。但华为就不一样了，鸿蒙的定位上来了，格局上来了，那我们就叫它鸿蒙系统啊，名字嘛，就是个叫法而已。

好家伙，这名字一改，那我岂不是就可以对外宣称说，我们鸿蒙系统可以运行在手表，运行在所有的智能 IoT 设备上了，鸿蒙一下子逼格又提升了一个档次，不但格局上来了，技术也显得更牛逼了。鸿蒙还能兼容这么多平台，一听就牛逼吧。

所以，我还是很佩服华为的这个思路的，高！实在是高！

但光有战略不够啊，那得实打实做出点东西才行对吧。

有，这个必须有！而且正好撞枪口上了，通信和物联网，就是华为的优势点所在。

在鸿蒙基础上，华为配合上自家的通信技术的加持，将设备联动做得尽善尽美，基于超级终端这个定义，将所有的设备联系在一起。

• 比如说，手机和大屏 Pad 的联动，华为把手机在 Pad 的镜像和操作做到了极低的延迟和极高的流畅度，同时加上软件的一些优化，实现数据的共享。

• 比如说，手机和耳机和电视的联动，通过手机作为中枢，将视频流、音频流的传输和同步做到了极致，实现了无缝的转接体验。

• 比如说，华为手机、无人机组成的多机位拍摄，将硬件和软件之间的关系解耦，每个终端都能自由选择连接的硬件，这其中也是需要非常强的通信技术。

这就是把自己最牛逼的技术正好最大化地发挥出来了啊！

鸿蒙发布会上提到了两个核心技术：

• 软时钟同步
• 抗干扰算法

软时钟同步是通信行业非常重要的技术指标，另外基于 5G 的时钟同步更为重要，该项技术能极大地影响通话体验、音视频的同步效果。华为通信出身，又是 5G 引领者，搞这个自然不在话下了。之于抗干扰算法，不必多说，这属于无线通信的范畴，将自己的技术应用到鸿蒙也是顺理成章了。

所以，最后大家可以看到，华为借着鸿蒙，把自家最牛逼的技术实现了完美的落地，打造了物联网生态，又带动了自家全屋智能家居的发展，拉高了鸿蒙的布局，又证明了鸿蒙的确能行，还能顺便给国家注入一剂强心剂！一举多得。

这才是鸿蒙真正的优势所在。

这才是鸿蒙真正的战略所在。

这才是鸿蒙对消费者、对技术发展、对国家、乃至对世界的意义。

Oh，这时候你再跟我说，鸿蒙是套壳安卓，你看看我还理你嘛？

今天看到一个消息，说微信 PC 版最新版本可以刷朋友圈了，还加了许多新功能，简直喜大普奔，我赶紧装来试试。

不过可能让大家觉得稍有遗憾的是，现在发布的只支持 Mac 版，而且处在内测阶段，Windows 版的后续才会发布。

别问我怎么搞到的，看完这篇文章你也能立马获取。

装完之后，打开微信就提示了最新版本的更新界面：

这是 Mac 上的重大更新：

• 可以刷朋友圈了
• 看视频号的视频和直播了
• 可以支持深色模式了

就是主要这么几大更新，我们来一起看看。

首先就是深色模式，这个简直太舒服了，现在很多 Mac 软件都已经适配了深色模式，唯独微信迟迟没有更新，这下终于有了！

我把 Mac 调整到深色主题，然后微信就会跟着变化了。

深色模式是这个样子的：

很完美，以后深夜再也不用面对那明晃晃的白色聊天窗口了。

接下来就是朋友圈，在侧栏出现了这样的小图标：

一点就会弹出一个新的窗口，而不是呈现在右侧，窗口是张这个样子的：

在右上角有刷新按钮和消息按钮，消息按钮点击之后同样以浮窗的形式呈现：

另外朋友圈点赞和评论的操作基本上和手机上是一样的：

小视频播放也不在话下：

嗯，整体感觉还是不错的，以后朋友圈就可以在电脑上看了。

接下来就是视频号，测试了一下转发了一个视频号的内容，显示是这样的：

然后还是以弹窗的形式呈现：

不过只有转发的操作，没法点赞和评论。

然后就是直播，转发的直播在聊天中是这样的：

点开之后显示是这样的：

这个是我的视频号哈，就简单开了一下直播，照的是家里的房顶，没啥实质性的东西，就仅做测试哈。

整体体验下来感觉这个更新还是很给力的，尤其对我有用的就是看朋友圈的功能了。

但是稍微有点遗憾的是，还不支持发朋友圈的功能，希望微信能快快支持。

最后，如果你也想体验一下，请在本公号回复“微信最新版”获取下载地址，大家晚安！

背景

有时候我会碰到快速搭建测试服务的需求，比如像这样：

搭建一个 HTTP Service，这个服务器可以 run 在本地，也需要公网可以访问，请求该服务可以得到一组自定义的 JSON 数据。不为别的，就为临时快速做点测试用。

这时候我想要以最短的速度完成，比如一分钟就写出来，这时候可以怎么做？

比如大家可能想到了，跑个 Flask 或者 FastAPI，把示例代码改改，然后 Python 一个命令就跑起来了。

比如代码像这样：

1
2
3
4
5
6
7
8

from typing import Optional
from fastapi import FastAPI

app = FastAPI()

@app.get("/")
def read_root():
    return {"Hello": "World"}

然后我用命令跑起来：

1

uvicorn main:app --reload

OK，说好的自定义 JSON 就已经完成了。

可是我要加需求了，我要支持跨域访问，怎么做？这时候我可能又要去搜 FastAPI cors 关键字，然后找到 https://fastapi.tiangolo.com/tutorial/cors/ 文档，然后加上类似这样的一些配置：

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

from fastapi.middleware.cors import CORSMiddleware

app = FastAPI()

origins = [
    "http://localhost.tiangolo.com",
    "https://localhost.tiangolo.com",
    "http://localhost",
    "http://localhost:8080",
]

app.add_middleware(
    CORSMiddleware,
    allow_origins=origins,
    allow_credentials=True,
    allow_methods=["*"],
    allow_headers=["*"],
)
...

也还行对吧。

那现在我又改需求了，我要返回一张图片怎么办？我要返回一个文件怎么办？我要 HTTPS 访问怎么办？

甚至说，我代码写的不熟怎么办？为了搞这个 API Service 我得花大半个小时，太得不偿失了吧。

毕竟大家都挺忙的。

所以我会想，这些简单的事，为啥要写代码解决啊？难道没有工具通过一些可视化配置来完成吗？

如果你也有这个痛点，请继续向下看。

如果你没有，既然来都来了，客官继续看看嘛…

解决方案

所以现在我的需求是：我想通过一个便捷的工具快速搭建一个 API Server，能配置返回 JSON 或者图片或者文件等等，甚至说动态路由、动态转发等等功能，如果这些步骤还能通过可视化图形界面来搞定就更好了。

来了，今天就给大家推荐一个工具，叫做 Mockoon。

Mockoon 是一个可以通过图形化界面帮我们快速搭建 API 服务的工具，支持数据模拟、路由解析、跨域访问、HTTPS、自定义延时、Docker 等等各种你想要的功能，同时支持支持 Windows、Mac、Linux，页面整体是这样子的：

这布局，和 PostMan 有异曲同工之妙啊。

比如左侧我们可以配置一个个请求列表，点进去可以在右侧配置详情，比如配置是 GET 还是 POST 请求，path 是什么，Response Body 是什么，Response Headers 是什么，另外还有一些规则和基础设置。

另外在最上面我可以配置运行的 host 和 port，然后左上角还有一个运行按钮，一点就相当于启动了 Server 了，启动之后按钮就会变成红色，再按一下就会停止，比如这里我就配置了运行在本地 3894 端口：

然后我修改下 Body：

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

{
  "data": [
    {
      "id": 1,
      "name": "Picture3",
      "url": "https://cdn.cuiqingcai.com/l4ol8.jpg"
    },
    {
      "id": 2,
      "name": "Picture2",
      "url": "https://cdn.cuiqingcai.com/zy2w3.jpg"
    },
    {
      "id": 3,
      "name": "Picture1",
      "url": "https://cdn.cuiqingcai.com/v10oo.jpg"
    }
  ]
}

这里我返回一个 JSON 格式的列表，包含了三个字段。

然后接下来我要配置跨域访问，就加一个 Response Header：

1

Access-Control-Allow-Origin: '*'

然后点击左上角的运行按钮就成了。

Mockoon 还提供了快捷访问的功能，接着点右上角的打开按钮：

浏览器就打开了，然后数据就看到了：

咔咔咔，就这样，我们通过非常简单的可视化配置就完成了 API Server 的搭建，熟练的话一分钟就完成了。

另外还有太多功能，比如 HTTPS、多请求处理、日志、路由、模板配置这里就不再一一叙述了，用到的时候查文档就好啦：

• Cors：https://mockoon.com/docs/latest/cors/
• HTTPS：https://mockoon.com/docs/latest/https/
• Import/Export Data：https://mockoon.com/docs/latest/import-export-data/
• Mutiple Response: https://mockoon.com/docs/latest/multiple-responses/
• Proxy Mode: https://mockoon.com/docs/latest/proxy-mode/
• Request logging: https://mockoon.com/docs/latest/requests-logging/
• Response Headers: https://mockoon.com/docs/latest/response-headers/
• Routing: https://mockoon.com/docs/latest/routing/
• Templating: https://mockoon.com/docs/latest/templating/

另外 Mockoon 还支持命令行，比如通过 mockoon-cli 就可以快速创建一个 API Server，如图所示：

命令行的使用和安装可以参考：https://github.com/mockoon/cli#installation

以上便是这个工具的简单介绍，更多功能等待你的探索！

在这里介绍一个工具，使用它我们可以非常方便地使用 Python 下载 Youtube 的视频，叫做 pytube。

利用它我们可以实现如下功能：

• 支持 progresive 和 DASH 视频流的下载
• 支持下载完整的播放列表
• 可以处理下载进行中和下载完成的回调
• 提供命令行直接执行下载
• 支持下载字幕
• 支持将字幕输出为 srt 格式
• 获取视频缩略图

下面我们就来详细了解一下它的使用方法。

安装

首先看下安装过程，安装非常简单，只需要使用 pip3 安装即可，命令如下：

1

pip3 install pytube

或者直接源码安装也行：

1

pip3 install git+https://github.com/pytube/pytube

安装完成之后就可以使用 pytube 命令了。

使用

这里先介绍两个最常见的用法，那就是直接使用 pytube 命令，它可以用来下载单个 Yotube 视频或者视频列表。

比如这是一个视频 https://youtube.com/watch?v=2lAe1cqCOXo，截图如下：

我们可以直接使用命令下载：

1

pytube https://www.youtube.com/watch?v=2lAe1cqCOXo

很快视频就能被下载下来了：

1
2
3

Loading video...
YouTube Rewind 2019 For the Record  YouTubeRewind.mp4 | 83 MB
 ↳ |█████████                                   | 21.4%

同样地，pytube 还能下载播放列表，比如这是一个播放列表 https://www.youtube.com/playlist?list=PLS1QulWo1RIaJECMeUT4LFwJ-ghgoSH6n，截图如下：

使用 pytube 同样可以轻松下载：

1

pytube https://www.youtube.com/playlist?list=PLS1QulWo1RIaJECMeUT4LFwJ-ghgoSH6n

它可以解析播放列表，然后一个个下载下来：

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

Loading playlist...
Python Tutorial for Beginners 1 - Getting Started and Installing Python (For Absolute Beginners).mp4 | 63 MB
 ↳ |████████████████████████████████████████████| 100.0%
Python Tutorial for Beginners 2 - Numbers and Math in Python.mp4 | 11 MB
 ↳ |████████████████████████████████████████████| 100.0%
Python Tutorial for Beginners 3 - Variables and Inputs.mp4 | 15 MB
 ↳ |████████████████████████████████████████████| 100.0%
Python Tutorial for Beginners 4 - Built-in Modules and Functions.mp4 | 16 MB
 ↳ |████████████████████████████████████████████| 100.0%
Python Tutorial for Beginners 5 - Save and Run Python files py.mp4 | 37 MB
 ↳ |████████████████████████████████████████████| 100.0%
Python Tutorial for Beginners 6 - Strings.mp4 | 78 MB
 ↳ |███████████████████████████████████         | 79.6%

当然除了默认的命令配置，还可以支持查看 list，查看字幕，筛选语言等等，具体的命令如下：

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

usage: pytube [-h] [--version] [--itag ITAG] [-r RESOLUTION] [-l] [-v]
              [--logfile LOGFILE] [--build-playback-report] [-c CAPTION_CODE]
              [-lc] [-t TARGET] [-a [AUDIO]] [-f [FFMPEG]]
              [url]

Command line application to download youtube videos.

positional arguments:
  url                   The YouTube /watch or /playlist url

optional arguments:
  -h, --help            show this help message and exit
  --version             show program's version number and exit
  --itag ITAG           The itag for the desired stream
  -r RESOLUTION, --resolution RESOLUTION
                        The resolution for the desired stream
  -l, --list            The list option causes pytube cli to return a list of
                        streams available to download
  -v, --verbose         Verbosity level, use up to 4 to increase logging -vvvv
  --logfile LOGFILE     logging debug and error messages into a log file
  --build-playback-report
                        Save the html and js to disk
  -c CAPTION_CODE, --caption-code CAPTION_CODE
                        Download srt captions for given language code. Prints
                        available language codes if no argument given
  -lc, --list-captions  List available caption codes for a video
  -t TARGET, --target TARGET
                        The output directory for the downloaded stream.
                        Default is current working directory
  -a [AUDIO], --audio [AUDIO]
                        Download the audio for a given URL at the highest
                        bitrate availableDefaults to mp4 format if none is
                        specified
  -f [FFMPEG], --ffmpeg [FFMPEG]
                        Downloads the audio and video stream for resolution
                        providedIf no resolution is provided, downloads the
                        best resolutionRuns the command line program ffmpeg to
                        combine the audio and video

更多详细的说明可以参考官方文档：https://python-pytube.readthedocs.io/en/latest/user/cli.html

代码使用

当然除了这些，pytube 还支持以 Python 编程的方式来进行下载，同时提供了便捷的链式操作，比如这段代码：

1
2
3
4
5
6
7
8
9

>>> from pytube import YouTube
>>> YouTube('https://youtu.be/2lAe1cqCOXo').streams.first().download()
>>> yt = YouTube('http://youtube.com/watch?v=2lAe1cqCOXo')
>>> yt.streams
... .filter(progressive=True, file_extension='mp4')
... .order_by('resolution')
... .desc()
... .first()
... .download()

这里大家可以看到，要使用 pytube，只需要导入其中的 Youtube 这个类，然后传入 URL 声明 Youtube 对象就好了。接着我们可以直接调用其 streams 方法获取所有的视频源，然后可以通过 first 或者 filter 或者 order 等进行排序或筛选等处理，然后最后调用 download 方法就可以执行下载了。

下面我们来剖析一下具体是怎么回事。

首先我们来声明一下 YouTube 对象：

1
2
3
4

>>> from pytube import YouTube
>>> yt = YouTube('https://youtu.be/2lAe1cqCOXo')
>>> yt
<pytube.__main__.YouTube object at 0x7f88901e9890>

然后看看 streams 是什么：

1
2
3
4

>>> yt.streams
[<Stream: itag="18" mime_type="video/mp4" res="360p" fps="24fps" vcodec="avc1.42001E" acodec="mp4a.40.2" progressive="True" type="video">, <Stream: itag="22" mime_type="video/mp4" res="720p" fps="24fps" vcodec="avc1.64001F" acodec="mp4a.40.2" progressive="True" type="video">, <Stream: itag="137" mime_type="video/mp4" res="1080p" fps="24fps" vcodec="avc1.640028" progressive="False" type="video">, <Stream: itag="248" mime_type="video/webm" res="1080p" fps="24fps" vcodec="vp9" progressive="False" type="video">, <Stream: itag="399" mime_type="video/mp4" res="1080p" fps="24fps" vcodec="av01.0.08M.08" progressive="False" type="video">, <Stream: itag="136" mime_type="video/mp4" res="720p" fps="24fps" vcodec="avc1.4d401f" progressive="False" type="video">, <Stream: itag="247" mime_type="video/webm" res="720p" fps="24fps" vcodec="vp9" progressive="False" type="video">, <Stream: itag="398" mime_type="video/mp4" res="720p" fps="24fps" vcodec="av01.0.05M.08" progressive="False" type="video">, <Stream: itag="135" mime_type="video/mp4" res="480p" fps="24fps" vcodec="avc1.4d401e" progressive="False" type="video">, <Stream: itag="244" mime_type="video/webm" res="480p" fps="24fps" vcodec="vp9" progressive="False" type="video">, <Stream: itag="397" mime_type="video/mp4" res="480p" fps="24fps" vcodec="av01.0.04M.08" progressive="False" type="video">, <Stream: itag="134" mime_type="video/mp4" res="360p" fps="24fps" vcodec="avc1.4d401e" progressive="False" type="video">, <Stream: itag="243" mime_type="video/webm" res="360p" fps="24fps" vcodec="vp9" progressive="False" type="video">, <Stream: itag="396" mime_type="video/mp4" res="360p" fps="24fps" vcodec="av01.0.01M.08" progressive="False" type="video">, <Stream: itag="133" mime_type="video/mp4" res="240p" fps="24fps" vcodec="avc1.4d4015" progressive="False" type="video">, <Stream: itag="242" mime_type="video/webm" res="240p" fps="24fps" vcodec="vp9" progressive="False" type="video">, <Stream: itag="395" mime_type="video/mp4" res="240p" fps="24fps" vcodec="av01.0.00M.08" progressive="False" type="video">, <Stream: itag="160" mime_type="video/mp4" res="144p" fps="24fps" vcodec="avc1.4d400c" progressive="False" type="video">, <Stream: itag="278" mime_type="video/webm" res="144p" fps="24fps" vcodec="vp9" progressive="False" type="video">, <Stream: itag="394" mime_type="video/mp4" res="144p" fps="24fps" vcodec="av01.0.00M.08" progressive="False" type="video">, <Stream: itag="140" mime_type="audio/mp4" abr="128kbps" acodec="mp4a.40.2" progressive="False" type="audio">, <Stream: itag="249" mime_type="audio/webm" abr="50kbps" acodec="opus" progressive="False" type="audio">, <Stream: itag="250" mime_type="audio/webm" abr="70kbps" acodec="opus" progressive="False" type="audio">, <Stream: itag="251" mime_type="audio/webm" abr="160kbps" acodec="opus" progressive="False" type="audio">]
>> type(yt.streams)
<class 'pytube.query.StreamQuery'>

可以看到这里 streams 是一个 StreamQuery 对象，然后输出出来看起来像是一个列表，其中包含了一个个 stream 对象。

所以，StreamQuery 就是我们需要重点关注的对象了。

比如接下来我们使用 filter 或者 order_by 方法进行处理：

1
2

>>> type(yt.streams.filter(file_extension='mp4'))
<class 'pytube.query.StreamQuery'>

可以看到它依然还是一个 StreamQuery 对象。

然后根据分辨率进行排序：

1
2

>>> type(yt.streams.filter(file_extension='mp4').order_by('resolution'))
<class 'pytube.query.StreamQuery'>

还是一样，返回的还是 StreamQuery 对象。

这下明白为什么它可以进行链式操作了吧，因为每次 filter 或者 order_by 对象返回的依然还是 StreamQuery 对象，依然还是可以调用对应的方法的。

不过也不是每一个都是支持链式操作的，比如接下来我们对 StreamQuery 对象调用 first 方法：

1
2
3
4

>>> yt.streams.first()
<Stream: itag="18" mime_type="video/mp4" res="360p" fps="24fps" vcodec="avc1.42001E" acodec="mp4a.40.2" progressive="True" type="video">
>>> type(yt.streams.first())
<class 'pytube.streams.Stream'>

看到这里返回的就是单个 Stream 了。

对于 Stream 对象，我们最常用的就是 download 方法了。

1

yt.streams.first().download()

调用完毕之后，视频就会下载在运行目录中。

以上我们就介绍了利用命令行和代码进行视频下载的过程。

更多

当然这个库还有很多强大的功能，都在文档 https://python-pytube.readthedocs.io/en/latest/ 写得很清楚了，这里带大家稍微看下。

比如获取视频的属性：

1
2

>>> yt.title
YouTube Rewind 2019: For the Record | #YouTubeRewind

获取视频的缩略图：

1
2

>>> yt.thumbnail_url
'https://i.ytimg.com/vi/2lAe1cqCOXo/maxresdefault.jpg'

在初始化的时候设置处理方法或者设置代理：

1
2
3
4
5
6

>>> yt = YouTube(
  'http://youtube.com/watch?v=2lAe1cqCOXo',
  on_progress_callback=progress_func,
  on_complete_callback=complete_func,
  proxies=my_proxies
)

关于 filter 的一些用法，可以参考 https://python-pytube.readthedocs.io/en/latest/user/streams.html#filtering-streams，比如说过滤只保留有音频的流媒体：

1
2
3
4
5

>>> yt.streams.filter(only_audio=True)
[<Stream: itag="140" mime_type="audio/mp4" abr="128kbps" acodec="mp4a.40.2" progressive="False" type="audio">,
<Stream: itag="249" mime_type="audio/webm" abr="50kbps" acodec="opus" progressive="False" type="audio">,
<Stream: itag="250" mime_type="audio/webm" abr="70kbps" acodec="opus" progressive="False" type="audio">,
<Stream: itag="251" mime_type="audio/webm" abr="160kbps" acodec="opus" progressive="False" type="audio">]

保留 mp4 后缀的视频：

1
2
3
4
5
6
7

>>> yt.streams.filter(file_extension='mp4')
[<Stream: itag="18" mime_type="video/mp4" res="360p" fps="30fps" vcodec="avc1.42001E" acodec="mp4a.40.2" progressive="True" type="video">,
<Stream: itag="22" mime_type="video/mp4" res="720p" fps="30fps" vcodec="avc1.64001F" acodec="mp4a.40.2" progressive="True" type="video">,
<Stream: itag="137" mime_type="video/mp4" res="1080p" fps="30fps" vcodec="avc1.640028" progressive="False" type="video">,
...
<Stream: itag="394" mime_type="video/mp4" res="None" fps="30fps" vcodec="av01.0.00M.08" progressive="False" type="video">,
<Stream: itag="140" mime_type="audio/mp4" abr="128kbps" acodec="mp4a.40.2" progressive="False" type="audio">]

比如获取字幕：

1
2
3

>>> yt = YouTube('http://youtube.com/watch?v=2lAe1cqCOXo')
>>> yt.captions
{'ar': <Caption lang="Arabic" code="ar">, 'zh-HK': <Caption lang="Chinese (Hong Kong)" code="zh-HK">, 'zh-TW': <Caption lang="Chinese (Taiwan)" code="zh-TW">, ...

这里各国语言的字幕几乎都有。

另外还可以把字幕打印出来，比如输出 srt 格式：

1
2
3
4
5
6
7
8
9
10

>>> caption = yt.captions.get_by_language_code('en')
>>> print(caption.generate_srt_captions())
1
00:00:10,200 --> 00:00:11,140
K-pop!

2
00:00:13,400 --> 00:00:16,200
That is so awkward to watch.
...

对于播放列表的处理，比如新建 Playlist 对象，然后取出每一个视频的第一个视频流并下载：

1
2
3
4

>>> from pytube import Playlist
>>> p = Playlist('https://www.youtube.com/playlist?list=PLS1QulWo1RIaJECMeUT4LFwJ-ghgoSH6n')
>>> for video in p.videos:
>>>     video.streams.first().download()

另外还有一些异常处理机制：

1
2
3
4
5
6
7
8
9
10
11

>>> from pytube import Playlist, YouTube
>>> playlist_url = 'https://youtube.com/playlist?list=special_playlist_id'
>>> p = Playlist(playlist_url)
>>> for url in p.video_urls:
...     try:
...         yt = YouTube(url)
...     except VideoUnavailable:
...         print(f'Video {url} is unavaialable, skipping.')
...     else:
...         print(f'Downloading video: {url}')
...         yt.streams.first().download()

总之，使用这个库，我们不仅可以使用命令行方便地下载 Youtube 视频和播放列表，还可以使用代码灵活地控制，一举两得！

今天还是照常上班，和以往没有太多不同。

然而，办公室里面有位同事一句话惊动了周围所有同事——我们今年又多了五天假期？！

听罢，同事们像是刚中了彩票一样，一个个高兴得像个孩子，但还不知道具体咋回事。

：哪啊？哪说的啊？

：快看看邮件啊

：哪封邮件啊？

：就今天上午刚发的公司全员邮件啊！标题叫 Announcing Wellbeing Days

：好家伙，你不说我还真没注意

其实我也没注意，然后开始翻邮件，果不其然，找到了！

标题很明显了：

Announcing Wellbeing Days

具体的邮件内容不详细说了，总体意思就是说，现在全球新冠疫情严重，大家都面临非常多的压力，其中有一句关键的信息：

Thus, I am excited to announce five new paid WellbeingDays to support you.

是的，为此公司决定 2021 年给每个员工都加五天全薪“幸福关怀假”。

巨硬牛逼！

然后我又详细看了看，这个针对哪些员工呢？

2021 年 9 月 30 之前入职的员工都可以获得这五天假期，2021 年 9 月 30 到 12 月 1 日入职的员工，可以获得三天假期。

今年我的年假已经变成：

去年留到今年的还有 13 天，今年 15 天还没用，再加上 5 天，33 天年假了。

简直是良心了，这下我终于也体验到了一会“别人公司”的幸福感。

想来的，简历可以砸过来了。

给大家介绍一个非常实用的工具，有了它，我们可以在几秒之内用 VS Code 打开 GitHub 上的任意一个 Repo，无需 Clone，速度飞快。

用法也十分简单而且好记，下面给大家介绍下。

介绍

比如这里是 Scrapy 的仓库：https://github.com/scrapy/scrapy，用 GitHub 打开是这样的：

看代码的时候我们可能需要一个个点进去，速度慢而且感觉不太方便。

为此大家可能安装了一些 Chrome 插件，比如比较火的是 Octotree，安装之后效果是这样的：

安装这个插件之后，在网页左侧会出现一个文件树方便我们快速定位文件。然鹅，个人感觉总不是真正想要的那种味道。

现在好了。

这时候，我们只需要在网址 github 后面加上 1s，变成：https://github1s.com/scrapy/scrapy

没错，就是这么简单好记。

访问之后，就可以看到这样的页面：

是的没错，这就在浏览器中打开了一个在线版的 VS Code，并打开了 Scrapy 的源代码，看代码就非常方便了。

无需克隆，无需任何配置，打开飞速，代码高亮！

一些快捷键也是和 VS Code 一样的，比如 Cmd/Ctrl + P，就可以快速找到一个文件：

Cmd/Ctrl + F 搜索：

不过我试了一下全局搜索貌似只能限制在一个文件内，不知道是哪里设置的问题。

有的朋友可能会问，代码能修改吗？

答案是不能，代码都是以只读模式打开的，也就是我们只能看，没法改。不过这也合情合理，毕竟任意 Repo 都能打开，改了又存到哪里呢？

原理

另外有的朋友可能好奇这个的实现原理是怎样的，我扒了一下源码，看到作者是这么介绍的：

Github1s is based on VS Code 1.52.1 now. VS Code can be built for a browser version officially. I also used the code and got inspired by Code Server.

Thanks to the very powerful and flexible extensibility of VS Code, we can easily implement a VS Code extension that provides the custom File IO ability using FileSystemProvider API. There is an official demo named vscode-web-playground which shows how it is used.

On the other hand, GitHub provides the powerful REST API that can be used for a variety of tasks which includes reading directories and files for sure.

According to the above, obviously, the core concept of GitHub1s is to implement a VS Code Extension (includes FileSystemProvider) using GitHub REST API.

We may switch to the GitHub GraphQL API for more friendly user experience in the future, thanks to @xcv58 and @kanhegaonkarsaurabh. See details at Issue 12.

GitHub1s is a purely static web app (because it really doesn’t need a backend service, does it?). So we just deploy it on GitHub Pages now (the gh-pages branch of this repository), and it is free. The service of GitHub1s could be reliable (GitHub is very reliable) because nobody needs to pay the web hosting bills.

总的来说，GitHub1s 这个仓库是基于 VS Code 构建的，灵感来源于 Code Server 这个 Repo，地址为：https://github.com/cdr/code-server，这个就是一个 Online 版的 VS Code。

那作者基于这个做了什么事呢？

他基于 VS Code 提供的 FileSystemProvider API 对接了 GitHub 的 REST API 实现了这些功能。其中前者是 VS Code 提供的，可以提供文件读写操作，当然读写在线文件也是没问题的了；而后者是 GitHub 提供的，通过 REST API 可以获取 Repo 的文件夹或者某个文件。

如此，GitHub1s 就诞生了。

知道了原理之后，我们也可以自己把 GitHub1s 代码下载下来，改写一下，扩展一些功能：比如解除只读限制，保存的时候直接存储到自己的 Repo 等。

具体的修改和开发流程可以参见：https://github.com/conwnet/github1s/blob/master/docs/guide.md#development

访问频率限制

另外作者也提到了一点：

For unauthenticated requests, the rate limit allows for up to 60 requests per hour. Unauthenticated requests are associated with the originating IP address, and not the user making requests.

对于未授权的请求，API 的请求频率是有限制的，每个 IP 每个小时访问限制是 60 次，所以用着用着就容易超限制了，可能就打不开文件了。

这里的频率限制我解读下，有朋友可能好奇，因为这个网站是 github1s.com 来 serve 的，所以请求是不是都是 github1s.com 这个服务器发出来的呢？所以不同的人其实都是用的一个 IP？

其实不是的，我观察了一下网络请求，是当前网页直接请求了 GitHub 的 API 实现的，所以 IP 就是我们自己客户端的真实 IP，网络请求如下所示：

但是请求 GitHub 的 API 没有跨域问题吗？

没有，这是因为 GitHub API 设置了解除跨域访问，Response Headers 里面可以看到：

1

access-control-allow-origin: *

所以任何网站都可以直接请求 GitHub 的 API。

OK，说回解除频率限制的问题：

For API requests using Basic Authentication or OAuth, you can make up to 5,000 requests per hour.

这里说如果登录了，每小时就可以提高到 5000 次请求了。

怎么设置呢？

可以在 github1s.com 打开侧栏的 OAuth 设置，如图所示：

然后点击 Generate New OAuth Token，跳到自己的 GitHub Setting 页面，生成一个 Token 就好了，如图所示：

好了之后贴回来就 OK 了，这样频率限制就解除了，爽歪歪。

彩蛋

另外我还发现了有一个配套的 Chrome 插件，也叫 GitHub1s，大家可以自己搜索安装：

安装完成之后，每个 GitHub Repo 都会自动多出一个绿色按钮，如图所示：

点击之后就直接跳转到刚才所说的 github1s.com 打开这个 Repo 了，简直不要太方便！

另外还有另外一个开发者写的插件，效果是这样的：

感觉这个还是挺小巧精致的，可以来这里下载：https://github.com/2293736867/Github1sExtension

总结

好了，以后看 GitHub 代码就有新神器了，大家快去试试看吧～

事情是这样的，最近发现我的博客 cuiqingcai.com 的评论功能出现了问题，登录功能不好用了。经过一番排查，我找到了一些解决方案，在这里记录一下问题排查过程。

另外这个排查过程中可以总结出一些思路，大家如果碰到类似的问题，也可以按照类似的思路来排查。

友情提示：大家一定要读到最后或者直接拉到最后，最后内容的可能对你更有价值。

起因

我的博客最近刚换上了 hexo 框架，于是评论功能就换成了 Gitalk。但最近发现登录功能不好用了，点击使用 GitHub 登录总是失败。

就点击这个按钮的时候，始终登录不上去：

于是我就想着手解决一下这个问题。

思路

这里就记录一下我在排查过程中碰到的一些坑和解决思路。

首先，登录失败的问题，第一时间应该去排查的就是网络请求，打开控制台，查看 Network 面板，出现类似的结果：

网络请求直接 403 了，拿不到 token 了，于是就登录不上了。

观察下，这个链接 cors-anywhere 似乎是用来解决跨域限制的，后面还跟了一个 GitHub 的 Access Token 获取地址，那没跑了，前面这个就是一个反向代理，后面是真实的请求 URL。

OK，看着这个也没啥思路啊，然后接着怎么办？

那就接着去搜这个 cors-anywhere.herokuapp.com，因为 herokuapp 很眼熟嘛，就是一个公用的网址 Host 平台，类似于 AWS、Azure 之类的，那么前面这个可能包含某些信息。万一是开源的那就好办了。

接着搜，cors-anywhere，然后就搜到了这个：https://github.com/Rob--W/cors-anywhere

介绍如下：

CORS Anywhere is a NodeJS proxy which adds CORS headers to the proxied request.

The url to proxy is literally taken from the path, validated and proxied. The protocol part of the proxied URI is optional, and defaults to “http”. If port 443 is specified, the protocol defaults to “https”.

This package does not put any restrictions on the http methods or headers, except for cookies. Requesting user credentials is disallowed. The app can be configured to require a header for proxying a request, for example to avoid a direct visit from the browser.

真是一个开源框架，和我猜的一样，就是一个解决跨域问题而生的反向代理。

然后我就在它的 README 中看到了这个：

好家伙，这不就是我刚才用到的链接吗？

那肯定是这个玩意出了什么毛病。

咋看呢？这个果断就是找 Issue 了：

一看，太明显了：

PSA: Public demo server (cors-anywhere.herokuapp.com) will be very limited by January 2021, 31st

意思就是从今年 1.31 开始这个网站的访问会受限，点进去看看：

The demo server of CORS Anywhere (cors-anywhere.herokuapp.com) is meant to be a demo of this project. But abuse has become so common that the platform where the demo is hosted (Heroku) has asked me to shut down the server, despite efforts to counter the abuse (rate limits in #45 and #164, and blocking other forms of requests). Downtime becomes increasingly frequent (e.g. recently #300, #299, #295, #294, #287) due to abuse and its popularity.

To counter this, I will make the following changes:

1. The rate limit will decrease from 200 (#164) per hour to 50 per hour.
2. By January 31st, 2021, cors-anywhere.herokuapp.com will stop serving as an open proxy.
3. From February 1st. 2021, cors-anywhere.herokuapp.com will only serve requests after the visitor has completed a challenge: The user (developer) must visit a page at cors-anywhere.herokuapp.com to temporarily unlock the demo for their browser. This allows developers to try out the functionality, to help with deciding on self-hosting or looking for alternatives.

好吧，意思就是说这个网站本来是演示用的，但是现在已经被滥用了，然后从 1.31 开始用户手动必须手动先访问这个网站获取临时的访问权限，然后才能使用。另外推荐开发者自己来维护一个网站。

接着下面的评论第一个就更滑稽了：

这个人直接艾特了 gitalk，哈哈哈，因为 Gitalk 就如刚才所说的那样，也用了这个。

那就顺便去 Gitalk https://github.com/gitalk/gitalk，逛一下 issue，看看是不是也有人遇到了同样的问题，果不其然了：

最近几个 issue 都是关于 403 的，真热闹。

点进去看看，有个大收获，里面有个好心人说：

这次直接去嫖了一个 CORS proxy,把 gitalk.js 的 6794 行改为 proxy: ‘https://netnr-proxy.cloudno.de/https://github.com/login/oauth/access_token‘, 就可以了。具体能用多久我也没普，且用且珍惜。

真是得来全不费功夫，本来还想着自己部署着，这次那就换了就行了。

然而，这样不行，得需要改 gitalk.js 的源码，并不太好吧。

好，这时候就遇到了一个问题，要修改某些开源软件的源码应该怎么办？

首选的思路当然不是硬改，改了之后还要自己 host 一个新的 js 文件，那显然是很费精力的。

其实一半程序在编写的时候应该是预留一些接口和配置的，我们应该能很轻易地通过某些配置就能实现某些配置的复写。

那就接着看看吧，既然要改，那就得先看看 Gitalk 是怎么用的吧。

看文档，Gitalk 调用方式如下：

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

const gitalk = new Gitalk({
  clientID: "GitHub Application Client ID",
  clientSecret: "GitHub Application Client Secret",
  repo: "GitHub repo", // The repository of store comments,
  owner: "GitHub repo owner",
  admin: [
    "GitHub repo owner and collaborators, only these guys can initialize github issues",
  ],
  id: location.pathname, // Ensure uniqueness and length less than 50
  distractionFreeMode: false, // Facebook-like distraction free mode
});

gitalk.render("gitalk-container");

看来这个在声明的时候是有参数的，那刚才 URL 配置没看到在哪里配啊，既然如此，那就看看 Gitalk 这个对象支持多少参数吧。

接着就去找 Gitalk 的构造参数说明，找到这么一个：

• proxy：String

Default: https://cors-anywhere.herokuapp.com/https://github.com/login/oauth/access_token.

果然找到了，所以这里如果我们要修改，那就改 proxy 参数就行了，初始化 Gitalk 的时候复写掉 proxy 就行。

OK，基本思路有了，那我怎么改到我的源码里呢？

我的博客是基于 Hexo 的 Next 主题的，根据经验，Gitalk 是 Next 主题自带的，所以 Gitalk 的声明应该就在 Next 主题源码里面。

那怎么找呢？

这时候就需要借助于一些搜索技巧了，搜什么？既然要用 Gitalk，那一定有刚才初始化的调用，那就搜 Gitalk 这个关键字就行了。另外还需要缩小一下搜索范围。

于是我就把范围限定到了 next 主题目录，搜索 Gitalk。

简直不要太舒服，一搜就有了，文件是 themes/next/layout/_third-party/comments/gitalk.swig。

这里我们只需要把 proxy 参数加上不就行了，值是什么呢？仿照写就行了，配置风格保持统一，那就加一条：

1

proxy       : '{{ theme.gitalk.proxy }}',

OK，那这个配置的值很明显是主题配置文件，那就把配置文件里面加上 proxy 这个参数就好了。

找到 themes/next/_config.yml，添加行：

1

proxy: https://netnr-proxy.cloudno.de/https://github.com/login/oauth/access_token

结果如下：

好了，大公告成！

重新部署 Hexo，现在评论又能重新使用了，问题就解决了！

测试地址：https://cuiqingcai.com/message/，大家来给我留言吧～

好了，这就是我排查问题的整个过程，做一下记录。

经验

另外，其实这篇文章的用意不仅仅是单纯解决这个问题，因为这个问题大家可能并没有遇到过，因此这个解决方案仅仅是给极少数遇到这个问题的朋友提供的。

但是，这并不代表这篇文章没有价值，因为其中有的思路是通用的，在这里稍微做一下总结，希望对大家有帮助：

• 当遇到网页功能异常的时候，排查问题就主要看两个——控制台、网络请求，这里面往往能找到主要问题。
• 结合一些基本知识进行合理的推断，比如刚才我就推断了 cors- anywhere 的作用并结合 herokuapp 推断这个可能还会是个公用的服务。
• 当碰到没有思路或者不确定的时候，去谷歌它！不要百度，另外还可以在 GitHub 或者 Gitee 上搜。
• 如果找到对应的 GitHub 仓库，Issue 区往往能找到一些有效答案，比如刚才我就在 Issue 区找到了一个可替代的 cors 网站。
• 修改代码功能的时候要想着尽量复写，也就是 overwrite，而不是直接改，前者更具有灵活性，而且某些情况下会省去一些麻烦。
• 复写的时候去找一些参数配置，比如找一些初始化参数、默认参数配置，看看能否实现改写的需求。
• 找不到入口的时候善用全局搜索功能，比如刚才 Gitalk 找哪里调用的时候，就直接全局搜索。
• 根据功能限制某些搜索范围，比如刚才我就知道 Gitalk 这个功能是 Next 主题提供的，所以我就直接限制搜索范围是 Next 主题的源码。
• 以上步骤多尝试，熟能生巧。

最近遇到了一个问题，就是 Vue.js 中的 prop 如何实现双向绑定比较好。

之前我都是把 prop 传递到子组件，然后子组件里面直接把 prop 直接改了，这样虽然能把结果反映到父组件，但并不是一个很好的解决方案。

比如我就经常遇到这样的 Warning：

Avoid mutating a prop directly since the value will be overwritten…

实际上，用事件传递的方式把修改从子组件传到父组件是比较不错的方式，这就需要子组件 $emit 一个事件，然后父组件监听这个事件，然后将接收到的值修改就好了。

官方文档的说明如下：

在有些情况下，我们可能需要对一个 prop 进行“双向绑定”。不幸的是，真正的双向绑定会带来维护上的问题，因为子组件可以变更父组件，且在父组件和子组件都没有明显的变更来源。

这也是为什么我们推荐以 update:myPropName 的模式触发事件取而代之。举个例子，在一个包含 title prop 的假设的组件中，我们可以用以下方法表达对其赋新值的意图：

1	this.$emit('update:title', newTitle)

所以这里推荐的就是使用 update:propName 来实现。

这样的话，父组件原生的写法如下：

1
2
3
4

<text-document
  v-bind:title="doc.title"
  v-on:update:title="doc.title = $event"
></text-document>

这里 prop 的名字叫做 title，子组件需要接收到这个值，然后各种操作进行修改都没关系。

比如子组件可以这么写：

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

<template>
  <el-input v-model="titleData"></el-input>
</template>

<script>
export default {
  name: "Child",
  props: {
    title: {
      type: String,
      default: "",
    }
  },
  data() {
    return {
      titleData: this.title
    }
  },
  watch: {
    titleData: {
      handler(val) {
        this.$emit('update:title', val)
      }
    }
  }
}
</script>

这样当 titleData 更新的时候，父组件的 title 就更新了。

这时候父组件可以简写为：

1

<text-document v-bind:title.sync="doc.title"></text-document>

注意带有 .sync 修饰符的 v-bind 不能和表达式一起使用 (例如 v-bind:title.sync=”doc.title + ‘!’” 是无效的)。取而代之的是，你只能提供你想要绑定的 property 名，类似 v-model。

另外当我们用一个对象同时设置多个 prop 的时候，也可以将这个 .sync 修饰符和 v-bind 配合使用：

1

<text-document v-bind.sync="doc"></text-document>

这样会把 doc 对象中的每一个 property (如 title) 都作为一个独立的 prop 传进去，然后各自添加用于更新的 v-on 监听器。

将 v-bind.sync 用在一个字面量的对象上，例如 v-bind.sync=”{ title: doc.title }”，是无法正常工作的，因为在解析一个像这样的复杂表达式的时候，有很多边缘情况需要考虑。

以上，完毕。

写这篇文章的缘由来自看到了知乎上的一个问题——在 GitHub 上保持 365 天全绿是一种怎样的体验？

解释

大家可能有的不明白啥意思啊，这个绿指的是就是 GitHub 的 Contribution，如果你每天都提交代码到 GitHub，至少一次 commit，那么 GitHub 就会在你当天对应的 Contribution 格子上点上绿色，比如我的就是这样子：

因为我经常在 GitHub 上提交代码，所以我的 Contribution 页面就显示为绿色，commit 多的就深，少的就浅，灰色的就是当然没有任何代码提交的。

所以这个问题问的就是，每天都在 GitHub 上提交代码是什么体验，也就是 365 天每天一天不落地撸代码是什么体验？

然后有一个回答看得我笑出声：

曾经保持了 200 多天全绿，但是冷落了女朋友，一直绿到现在。

原回答如下：

这哥们真的是太秀了，秀到我实在忍不住给他默默点了个赞…

不过咱们还是言归正传啊，说回这个问题。

其实说实话真的保持 365 天全绿真的是一件很难的事情，每周都会有周末吧，周末得陪女朋友吧？什么，你没有女朋友，那忽略这一条。

那即使没有女朋友，一年不得有几天是过年过节的，还撸啥代码啊？即使不是逢年过节，那也总有几天状态不好或者生病的吧，强如铁人那坚持 365 天天撸代码也是够神的。

不过我还真见过几个，实打实的大神，比如 Taylor Otweel，PHP Laravel 框架的开发者，一年 8000 多次 commit，他的 Contribution 是这样的：

这个是真的强，而且人家撸的代码质量肯定也高啊，不像我们可能改了点 README 啥的。

但强如 Taylor Otweel，你也能看到有些天是没有贡献的，毕竟人家周末可能就真的不撸代码或者有其他的安排。

那怎么才能做到 365 天全绿呢？

既然人不行，那就靠机器人吧。

GitHub 不是这两年出了个 GitHub Actions 的功能吗？这就是 CI 嘛，借助于它，我们想做到 GitHub 365 天全绿，就轻而易举了。

到底怎么做？难不难。

不难，可能只需要两分钟就搞定了。

想不想知道怎么做的？想知道的接着往下看。

方案

这里介绍一个 GitHub 的库，地址为：https://github.com/justjavac/auto-green，借助它，咔咔几步就能搞定了。

先说步骤。

首先打开这个仓库，点 Use this template，注意千万不要点 Fork，不然是不生效的，如图所示：

点了之后就是提示你用这个 Template 创建一个自己的 Git 残酷，这时候就会让你填写的的仓库名称，比如我就创建了一个名字叫做 AutoGreen 的仓库，如图所示：

至此，已经成功了一半了。

现在你会观察到，在 Actions 这个选项卡自动执行了一个任务。啪！很快啊，执行完了：

执行完了你会发现这个仓库多了一次 commit，是来自 justjavac 的一次 commit：

点进去看看，commit 的信息还叫 “a commit a day keeps your girlfriend away”，啥意思？

跟代码做好朋友，永远没有女朋友？？？Oh，No，不是这样的！

commit 如图所示：

神奇的是这次 commit 还没有任何 file change，还是个空的 commit。

行了，不管这么多了。

到现在就结束了吗？GitHub 以后就会天天绿了吗，当然不会绿啊，为啥啊？

扒一扒源码看一下，打开 .github/workflows/ci.yml 文件，结果如下：

代码：

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

name: ci

on:
  push:
    branches:
      - master
  schedule:
    - cron: "0 0 * * *"

jobs:
  autogreen:
    runs-on: ubuntu-latest
    steps:
      - name: Clone repository
        uses: actions/checkout@v2

      - name: Auto green
        run: |
          git config --local user.email "justjavac@gmail.com"
          git config --local user.name "迷渡"
          git remote set-url origin https://${{ github.actor }}:${{ secrets.GITHUB_TOKEN }}@github.com/${{ github.repository }}
          git pull --rebase
          git commit --allow-empty -m "a commit a day keeps your girlfriend away"
          git push

看看这个文件，意思就是每天执行一下下面的这几行代码，比如 git 的 config、commit、push 等，就相当于模拟了一次提交。

其中有几行代码比较有意思：

1

git remote set-url origin https://${{ github.actor }}:${{ secrets.GITHUB_TOKEN }}@github.com/${{ github.repository }}

这里就是指定远程仓库等地址，这里有几个占位符，github 的 actor 和 repository 对象，其实这些我们不用管，在运行的时候会被自动赋值为当前仓库的信息，另外还有 GITHUB_TOKEN 也是在该任务运行的时候自动添加的。

另外还有一行代码：

1

git commit --allow-empty -m "a commit a day keeps your girlfriend away"

这里的 commit 操作加上了一个 --allow-empty 选项，意思就是允许空的提交，这也就解释了上文空提交的缘由了。

OK，但这里我们再回过头来看看配置就知道为啥不算我们的提交了：

因为这里配置的是原作者的 GitHub 邮箱，所以这次提交当然就会算作原作者的了。

那怎么才能让我们的绿呢？那把邮箱改成我们自己的就好了，比如我的就修改为了这样子：

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

name: ci

on:
  push:
    branches:
      - master
  schedule:
    - cron: "0 0 * * *"

jobs:
  autogreen:
    runs-on: ubuntu-latest
    steps:
      - name: Clone repository
        uses: actions/checkout@v2

      - name: Auto green
        run: |
          git config --local user.email "cqc@cuiqingcai.com"
          git config --local user.name "Germey"
          git remote set-url origin https://${{ github.actor }}:${{ secrets.GITHUB_TOKEN }}@github.com/${{ github.repository }}
          git pull --rebase
          git commit --allow-empty -m "a commit a day keeps your girlfriend away"
          git push

直接在 GitHub 网页上点击修改，修改好了保存就行了。

修改完了之后我们就自动有了一次 commit，接着 Actions 还会自动触发一次 commit，最后结果如图所示：

可以看到，最后这次 commit 已经变成我自己了。

以后，我每天都可以自动绿了。

（这话怎么听着这么奇怪？

福利

最后，原作者还预留了一个定时任务，可以使得你想绿就绿，不仅可以让你每天都绿，还能让你每小时都绿，每分钟都能绿。

想绿就绿，其乐无穷。

绿的方式很简单，套用原作者的介绍了，修改 yml 文件的定时配置就好了：

计划任务语法有 5 个字段，中间用空格分隔，每个字段代表一个时间单位。

1
2
3
4
5
6
7
8
9

┌───────────── 分钟 (0 - 59)
│ ┌───────────── 小时 (0 - 23)
│ │ ┌───────────── 日 (1 - 31)
│ │ │ ┌───────────── 月 (1 - 12 或 JAN-DEC)
│ │ │ │ ┌───────────── 星期 (0 - 6 或 SUN-SAT)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
* * * * *

每个时间字段的含义：

比如修改为 0 * * * * ，你就能做到每小时都绿了，修改为 * * * * * 你就能每分钟都绿了，真舒服啊！

注：由于 GitHub Actions 的限制，如果设置为 * * * * * 实际的执行频率为每 5 分执行一次，也就是每 5 分钟绿一次，也还不错嘛～

大家想必听说过一些变量命名格式，比如大驼峰式、小驼峰式，其他的你还知道什么？

今天看文档的时候，提到了一个 kebab case，这个你知道是什么命名格式吗？不知道的接着往下看。

这篇文章我们把所有变量命名格式梳理下。

Lower Camel Case

又名：小驼峰式

特征：第一个单词首字母小写，后续单词首字母大写。

例如：firstName、lastName

Upper Camel Case

又名：大驼峰式、Pascal Case

特征：每个单词的首字母都大写。

例如：FirstName、LastName

Snake Case

特征：每个单词小写，单词之间用下划线连接。

例如：first_name、last_name

Kebab Case

又名：Spinal Case、Train Case、Lisp Case

特征：每个单词小写，单词之间用中划线连接。

例如：first-name、last-name

Studly Case

特征：混合大小写，对大写字母的使用没有语义或语法意义。有时只有元音是大写的，其他时候大写和小写是交替的，但通常只是随机的。这个名字来自讽刺或讽刺意味，它是作者试图传达自己的冷静的一种尝试。它也可以用来模拟营销人员在命名计算机软件包时违反标准英语案例惯例的行为，即使在没有技术要求的情况下也是如此。

例如：tHeqUicKBrOWnFoXJUmpsoVeRThElAzydOG

参考来源

• https://en.wikipedia.org/wiki/Letter_case

问题

最近开发过程中遇到了一个小知识点，这里有一张 Base64 编码的图片，我想要把它复制到系统的粘贴板中，这个该怎么解决？

比如这里有一张图：

我可以通过 Base64 转换工具转换为 Base64 编码，转换网址为 https://www.base64-image.de/，转换结果如下：

图片就是类似 data:image/png;base64,ivBor2... 这样的编码。

问：现在有一张这样格式的图片，怎么把它复制到系统粘贴板中？

解决方案

首先这里需要用到一个 JavaScript 库，叫做 clipboard-polyfill，这个库的 npm 包地址为： https://www.npmjs.com/package/clipboard-polyfill，

看库的介绍有个关键的部分：

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

import * as clipboard from "clipboard-polyfill";

async function handler() {
  console.log("Previous clipboard contents:", await clipboard.read());

  const item = new clipboard.ClipboardItem({
    "text/html": new Blob(
      ["<i>Markup</i> <b>text</b>. Paste me into a rich text editor."],
      { type: "text/html" }
    ),
    "text/plain": new Blob(
      ["Fallback markup text. Paste me into a rich text editor."],
      { type: "text/plain" }
    ),
  });
  await clipboard.write([item]);
}

window.addEventListener("DOMContentLoaded", function () {
  const button = document.createElement("button");
  button.textContent = "Copy";
  button.addEventListener("click", handler);
  document.body.appendChild(button);
});

这里可以创建一个 ClipboardItem 对象，并传入对应的 Blob 内容，同时指定对应的 content-type 即可。

OK，那这里就需要一个关键部分，那就是如何把 Base64 编码的图片转化为 Blob。

一般来说，Base64 编码的图片的开头是 data:image/jpg;base64,，后面跟的就是 Base64 真实编码。

这里提供一个方法，可以将 Base64 编码转化为 Blob，代码如下：

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

function b64toBlob(b64Data, contentType = null, sliceSize = null) {
  contentType = contentType || "image/png";
  sliceSize = sliceSize || 512;
  let byteCharacters = atob(b64Data);
  let byteArrays = [];
  for (let offset = 0; offset < byteCharacters.length; offset += sliceSize) {
    let slice = byteCharacters.slice(offset, offset + sliceSize);
    let byteNumbers = new Array(slice.length);
    for (let i = 0; i < slice.length; i++) {
      byteNumbers[i] = slice.charCodeAt(i);
    }
    var byteArray = new Uint8Array(byteNumbers);
    byteArrays.push(byteArray);
  }
  return new Blob(byteArrays, { type: contentType });
}

这里其实就是将 Base64 编码先转化为了 Uint8Array，然后再将其转化为 Blob，并指定 contentType 即可。

接下来复制到粘贴板就很简单了，调用最上面的方法声明 ClipboardItem 对象即可：

1
2
3
4
5
6
7
8
9

function clip(b64Data) {
  const item = new clipboard.ClipboardItem({
    "image/png": this.b64toBlob(
      b64Data.replace("data:image/jpg;base64,", ""),
      "image/png",
      512
    ),
  });
}

这里 contentType 指定为了 image/png。

至此，clip 方法传入 Base64 编码的图片即可复制到系统粘贴板了，亲测可以在 Windows、Mac 上生效。

最近服务器都迁移到腾讯云 TKE 了，就是腾讯云 Kubernetes 服务，然后最近有个需求是获取客户端真实 IP。

我的情况：

• 服务用 Django 写的，通过 HTTP 请求头获取真实 IP
• Django 通过 uwsgi 运行，并通过 Nginx 转发出去
• Ingress 使用的 Nginx Ingress，而不是 TKE Ingress

下面说下几个关键配置：

Django 中获取 IP

获取方式如下：

1
2
3
4
5
6
7

def get_client_ip(request):
    x_forwarded_for = request.META.get('HTTP_X_FORWARDED_FOR')
    if x_forwarded_for:
        ip = x_forwarded_for.split(',')[0]
    else:
        ip = request.META.get('REMOTE_ADDR')
    return ip

uwsgi 配置

uwsgi.ini 配置如下：

1
2
3
4
5
6
7
8

[uwsgi]
module = core.wsgi
master = true
processes = 1
vacuum = true
static-map = /static=/app/app/static
http = 127.0.0.1:8000
log-master = true

Nginx 配置

Nginx 需要转发 uwsgi 出去，并且加上三个关键请求头：

1
2
3
4
5
6
7
8
9
10
11

server {
    listen       7777;
    server_name  localhost;

    location / {
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header Host $http_host;
        proxy_pass http://127.0.0.1:8000;
    }
}

Supervisor 配置

Supervisor 需要启动 Uwsgi 和 Nginx：

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

[supervisord]
nodaemon=true

[program:uwsgi]
command=uwsgi --ini /app/uwsgi.ini
stdout_logfile=/dev/stdout
stdout_logfile_maxbytes=0
stderr_logfile=/dev/stderr
stderr_logfile_maxbytes=0

[program:nginx]
command=/usr/sbin/nginx -g "pid /run/nginx/nginx.pid; daemon off;"
stdout_logfile=/dev/stdout
stdout_logfile_maxbytes=0
stderr_logfile=/dev/stderr
stderr_logfile_maxbytes=0

Dockerfile 配置

Dockkerfile 里面指定启动的命令为 supervisor：

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

FROM python:3.7-alpine
ENV PYTHONUNBUFFERED 1
WORKDIR /app
COPY requirements.txt .
RUN apk update && apk add \
        libuuid \
        gcc \
        nginx \
        supervisor \
        libc-dev \
        linux-headers \
        postgresql-libs \
        postgresql-dev \
    && pip install pip -U \
    && pip install -r requirements.txt
COPY . /app
RUN mkdir -p /run/nginx
COPY nginx.conf /etc/nginx/conf.d/default.conf
COPY supervisord.conf /etc/supervisord.conf
CMD ["/usr/bin/supervisord", "-c", "/etc/supervisord.conf"]

TKE 配置

这里参考来源为：https://cloud.tencent.com/document/product/457/48949

最关键的就是：

这里我需要修改 Service 的负载均衡：

修改 externalTrafficPolicy 为 Local 即可：

大功告成，后面 IP 就能成功获取到了。

之前配置 uwsgi 的时候，配完了之后 Python 的日志就输出不出来了，其实可以在 uwsgi.ini 里面加一个日志配置就行了，很简单：

1

log-master = true

示例配置如下：

1
2
3
4
5
6
7
8

[uwsgi]
module = core.wsgi
master = true
processes = 1
vacuum = true
static-map = /static=/app/app/static
http = 127.0.0.1:8000
log-master = true

加上这句之后，日志就可以顺利输出到控制台了。

说到加湿器，那就不得不先提一下空气净化器。

之前其实我家里是没有空气净化器的，最近刚搬新住处就入手了一个，因为我想打造一套全新的小米之家，哈哈哈。

这个空气净化器用和没用给我的感觉区别不大，因为我确实感觉不到室内空气好一点或者坏一点有啥区别。但是记得在我刚打开空气净化器的一瞬间，上面的空气质量指数显示为 180 多（实际上这个是说的 PM 2.5 的指数），重度污染！我直接好家伙，难道我没用空气净化器的二十多年一直都呼吸的是重度污染的空气吗？心中不由倒吸一口凉气。净化器开了一会，那个质量指数慢慢降低，最后一直降到 10 以下，我心里也慢慢舒服多了，这时候我就感觉自己处在一个洁净的环境里面。所以，虽然我自己并不能感受出来空气变好了，但是心里是舒服的、安心的。

那为什么又扯到加湿器呢？

这是因为当我在开着空气净化器的时候，和往常一样打开我的加湿器…这时候，空气净化器显示的空气质量指数直接爆表了，直接 200 以上，当场就把我吓坏了。我当时就跟我老婆说，老婆我们这个加湿器有问题啊，它加湿后的水雾怎么控制质量这么差，肯定对身体有害。说完了之后我就去搜新的加湿器去了。因为最近我在搞米家智能家居，所以第一个搜的就是小米的加湿器，搜到这么一款：

OK，除菌加湿器，很好，有了这个除菌功能，加湿的空气应该不会那么差了。当时我那款「美的」的加湿器是没有这个功能的，所以我就又跟老婆说，老婆我搜到这个小米的加湿器是有除菌功能的，我买了这个肯定就没事了，于是我成功说服了我老婆，于是我的米家智能家居又新增了一员。

然而，等到货之后我灌上水重新打开，情况居然跟我想的不一样！空气净化器依然非常高，直逼 200，这是怎么回事？难道这个除菌功能一点用都没有？

抱着好奇又震惊的心情，我就去网上查，原来，这个和水有关系。空气指数上升的原因可以简单这么解释：这么因为我用的是自来水，而自来水含有氯、重金属等杂质，我买的加湿器又属于超声波式加湿器，它的原理是利用超声波将水打散成直径只有 1-5 微米的细小颗粒，然后利用风动装置将这些小颗粒吹到空气中，所以自来水中的杂质也就跟着进入空气中了，这就导致了空气净化器指数急剧上升，污染空气，长期这样下去对人体并不好。

看到这里，那就牵扯到了几个概念，一个是水，一个是加湿器，这两者的不同组合可能产生不同的结果，下面且听我一一道来。

水

首先说水啊，其实我们平常见到的水有很多种，名字也不同，目前常见的水可以分为这么几种类别：自来水、白开水、纯净水、矿泉水、天然水、蒸馏水，咋这么多？听着都懵啊，下面来解释下。

自来水

这个大家都知道了，水龙头里面直接放出来的水就是自来水，它是经过自来水厂加工、消毒之后生产出来的复合国家饮用水标准的工人们生产生活用的水，消毒的时候，里面含有一些微生物（如大肠杆菌）、重金属、有机污染物、泥沙等物质，另外由于自来水厂喜欢用氯气消毒，所以自来水里面还含有一些氯离子，总之这些都是对人体健康不利的。看到这里不要害怕，那就不能喝了吗？没关系，把水烧开了就行了。

白开水

白开水就是把自然水直接烧开得到的水，因为刚才也说了，自来水里面含有各种对人体有害的物质，把水烧开后，大部分细菌病毒都会被杀死，一些氯也会被分解掉，另外钙、镁和一些重金属离子也会在烧开的过程中形成沉淀，也就是我们通常说的水垢。不过金属离子是不能完全沉淀的，所以水中还会有溶解有少量的重金属离子，所以并不是完完全全是干净的，但基本问题不大。另外白开水其实口感非常不好，喝起来很涩，反正我是完全喝不惯白开水的味道。

矿泉水

大家肯定听说过矿泉水，但你平时喝的还真不一定是矿泉水，目前比较常见的矿泉水有百岁山、恒大冰泉等，它是是天然含有矿物质离子或盐或硫化物或二氧化碳气体等物质的水，矿泉水对水源地要求很高，不同水源地的矿物质含量也不同，比如百岁山的河寨山水源说是富含了偏硅酸锂、锶、钙、钾等多种有益于人体健康的微量元素，是为数不多的优质水源，当然依云也是。

纯净水

纯净水就是水里不含任何其他物质，只有水分子的水，没有任何矿物质。它是经过一些离子交换、反渗透、蒸馏等工艺制成的，过滤掉了细菌、病毒等有害物质，而且几乎不含任何矿物质，水的硬度也很低，用它烧水也不会形成水垢。纯净水可以有两种获取方式，一种就是家里装净水器，出来的都是纯净水。另外就是直接购买，比如怡宝就是纯净水。

天然水

天然水，最常见的就是农夫山泉，它的标识叫做饮用天然水，为啥他不标识天然矿泉水呢？它其实和矿泉水几乎差不多，但是其中有益的元素含量并不能达到天然矿泉水的要求。百岁山的水源相对农夫山泉更好一些，农夫山泉的水源有好几个基地，一般来说千岛湖的最好喝，带有一点甘甜的味道。不过不仔细对比，这个和矿泉水大查不差，反正都含有一些钙、镁、钾等矿物质。

蒸馏水

蒸馏水相比大家在学习化学等时候听说过，其实就是把水烧开，把水蒸气收集下来，然后再把水蒸气液化，分离出来的水就是纯水了，和纯净水一样也是不含矿物质的。由于工艺复杂，制造设备昂贵，所以蒸馏水一般在实验室比较常用，家庭基本上没有喝的，当然要买也能买到，比如屈臣氏的瓶装蒸馏水，价格不菲。

好，说完了以上的水，那哪种水适合放在加湿器（目前指的是超声波加湿器）里面不会引起空气指数升高呢？答案是纯净水和蒸馏水，其他的都不行。纯净水和蒸馏水加上之后，我的空气净化器指数基本没有变化，保持超绿色状态，舒服了。

另外平时喝的话，矿泉水、纯净水、天然水、白开水其实都行，虽然说矿泉水相比纯净水多了一些对人体有益的矿物质，但人体矿物质的摄入也不一定是靠水嘛，所以基本没有什么影响。

好，说完了水，那就得再说说加湿器了，这个其实也是有讲究的。

加湿器

市面上的加湿器主要分为两种，一种是超声波式加湿器，一种是冷蒸发式加湿器。

超声波式加湿器

大部分人家里的加湿器可能都是一二三百块钱的吧，加湿的过程中你还会看到白雾对不对？没错，这种加湿器就是超声波式加湿器，这种加湿器刚才也说了，利用高效的超声波振动将水打散成直径只有 1-5 微米的细小颗粒，再利用风动装置，将这些小颗粒吹到空气中，这种加湿器具有加湿速度快耗电量小、使用寿命长的优点，而且价格相对比较便宜，但存在不足之处在于对水要求高。

冷蒸发式加湿器

这种加湿器和超声波最大的区别就是加湿过程看不见水雾，它的原理就是通过循环风将液态水变成气态水，其实这种加湿器的加湿效果和超声波式相比并不占优势，不过加湿过程中，水是真正变成水蒸气而进入空气中的，所以水中的一些物质并不会进入到空气中，所以这种加湿器我们可以放心使用自来水，而不会引起空气净化器指数上升。不过这种加湿器价格都挺贵的，比超声波式加湿器贵了两三倍不止。

所以呢，到这里，基本就通透了吧，我用的加湿器就是第一种，这种加湿器就必须得用纯净水或者蒸馏水才能保证空气净化器不会爆表。如果加湿器是第二种，那随便用什么水都没啥关系了。

另外友情提醒，如果你的加湿器是第一种，请不要再用自来水了，对身体健康不利，还是改用纯净水吧，或者直接换个蒸发式加湿器也可以的。

所以说，这一番下来，学到还真不少，水和加湿器原来还有这么多讲究，生活真是处处皆学问啊。

参考

想知道农夫山泉 景田百岁山和怡宝味道的差别? - 徐野的回答 - 知乎 https://www.zhihu.com/question/29367546/answer/109448432

白开水、纯净水、矿泉水和蒸馏水哪个最适合做长期饮用水？ - 安吉尔的回答 - 知乎 https://www.zhihu.com/question/20418550/answer/1271349511

你的加湿器到底该加什么水？今天让你秒懂！http://jd.zol.com.cn/734/7346674.html

怎样选购加湿器？ - 老爸评测的回答 - 知乎 https://www.zhihu.com/question/22406803/answer/555850897

上一节学习了 TypeScript 的基本类型，本节再来学习下接口 Interfaces 的使用。

TypeScript 的一个重要的特性就是帮助检查参数的字段是否是合法的，比如检查某个参数包含字段 foo，且类型需要是 number 类型，否则就会报错。通过接口，即 Interface 我们可以方便地实现这个操作。

第一个 Interface

最简单的实现方式参考下面的例子：

1
2
3
4
5
6

function printLabel(labeledObj: { label: string }) {
  console.log(labeledObj.label);
}

let myObj = { size: 10, label: "Size 10 Object" };
printLabel(myObj);

在这里我们声明了一个方法，叫做 printLabel，它接收一个参数叫做 labeledObj，在 labeledObj 后面声明了该参数需要的字段和类型，这里它需要一个字段 label，且类型必须要是 string 类型。在调用时，我们传入了一个 Object，它包含了两个字段，一个是 size，类型为 number，另一个是 label，类型为 string。这里值得注意的是传入的参数是比声明的参数多了一个字段 size 的，但是这并没有关系，编译器只检查传入的参数是否至少存在所需要的属性，对于多余的属性是不关心的。

运行结果如下：

1

[LOG]: "Size 10 Object"

如果此时我们将 label 属性的类型修改为 number：

1
2
3

function printLabel(labeledObj: { label: number }) {
  console.log(labeledObj.label);
}

则会出现如下报错：

1

Argument of type '{ size: number; label: string; }' is not assignable to parameter of type '{ label: number; }'. Types of property 'label' are incompatible. Type 'string' is not assignable to type 'number'.

这里就提示 label 属性只能传入 number 类型，而不能是 string 类型。

但上面这个写法其实很不友好，如果属性比较多，那这个声明会非常复杂，而且不同方法如果都用到这个参数，难道还把它的声明都重复声明一遍？这也太不好了吧。

所以，为了更方便地实现声明，这里我们可以使用 Interface 来实现，上面的例子就可以改写为如下形式：

1
2
3
4
5
6
7
8
9
10

interface LabeledValue {
  label: string;
}

function printLabel(labeledObj: LabeledValue) {
  console.log(labeledObj.label);
}

let myObj = { size: 10, label: "Size 10 Object" };
printLabel(myObj);

这里我们使用 interface 声明了一个类型声明，这样在 printLabel 就可以直接使用 Interface 的名称了。

怎么样？这种写法是不是感觉好多了。

Optional properties

某些情况下，某些字段并不是完全必要的，比如看下面的例子：

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

interface LabeledValue {
  label: string;
  count: number,
  message: string,
}

function printLabel(labeledObj: LabeledValue) {
  console.log(labeledObj.label);
}

let myObj = { size: 10, count: 1, label: "Size 10 Object"};
printLabel(myObj);

其中 message 字段其实在 myObj 对象里面没有，而且这个字段也并不是必需的，但是该字段如果存在的话，必须是 string 类型。那像上面的写法，其实就会报错了：

1

Argument of type '{ size: number; count: number; label: string; }' is not assignable to parameter of type 'LabeledValue'. Property 'message' is missing in type '{ size: number; count: number; label: string; }' but required in type 'LabeledValue'.

这里说 message 字段没有传。

这时候我们可以将 message 标识为可选字段，只需要在字段后面加个 ? 就好了，写法如下：

1
2
3
4
5

interface LabeledValue {
  label: string;
  count: number,
  message?: string,
}

这样就不会再报错了。

Readonly properties

在某些情况下，我们期望一个 Object 的某些字段不能后续被修改，只能在创建的时候声明，这个怎么做到呢？很简单，将其设置为只读字段就好了，示例如下：

1
2
3
4
5
6

interface Point {
  readonly x: number;
  readonly y: number;
}
let p1: Point = { x: 10, y: 20 };
p1.x = 5; // error!

这里我们声明了一个名为 Point 的 Interface，然后在创建 Point 的时候将 x 设置为 10。但后续如果我们想设置 x 的属性为 5 的时候，就会报错了：

1

Cannot assign to 'x' because it is a read-only property.

这样就可以保证某些字段不能在后续操作流程中被修改，保证了安全性。

另外我们可以使用 ReadonlyArray 来声明不可变的 Array，一旦初始化完成之后，后续所有关于 Array 的操作都会报错，示例如下：

1
2
3
4
5
6
7
8
9
10
11

let a: number[] = [1, 2, 3, 4];
let ro: ReadonlyArray<number> = a;

ro[0] = 12; // error!
Index signature in type 'readonly number[]' only permits reading.
ro.push(5); // error!
Property 'push' does not exist on type 'readonly number[]'.
ro.length = 100; // error!
Cannot assign to 'length' because it is a read-only property.
a = ro; // error!
The type 'readonly number[]' is 'readonly' and cannot be assigned to the mutable type 'number[]'.

另外到这里大家可能疑惑 readonly 和 const 是什么区别，二者不都代表不可修改吗？其实区分很简单，readonly 是用来修改 Object 的某个属性的，而 const 是用来修饰某个变量的。

Function Types

除了用 interface 声明 Object 的字段，我们还可以声明方法的一些规范，示例如下：

1
2
3

interface SearchFunc {
  (source: string, subString: string): boolean;
}

这里就是用 interface 声明了一个 Function，前半部分是接收的参数类型，后面 boolean 是返回值类型。

声明 interface 之后，我们便可以声明一个 Function 了，写法如下：

1
2
3
4
5
6
7
8

interface SearchFunc {
  (source: string, subString: string): boolean;
}

let mySearch: SearchFunc = (source: string, subString: string) => {
  let result = source.search(subString);
  return result > -1;
};

这里声明了一个 Function 叫做 mySearch，其中其参数和返回值严格按照 SearchFunc 这个 Interface 来实现，那就没问题。

如果我们将返回值改掉，改成非 boolean 类型，示例如下：

1
2
3
4
5
6
7
8

interface SearchFunc {
  (source: string, subString: string): boolean;
}

let mySearch: SearchFunc = (source: string, subString: string) => {
  let result = source.search(subString);
  return result;
};

这时候就会得到如下报错：

1

Type '(source: string, subString: string) => number' is not assignable to type 'SearchFunc'. Type 'number' is not assignable to type 'boolean'.

这里就说返回值是 number，而不是 boolean。

Class Types

除了声明 Function，interface 还可以用来声明 Class，主要作用就是声明 class 里面所必须的属性和方法，示例如下：

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

interface ClockInterface {
  currentTime: Date;
  setTime(d: Date): void;
}

class Clock implements ClockInterface {
  currentTime: Date = new Date();
  setTime(d: Date) {
    this.currentTime = d;
  }
  constructor(h: number, m: number) {}
}

这个简直跟其他语言的接口定义太像了。定义好了 ClockInterface 之后，class 需要使用 implements 来实现这个接口，同时必须要声明 currentTime 这个变量和 setTime 方法，类型也需要完全一致，不然就会报错。

Extending Interfaces

另外 Interface 之间也是可以继承的，相当于在一个 Interface 上进行扩展，示例如下：

1
2
3
4
5
6
7
8
9
10
11

interface Shape {
  color: string;
}

interface Square extends Shape {
  sideLength: number;
}

let square = {} as Square;
square.color = "blue";
square.sideLength = 10;

这里 Shape 这个 Interface 只有 color 这个属性，而 Square 则继承了 Shape，并且加了 sideLength 属性，那其实现在 Square 这个接口声明了 color 和 sideLength 这两个属性。

另外 Interface 还支持多继承，获取被继承的 Interface 的所有声明，示例如下：

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

interface Shape {
  color: string;
}

interface PenStroke {
  penWidth: number;
}

interface Square extends Shape, PenStroke {
  sideLength: number;
}

let square = {} as Square;
square.color = "blue";
square.sideLength = 10;
square.penWidth = 5.0;

但如果同名的字段不一致怎么办呢？比如下面的例子：

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

interface Fruit {
    color: string
}

interface Apple extends Fruit {
    hasLeaf: boolean
}

interface Orange extends Fruit {
    size: number,
    hasLeaf: number
}

interface Watermalon extends Apple, Orange {
    
}

这里 hasLeaf 在 Apple 里面是 boolean 类型，在 Orange 里面是 number 类型，最后 Watermalon 继承了这两个 Interface 会怎样呢？

很明显，报错了，结果如下：

1

Interface 'Watermalon' cannot simultaneously extend types 'Apple' and 'Orange'. Named property 'hasLeaf' of types 'Apple' and 'Orange' are not identical.

意思就是说字段类型不一致。

所以，要多继承的话，需要被继承的 Interface 里面的属性不互相冲突，不然是无法同时继承的。

Interfaces Extending Classes

在某些情况下，Interface 可能需要继承 Class，Interface 扩展 Class 时，它将继承该 Class 的成员，但不继承其实现。这就类似该 Interface 声明了该类的所有成员而没有提供实现。

另外 Interface 甚至可以继承 Class 的私有成员和受保护成员。这意味着，当创建一个扩展带有私有或受保护成员的 Class 的 Interface 时，该 Interface 只能由该 Class 或其子 Class 实现。

示例如下：

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

class Control {
  private state: any;
}

interface SelectableControl extends Control {
  select(): void;
}

class Button extends Control implements SelectableControl {
  select() {}
}

class TextBox extends Control {
  select() {}
}

class ImageControl implements SelectableControl {
  // Error, Class 'ImageControl' incorrectly implements interface 'SelectableControl'.
  // Types have separate declarations of a private property 'state'.
  private state: any;
  select() {}
}

上面我们可以知道，当创建一个扩展带有私有或受保护成员的 Class 的 Interface 时，该 Interface 只能由该 Class 或其子 Class 实现。在这里 ImageControl 由于没有继承 Control，但同时 Control 还包含了私有成员变量，所以 ImageControl 并不能继承得到 state 这个私有成员变量，所以会报错。

以上便是关于 Interface 的一些用法，后面会继续总结其他的用法，如 Functions、Classes 等详细用法。

之前的时候都是用 JavaScript 开发，但是最近发现随着项目的推进，一些项目越来越多地要求使用 TypeScript 来开发，所以不得不来专门学习一下 TypeScript 了，本篇文章就简单记录下学习 TypeScript 的过程。

介绍

先看看 TypeScript 的官方介绍：

Typed JavaScript at Any Scale.

TypeScript extends JavaScript by adding types. By understanding JavaScript, TypeScript saves you time catching errors and providing fixes before you run code. Any browser, any OS, anywhere JavaScript runs. Entirely Open Source.

我们知道 JavaScript 是弱类型的语言，而实际上说白了就是加上类型标识的 JavaScript 语言，加上类型标识之后，可以帮助我们减少开发的调试成本，尽早发现错误，节省更多时间。同时 TypeScript 是完全开源的，它编译后得到的 JavaScript 支持任何浏览器和操作系统运行。

截止本文撰写的时间，TypeScript 已经更新到 4.1 版本，官方文档地址：https://www.typescriptlang.org/docs/handbook/release-notes/typescript-4-1.html。

相关资料

学习 TypeScript 当然要看原汁原味的资料，推荐 TypeScript 官方的 Handbook，链接为：https://www.typescriptlang.org/docs/handbook/intro.html。

本文所总结的内容基于 Handbook 的内容加上个人的一些修改而成。

另外本节的代码推荐大家直接在 TypeScript 提供的 Playgroud 里面运行即可，不用自己再初始化 Node 和 TypeScript 环境，简单方便，链接为：https://www.typescriptlang.org/play，大家直接打开就行了，预览如下：

比如默认情况下就有两行初始化代码：

1
2

const anExampleVariable = "Hello World";
console.log(anExampleVariable);

点击 Run 之后就可以直接运行，控制台输出结果显示在右侧，内容如下：

1

[LOG]: "Hello World"

如果你运行成功了，那我们就可以开始接下来的学习了。

下面正式开始介绍。

TypeScript 主要就是在 JavaScript 基础上扩展了一些类型，所以这里就分各种类型来进行介绍。

基本类型

Boolean

最常见的基本类型就是布尔类型了，其值就是 true 或者 false，类型声明用 boolean 就好了，在 TypeScript 中，声明一个 boolean 类型的变量写法如下：

1
2

let isDone: boolean = false;
console.log(isDone, typeof isDone);

这里注意到，声明类型可以在变量名的后面加上一个冒号，然后跟一个类型声明，和 Python 的 Type Hint 非常像。然后我们用 console 的 log 方法输出了这个变量，并用 typeof 输出了它的类型。

运行结果如下：

1

[LOG]: false,  "boolean"

可以看到运行结果就被输出出来了，同时 typeof 就是这个变量的类型，结果是一个字符串，就是 boolean。

是不是很简单？基本套路就是在变量的后面跟一个冒号再跟一个类型声明就好了。

Number

Number 即数值类型，对于这个类型，TypeScript 和 JavaScript 是一样的，Number 可以代表整数、浮点数、大整数。其中大整数需要单独用 bigint 来表示。另外 Number 还可以代表十六进制、八进制、二进制。

示例如下：

1
2
3
4
5
6
7
8

let decimal: number = 6;
let hex: number = 0xf00d;
let binary: number = 0b1010;
let octal: number = 0o744;
let big: bigint = 100n;

console.log(hex, typeof hex);
console.log(big, typeof big);

其中 bigint 需要 ES2020 的支持，需要在 TS Config 里面设置下：

运行结果如下：

1
2

[LOG]: 61453,  "number"
[LOG]: 100,  "bigint"

这里输出了 hex 和 big 变量的值和类型，其中 hex 本身是用十六进制声明的，打印输出的时候被转化为了十进制，同时其类型为 number。

另外对于 bigint 类型来说，值的后面需要加一个 n，即 100 和 100n 代表的类型是不一样的，后者的类型是 bigint，前者的类型是 number。

假如把 bigint 类型的变量声明为 number 类型是会报错的，比如这样就是错误的：

1

let big: number = 100n;

报错内容如下：

1

Type 'bigint' is not assignable to type 'number'.

String

String 即字符串类型，需要用 string 来声明类型。字符串可以用单引号或者双引号或者斜引号声明，其中斜引号就是模板字符串。

示例如下：

1
2
3
4
5
6
7
8

let color: string = "blue";
color = "red";
let fullName: string = `Bob Bobbington`;
let age: number = 37;
let sentence: string = `Hello, my name is ${fullName}. I'll be ${
  age + 1
} years old next month.`;
console.log(sentence, typeof sentence);

运行结果如下：

1

[LOG]: "Hello, my name is Bob Bobbington. I'll be 38 years old next month.",  "string"

嗯，没什么特殊的，就是字符串类型。

Array

Array 即数组，声明可以有两种方式，一种是 type[] 这样的形式，一种是 Generics 泛型的形式，示例如下：

1
2
3
4
5
6

let list: number[] = [1, 2, 3];
let list2: Array<number> = [1, 2, 3];
let list3: Array<any> = [1, "2", 3];
console.log(list, typeof list);
console.log(list2, typeof list2);
console.log(list3, typeof list3);

其中 list 就是使用了 type[] 这样的声明方式，声明为 number[]，那么数组里面的每个元素都必须要是 number 类型，list2 则是使用了泛型类型的声明，和 list 的效果是一样的，另外 list3 使用了 any 泛型类型，所以其值可以不仅仅为 number，因此这里 list3 的第二个元素设置为了字符串 2。

运行结果如下：

1
2
3

[LOG]: [1, 2, 3],  "object"
[LOG]: [1, 2, 3],  "object"
[LOG]: [1, "2", 3],  "object"

结果的 typeof 输出的结果可能让人意外，不应该是输出其声明的类型吗，怎么是 object？这是因为浏览器真正执行的是刚才的 TypeScript 编译生成的 JavaScript，而 JavaScript 本身的 Array 和 Object 等类型，typeof 都统一返回 object 类型，因此得到的结果就是 object 了。

Tuple

Tuple 即元组，它可以允许我们声明固定数量和顺序的 Array，来看个例子就懂了：

1
2
3

let x: [string, number];
x = [1, 2]; // Error
x = ["Hello", 2]; // Correct

比如这里声明了一个变量 x，x 必须是一个 Array，按照顺序来说，其第一个元素必须要是 string，第二个元素必须要是 number，所以第二行的声明就会报错，第三行的声明才是正确的。

有了类型声明之后，在编译阶段就能发现错误或者编辑器给出方法输入提示。比如：

1
2

console.log(x[0].substring(1)); // Correct
console.log(x[1].substring(1)); // Error, Property 'substring' does not exist on type 'number'.

比如这里第一行我们在敲 substring 的时候，编辑器根据类型判断出 x[0] 是 string 类型，那就可以给出 substring 的提示。而对于第二行代码的 x[1]，编译器会直接检查出其中存在错误，这有助于我们在静态类型检查时候及时发现问题，减少 Bug 出现的概率。

Enum

Enum 即枚举类型，这个非常有用，有时候我们想定义的变量其实就只有某几种取值，那完全可以定义为枚举类型。

用法如下：

1
2
3
4
5
6
7
8
9
10

enum Stage {
  Debug,
  Info,
  Warning,
  Error,
  Critical,
}

let stage: Stage = Stage.Critical;
console.log(stage, typeof stage);

这里我们声明了一个枚举类型，其名称叫做 Stage，值有五个。然后声明的变量直接用 Stage 修饰即可，值则可以直接取 Stage 的某个值，这里取值为 Stage.Critical。

最后打印输出该变量，结果如下：

1

[LOG]: 4,  "number"

结果居然是 4，这个怎么情况？

原来是因为枚举类型，它会按照枚举值的声明顺序自动编号，比如 Debug 的值就是 0，Info 就是 1，以此类推。默认情况下是从 0 开始编号的，不过我们也可以手动更改编号的起始值，比如 Debug 从 1 开始编号，可以声明如下：

1
2
3
4
5
6
7
8
9
10

enum Stage {
  Debug = 1,
  Info,
  Warning,
  Error,
  Critical,
}

let stage: Stage = Stage.Critical;
console.log(stage, typeof stage);

最后可以看到 Critical 的编号就变成 5 了，运行结果如下：

1

[LOG]: 5,  "number"

有点意思。

那既然它是按照顺序来赋值的，那我如果在前面的值设置大一点，会不会出现后面的值和前面的值相等的情况？比如：

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

enum Stage {
  Debug = 1,
  Info = 3,
  Warning = 2,
  Error,
  Critical,
}

let stage: Stage = Stage.Error;
let stage2: Stage = Stage.Info;
console.log(stage, typeof stage);
console.log(stage2, typeof stage2);
console.log(stage == stage2);

看看这样会发生什么？这里 Error 按照常理来说会从 Warning 开始自增，值应该为 3，那 Info 我也设置为 3，二者会是相等吗？

运行结果如下：

1
2
3

[LOG]: 3,  "number"
[LOG]: 3,  "number"
[LOG]: true

果不其然，二者还都是 3，而且它们就是相等的。所以，对于枚举类型，我们一定要注意声明值的时候最好不要引起自增值和设定值之间的冲突，不然会引入不必要的麻烦。

另外对于枚举类型，我们还可以根据值进行查询，比如对于上述声明，我们不知道哪个值等于 2 或者 3，那可以直接将值传给 Stage 进行查询，得到的结果是一个字符串，示例如下：

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

enum Stage {
  Debug = 1,
  Info = 3,
  Warning = 2,
  Error,
  Critical,
}

let stage: string = Stage[3];
console.log(stage, typeof stage);

let stage2: string = Stage[2];
console.log(stage2, typeof stage2);

运行结果如下：

1
2

[LOG]: "Error",  "string"
[LOG]: "Warning",  "string"

比如这里 Stage[2] 就是查找枚举值等于 2 的枚举名称，结果是 Warning。那值相同的咋办呢？比如 3，看结果它返回的是 Error，看来 Error 把 Info 覆盖掉了，查询的结果是最新的一个枚举名称。注意这里返回的结果是字符串类型，不是枚举类型，它仅仅代表枚举的名称而已。

Unknown

Unknown 即未知类型，一般在类型不确定的情况下可以声明为 unknown 类型。比如说一个数据可能是 API 返回的，它可能是数值类型也可能是字符串类型，并不知道，这时候我们就可以将其声明为 unknown 类型。

示例如下：

1
2
3
4
5

let notSure: unknown = 4;
notSure = "maybe a string instead";

// OK, definitely a boolean
notSure = false;

比如这里 notSure 就声明了 unknown 类型，一开始它是数值类型，但当然也可以是字符串或者布尔类型。

那这样不就没啥用了吗？和 JavaScript 有啥不同吗？其实 unknown 还有其他用处，比如说编译器可以在一些判定条件下对 unknown 的值进行精确化处理，比如说一个 if 条件，判定了类型为布尔类型，那么其他和该类型相关的变量都会执行静态类型检查。示例如下：

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

declare const maybe: unknown;
// 'maybe' could be a string, object, boolean, undefined, or other types
const aNumber: number = maybe;
// Type 'unknown' is not assignable to type 'number'.

if (maybe === true) {
  // TypeScript knows that maybe is a boolean now
  const aBoolean: boolean = maybe;
  // So, it cannot be a string
  const aString: string = maybe;
  // Type 'boolean' is not assignable to type 'string'.
}

if (typeof maybe === "string") {
  // TypeScript knows that maybe is a string
  const aString: string = maybe;
  // So, it cannot be a boolean
  const aBoolean: boolean = maybe;
  // Type 'string' is not assignable to type 'boolean'.
}

这里使用 declare 声明了一个类型变量，然后通过类型变量里面的判定条件就能配合检查其他变量的类型了。

Any

和 Unknown 的情形类似，我们还可以使用 any 来代表任意的类型，示例如下：

1
2
3

declare function getValue(key: string): any;
// OK, return value of 'getValue' is not checked
const str: string = getValue("myString");

这里声明了一个方法，返回类型就是 any，这样的话返回类型就可以是任意的结果了。

那 any 和 unknown 有什么不同呢？any 的自由度会更高一点，如果声明为 any，那么静态类型检查都会通过，即使某个变量的属性不存在。示例如下：

1
2
3
4
5
6
7
8
9

let looselyTyped: any = 4;
// OK, ifItExists might exist at runtime
looselyTyped.ifItExists();
// OK, toFixed exists (but the compiler doesn't check)
looselyTyped.toFixed();

let strictlyTyped: unknown = 4;
strictlyTyped.toFixed();
// Error, Object is of type 'unknown'.

可以看到，前两行的静态类型检查是能过的，但是 unknown 就过不了。

所以，什么时候用 unknown 什么时候用 any 呢？可以从含义上来进行区分：如果某个变量我确实就不知道它的类型，即我没办法知道它的类型，那就用 unknown；如果某个值但其实我确实有办法知道可能的类型，但确实它的类型自由度比较高，那就可以被声明为 any。

但在不必要的情况下，尽量减少 any 类型的使用。

Void

Void 一般用于声明方法的返回值，如果一个方法不返回任何结果，那就用 Void，示例如下：

1
2
3

function warnUser(): void {
  console.log("This is my warning message");
}

Null 和 Undefined

其实 TypeScript 还专门为 null 和 undefined 声明了类型，一般 null 就声明为 null 类型，undefined 就声明为 undefined 类型，不过这两个并不太常用，示例如下：

1
2
3

// Not much else we can assign to these variables!
let u: undefined = undefined;
let n: null = null;

另外对于其他类型来说，其值也可以是 null 或者 undefined，比如 number 类型的变量，其值为 null 也是完全可以的。不过这里有个前提条件就是，TS Config 里面的 strictNullChecks 应该是关闭状态，不然会报错的。

设置如下：

比如：

1
2

let a: number = undefined;
let b: string = null;

这样就是没问题的了。

Never

这个类型也比较特殊，它代表你永远得不到它的结果。比如一个方法始终抛出一个异常，或者处于一个无限循环中，那么就可以声明为 never，示例如下：

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

// Function returning never must not have a reachable end point
function error(message: string): never {
  throw new Error(message);
}

// Inferred return type is never
function fail() {
  return error("Something failed");
}

// Function returning never must not have a reachable end point
function infiniteLoop(): never {
  while (true) {}
}

Object

Object 是 JavaScript 本身带有的类型，它表示非原始型的类型，即任何不是 number、string、boolean、bigint、symbol、null、undefined 的类型。

示例如下：

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

declare function create(o: object | null): void;

// OK
create({ prop: 0 });
create(null);
create(42);
// Error, Argument of type '42' is not assignable to parameter of type 'object | null'.
create("string");
// Error, Argument of type '"string"' is not assignable to parameter of type 'object | null'.
create(false);
// Error, Argument of type 'false' is not assignable to parameter of type 'object | null'.
create(undefined);
// Error, Argument of type 'undefined' is not assignable to parameter of type 'object | null'.

不过，一般不用。

Type assertions

一般情况下，我们确确实实知道某个变量属于什么类型，或者在某种情况下确实需要这种类型的转化，则可以显式的声明某个类型，示例如下：

1
2
3
4

let someValue: unknown = "this is a string";
let strLength: number = (someValue as string).length;
let someValue2: unknown = "this is a string";
let strLength2: number = (<string>someValue2).length;

这里有两种使用方式，一种是 as，一种是尖括号声明。

注意

另外值得注意到是，以上的一些类型声明，使用大写形式 Number, String, Boolean, Symbol and Object 也是可以的，不过不推荐这么做，推荐还是用小写的形式。

比如这样其实是可以的：

1
2
3
4
5

function reverse(s: String): String {
  return s.split("").reverse().join("");
}

reverse("hello world");

但更推荐使用小写，写成如下形式：

1
2
3
4
5

function reverse(s: string): string {
  return s.split("").reverse().join("");
}

reverse("hello world");

总结

以上便是一些基本的类型声明方式，暂时先总结这么多，后面还会继续整理更高级的用法，比如 Function、Interface、Class 等。

最近的服务都放到腾讯云上了，但是最近遇到了一个问题是 Docker 云磁盘满了，部署的适合提示 no space left 等等。

然后我就登录云主机看了下磁盘情况，好家伙：

1
2
3
4
5
6
7
8
9

ubuntu@VM-0-2-ubuntu:/var/lib/docker/containers$ df
Filesystem     1K-blocks    Used Available Use% Mounted on
udev             3869584       0   3869584   0% /dev
tmpfs             777376   15124    762252   2% /run
/dev/vda1      103145380 9460508  89390616  10% /
tmpfs            3886864      24   3886840   1% /dev/shm
tmpfs               5120       0      5120   0% /run/lock
tmpfs            3886864       0   3886864   0% /sys/fs/cgroup
/dev/vdb        10255636 10155252   -  99% /var/lib/docker

vdb 这个磁盘就是我的数据盘，里面放了容器数据，现在已经到了 99% 了，一共就 10G。

然后我就去腾讯云控制台搞了下数据盘的扩容，然后直接扩容到了 200G。

但是回过头来看了下磁盘还是 10G，一变不变。

但 fdisk 已经看到变了：

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

ubuntu@VM-0-2-ubuntu:/var/lib/docker/containers$ sudo fdisk -l
Disk /dev/vda: 100 GiB, 107374182400 bytes, 209715200 sectors
Units: sectors of 1 * 512 = 512 bytes
Sector size (logical/physical): 512 bytes / 512 bytes
I/O size (minimum/optimal): 512 bytes / 512 bytes
Disklabel type: dos
Disk identifier: 0x3fa1d255

Device     Boot Start       End   Sectors  Size Id Type
/dev/vda1  *     2048 209715166 209713119  100G 83 Linux


Disk /dev/vdb: 200 GiB, 214748364800 bytes, 419430400 sectors
Units: sectors of 1 * 512 = 512 bytes
Sector size (logical/physical): 512 bytes / 512 bytes
I/O size (minimum/optimal): 512 bytes / 512 bytes

这是因为之前的数据被格式化为了 ext4，但是新扩容的部分并没有。

问了腾讯云的工程师，这时候必须要重新格式化才能用上新的容量，没有好的解决方法。

最后的解决方案：

• 将当前节点所有 Pod 驱逐到其他的节点。
• 当前节点退出集群然后配置磁盘，重新操作 mount 和格式化。（但是这里劝别折腾了，终究还是要格式化的。
• 把节点再加回来，这时候可以选重新格式化数据盘，mount 到 /var/lib/docker。
• 再把之前的 Pod 收回到本节点就好了。

完毕。

感觉还是不完善啊，像 Azure Kubernetes 的扩容就方便多了，不用整这么多麻烦事。

就昨天的时候，Python 之父 Guido 发了个推特，说自己觉得退休太无聊了，然后于是乎决定加入微软。

同时推特上大神 Anders Hejlsberg（Delphi、C# 和 TypeScript 之父）转发了推特，表示希望可以一起工作。

要知道，去年那会去年 10 月 30 日，Python 之父 Guido 宣布退休，当时他发推文说，“这件事感觉既苦涩又甜蜜：苦涩的是，我马上要离开 Dropbox，现在已经退休；甜蜜的是，在 Dropbox 做工程师期间，我学到很多，比如类型标注就来自这段经历。我会非常怀念在这里工作的日子。”

看到这个消息我既震惊又激动，Python 之父加入我司了？那我岂不是和他也算做同事了？哈哈哈。

当时我看到这个消息之后，第一时间就去公司的系统里面查了下，果真就查到了，这里放个图。

他的 Title 叫 DISTINUISHED ENGINEER，这个 Title 可不是一般的牛逼，在微软，有这样的 Title 的人可是屈指可数的，DISTINUISHED 意思就是杰出的，非常牛逼的意思，能有这种 Title 的是为业界或公司做出过特别特别大贡献的，特别有影响力的，可能普通人在微软呆个二十多年都不一定能到这个地位。他的职级和 Report Line 就不说了，他距离微软 CEO 纳德拉只差 3 级，稍微形象点说就是对标阿里 P11 或者 P12 的位置吧。

他的部门就直接写了 Python and Tools for AI，和 AI 相关，同时 Guido 又这么热爱开源，微软也在一直拥抱开源，期待 Python 之父将来不久之后又出新的杰作吧。

要知道 Python 之父 Guido 已经 64 岁了，或许大佬就是大佬吧，退休了感觉无聊，就来微软来玩玩。怎么说呢？他这个地位就是类似达成一些自我追求和实现自己的一些价值，顺便解解闷，这种境界完全不是我们能比的了。反过来想想中国这个环境，多少人都是用代码来换取一份工作谋求生存，然后 35 岁干不动了可能就被辞退。本来想展开说说的，但是感觉说来都是痛，就不多说了，希望我将来不会为生活所迫，能够自由地继续追求自己热爱的东西。

另外本想说说 Guido 的履历的，但看到其他的一些文章已经整理得挺好了，我就不再重复了，大家想了解更多的话可以去看看 https://mp.weixin.qq.com/s/ZQJClbYiKP5cAnKjB_ZfUg。

总之，我就是来宣布这个和 Python 之父成为“同事”的开心的消息，值得纪念下，然后顺便期待下 Python 之父将来出新的杰作！

本章将告诉你该如何去对request模块进行二次封装，暂时并不会告诉你HTTP协议及原理、URL等相关。当然你会使用然后在来阅读此文章一定会另有所获。我已经迫不及待要告诉你这个小秘密，以及想与你交流了。没时间解释了，快来一起和我一起探讨相关的内容吧

官方文档对requests的定义为：Requests 唯一的一个非转基因的 Python HTTP 库，人类可以安全享用。

使用Python写做爬虫的小伙伴一定使用过requests这个模块，初入爬虫的小伙伴也一定写过N个重复的requests，这是你的疑问。当然也一直伴随着我，最近在想对requests如何进行封装一下，让他支持支持通用的函数。若需要使用，直接调用即可。

那么问题来了，如果要写个供自己使用通用的请求函数将会有几个问题

• requests的请求方式(GET\POST\INPUT等等)
• 智能识别网站的编码，避免出现乱码
• 支持文本、二进制(图片、视频等为二进制内容)
• 以及还需要傻瓜一点，那就是网站的Ua(Ua:User-Agent，基本上网站都会验证接受到请求的Ua。来初步判断是爬虫还是用户)

那么咱们就针对以上问题开干吧

Requests的安装

在确保python环境搭建完成后直接使用pip或者conda命令进行安装，安装命令如下：

1
2
3
4
5

pip install requests
conda install requests

# 或者下载过慢点话，可以使用国内的pip镜像源，例如:
pip install requests -i  https://pypi.tuna.tsinghua.edu.cn/simple/

安装完成后，效果图如下：

初探requests基本使用

HTTP 中最常见的请求之一就是 GET 请求，下面我们来详细了解利用 requests 库构建 GET 请求的方法。

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

import requests

response = requests.get('http://httpbin.org/get')

# 响应状态码
print("response.status_code:", response.status_code)
# 响应头
print("response.headers:", response.headers)
# 响应请求头
print("response.request.headers:", response.request.headers)
# 响应二进制内容
print("response.content:", response.content)
# 响应文本
print("response.text", response.text)

# 返回如下
response.status_code: 200
response.headers: {'Date': 'Thu, 12 Nov 2020 13:38:05 GMT', 'Content-Type': 'application/json', 'Content-Length': '306', 'Connection': 'keep-alive', 'Server': 'gunicorn/19.9.0', 'Access-Control-Allow-Origin': '*', 'Access-Control-Allow-Credentials': 'true'}
response.request.headers: {'User-Agent': 'python-requests/2.24.0', 'Accept-Encoding': 'gzip, deflate', 'Accept': '*/*', 'Connection': 'keep-alive'}
response.content: b'{\n  "args": {}, \n  "headers": {\n    "Accept": "*/*", \n    "Accept-Encoding": "gzip, deflate", \n    "Host": "httpbin.org", \n    "User-Agent": "python-requests/2.24.0", \n    "X-Amzn-Trace-Id": "Root=1-5fad3abd-7516d60b3e951824687a50d8"\n  }, \n  "origin": "116.162.2.166", \n  "url": "http://httpbin.org/get"\n}\n'
{
  "args": {},
  "headers": {
    "Accept": "*/*",
    "Accept-Encoding": "gzip, deflate",
    "Host": "httpbin.org",
    "User-Agent": "python-requests/2.24.0",
    "X-Amzn-Trace-Id": "Root=1-5fad3abd-7516d60b3e951824687a50d8"
  },
  "origin": "116.162.2.166",
  "url": "http://httpbin.org/get"
}

requests基本使用已经经过简单的测试了，是否有一点点feel呢？接下来我们直接将它封装为一个函数以供随时调用

示例如下