1.【转载】Pycharm快捷键整理
2.yum和apt-get的取包取快区别详解
3.抽丝剥茧：Electron与Node.js的奇葩Bug

【转载】Pycharm快捷键整理

       1、CTRL + ALT + SPACE 快速导入任意类

       2、裹源CTRL + SHIFT + ENTER 代码补全

       3、码代码SHIFT + F1 查看外部文档

       4、递源CTRL + Q 快速查找文档

       5、取包取快CTRL + P 参数信息(在方法中调用的裹源ios 赛车源码参数)

       6、CTRL + MOUSE OVER CODE 基本信息

       7、码代码CTRL + F1 显示错误或警告的递源描述

       8、CTRL + INSERT 生成代码

       9、取包取快CTRL + O 重载方法

       、裹源CTRL + ALT + T 包裹代码

       、码代码CTRL + / 单行注释

       、递源CTRL + SHIFT + / 块注释

       、取包取快CTRL + W 逐步选择代码(块)

       、裹源CTRL + SHIFT + W 逐步取消选择代码(块)

       、码代码CTRL + SHIFT + [ 从当前位置选择到代码块的开始

       、CTRL + SHIFT + ] 从当前位置选择到代码块的结束

       、ALT + ENTER 代码快速修正

       、CTRL + ALT + L 代码格式标准化

       、CTRL + ALT + O 最佳化导入

       、CTRL + ALT + I 自动缩进

       、TAB 代码向后缩进

       、SHIFT + TAB 代码向前取消缩进

       、CTRL + SHIFT + V 历史复制粘贴表

       、CTRL + D 复制当前代码行/块

       、CTRL + Y 删除当前代码行/块

       、CTRL + SHIFT + J 代码连接为一行

       、SHIFT + ENTER 开启新一行

       、CTRL + SHIFT + U 字母大写

       、CTRL +DELETE 向后逐渐删除

       、CTRL + BACKSPACE 向前逐渐删除

       、CTRL + NUMPAD+/- 代码块展开/折叠

       、CTRL + SHIFT + NUMPAD+ 所有代码块展开叠

       、CTRL + SHIFT + NUMPAD- 所有代码块折叠

       、CTRL + F4 关闭活动编辑窗口

       1、CTRL + F 查找

       2、F3 查找下一个

       3、SHIFT + F3 查找上一个

       4、CTRL + R 替换

       5、CTRL + SHIFT + F 指定路径下查找

       6、CTRL + SHIFT + R 指定路径下替换

       1、ALT + SHIFT + F 选择程序文件并运行代码

       2、ALT + SHIFT + F9 选择程序文件并调试代码

       3、SHIFT + F 运行代码

       4、SHIFT + F9 调试代码

       5、开源数控源码grblCTRL + SHIFT + F 运行当前编辑区的程序文件

       1、F8 单步

       2、F7 单步(无函数时同F8)

       3、SHIFT + F8 单步跳出

       4、ALT + F9 运行到光标所在位置处

       5、ALT + F8 测试语句

       6、F9 重新运行程序

       7、CTRL + F8 切换断点

       8、CTRL + F8 查看断点

       1、ALT + F7 查找应用

       2、CTRL + F7 在文件中查找应用

       3、CTRL + SHIFT + F7 在文件中高亮应用

       4、CTRL + ALT + F7 显示应用

       1、F5 复制文件

       2、F6 移动文件

       3、SHIFT + F6 重命名

       4、ALT + DELETE 安全删除

       5、CTRL + F6 改变函数形式参数

       6、CTRL + ALT + M 将代码提取为函数

       7、CTRL + ALT + V 将代码提取为变量

       8、CTRL + ALT + C 将代码提取为常数

       9、CTRL + ALT + F 将代码提取为字段

       、CTRL + ALT + P 将代码提取为参数

       1、CTRL + ALT + J 使用动态模板包裹

       2、CTRL + J 插入动态模板

       1、CTRL + N 进入类

       2、CTRL + SHIFT + N 进入文件

       3、CTRL + ALT + SHIFT + N 进入符号

       4、CTRL + ←← 进入上一个编辑位置

       5、CTRL + →→ 进入下一个编辑位置

       6、CTRL + →→ 进入下一个编辑位置

       7、SHIFT + ESC 隐藏活动/最后活动的窗口

       8、CTRL + SHIFT + F4 关闭活动的运行/消息/查找等窗口

       9、CTRL + G 显示光标所在行与列

       、CTRL + E 弹出最近打开的文件

       、CTRL + ALT + ←/→←/→ 向前/向后导航

       、CTRL + SHIFT + BACKSPACE 导航到最后编辑的位置

       、CTRL + B 跳转到声明部分

       、CTRL + CLICK(鼠标左键) 跳转到声明部分

       、CTRL + ALT + B 跳转到代码实施部分

       、CTRL + SHIFT + I 打开快速定义查找

       、CTRL + SHIFT + B 跳转到类型说明

       、CTRL + U 跳转超类/方法

       、CTRL + ↑↑ 跳转到上一个方法

       、iapp滑动窗口源码CTRL + ↓↓ 跳转到下一个方法

       、CTRL + [ 跳转到代码块的开头

       、CTRL + ] 跳转到代码块的结尾

       、CTRL + F 弹出文件结构

       、CTRL + H 弹出类层次结构

       、CTRL + SHIFT + H 弹出方法层次结构

       、CTRL + ALT + H 弹出调用层次结构

       、F2 / SHIFT + F2 下一个/上一个错误

       、F4 查看源代码

       、ALT + HOME 显示导航栏

       、F2 / SHIFT + F2 下一个/上一个错误

       、F 增加书签

       、CTRL + F 增加数字/字母书签

       、CTRL + SHIFT + [1-9] 增加数字书签

       、SHIFT + F 显示书签

       1、ALT + [0-9] 打开相应的工具窗口

       2、CTRL + ALT + Y 同步

       3、CTRL + SHIFT + F 最大化编辑器

       4、ALT + SHIFT + F 添加到收藏夹

       5、ALT + SHIFT + I 使用当前配置文件检查当前文件

       6、CTRL + ALT + S 快速出现设置对话框

       7、CTRL + SHIFT + A 查找并调试编辑器的功能

       8、ALT + TAB 在选项卡和工具窗口之间切换

yum和apt-get的区别详解

       一般来说著名的linux系统基本上分两大类：

       1.RedHat系列：Redhat、Centos、Fedora等

       2.Debian系列：Debian、Ubuntu等

RedHat 系列

       1 常见的安装包格式 rpm包,安装rpm包的命令是rpm -参数

       2 包管理工具 yum

       3 支持tar包

Debian系列

       1 常见的安装包格式 deb包,安装deb包的命令是dpkg -参数

       2 包管理工具 apt-get

       3 支持tar包

       tar 只是一种压缩文件格式，所以，它只是把文件压缩打包而已。

       rpm 相当于windows中的安装文件，它会自动处理软件包之间的依赖关系。

       优缺点来说，rpm一般都是预先编译好的文件，它可能已经绑定到某种CPU或者发行版上面了。

       tar一般包括编译脚本，你可以在你的环境下编译，所以具有通用性。

       如果你的包不想开放源代码，你可以制作成rpm，如果开源，用tar更方便了。

       tar一般都是源码打包的软件，需要自己解包，然后进行安装三部曲，./configure,asp 源码试题管理 make, make install.　来安装软件。

       rpm是redhat公司的一种软件包管理机制，直接通过rpm命令进行安装删除等操作，最大的优点是自己内部自动处理了各种软件包可能的依赖关系。

       -------------------------------- *.rpm形式的二进制软件包[centos]

       安装：rpm -ivh *.rpm

       卸载：rpm -e packgename

       rpm -q nginx 查看是否已经安装

       　升级：rpm -Uvh xxx

       　查询：

       查询所有安装的包： rpm -qa

       查询某个包：rpm -qa | grep xxx

       rpm -qi xxx

       查询软件的安装路径：rpm -ql xxx

       rpm -qc xxx

       查询某个文件是那个rpm包产生：rpm -qf /etc/yum.conf

       rpm -qpi xxx

       rpm -qa|grep php 查看已安装的RMP包

       安装：rpm -ivh xxx

       移除：rpm -e xxx

       升级：rpm -Uvh xxx

       查询：

       查询所有安装的包： rpm -qa

       查询某个包：rpm -qa | grep xxx

       rpm -qi xxx

       查询软件的安装路径：rpm -ql xxx

       rpm -qc xxx

       查询某个文件是那个rpm包产生：rpm -qf /etc/yum.conf

       rpm -qpi xxx

       -------------------------------- src.rpm 源代码分发软件包的安装与卸载

       Linux软件的源代码分发是指提供了该软件所有程序源代码的发布形式，需要用户自己编译成可执行的二进制代码并进行安装，其优点是配置灵活，可以随意去掉或保留某些功能/模块，适应多种硬件/操作系统平台及编译环境，缺点是难度较大，一般不适合初学者使用。

       1、*.src.rpm形式的源代码软件包

       安装：rpm -rebuild *.src.rpm

       cd /usr/src/dist/RPMS

       rpm -ivh *.rpm

       卸载：rpm -e packgename

       说明：rpm rebuild *.src.rpm命令将源代码编译并在/usr/src/dist/RPMS下生成二进制的rpm包，然后再安装该二进制包即可。packgename如前所述。

       --------------------------------dpkgubuntu

       dpkg -l | grep 'php' 使用dpkg -l 来查看已经安装了的软件

       dpkg 是Debian[待宾] Package 的简写。为 Debian 专门开发的套件管理系统，方便软件的安装、更新及移除。所有源自Debian的Linux 发行版都使用 dpkg，例如 Ubuntu、Knoppix 等。

       以下是一些 Dpkg 的普通用法：

       1、dpkg -i package.deb

       安装一个 Debian 软件包，如你手动下载的文件。

       2、dpkg -c package.deb

       列出 package.deb 的内容。

       3、dpkg -I package.deb

       从 package.deb 中提取包裹信息。

       4、dpkg -r package

       移除一个已安装的包裹。

       5、dpkg -P package

       完全清除一个已安装的包裹。和 remove 不同的是，remove 只是删掉数据和可执行文件，purge 另外还删除所有的配制文件。

       6、dpkg -L package

       列出 package 安装的所有文件清单。同时请看 dpkg -c 来检查一个 .deb 文件的内容。

       7、dpkg -s package

       显示已安装包裹的信息。同时请看 apt-cache 显示 Debian 存档中的包裹信息，以及 dpkg -I 来显示从一个 .deb 文件中提取的包裹信息。

       8、dpkg-reconfigure package

       重新配制一个已经安装的max30100源码包裹，如果它使用的是 debconf (debconf 为包裹安装提供了一个统一的配制界面)。

       -------------------------------- 使用yum和apt-get。软件管理方法的升级.

       yum的配置文件是/etc/yum.conf

1. 我们来先讲Redhat的yum 这种高级的包管理.

       yum install gcc [centos]

       更新：yum update

       安装：yum install xxx

       移除：yum remove xxx

       清除已经安装过的档案（/var/cache/yum/）：yum clean all

       搜寻：yum search xxx

       列出所有档案：yum list

       查询档案讯息：yum info xxx

       #sudo -s

       #LANG=C

       #yum -y install gcc gcc-c autoconf libjpeg libjpeg-devel libpng libpng-devel freetype freetype-devel libpng libpng-devel libxml2 libxml2-devel zlib zlib-devel glibc glibc-devel glib2 glib2-devel bzip2 bzip2-devel ncurses ncurses-devel curl curl-devel

       用YUM安装软件包

       yum -y package_name

       命令：yum install package_name

       用YUM删除软件包

       命令：yum remove package_name

       yum -y remove httpd

       命令：yum search keyword

       列出所有可安装的软件包

       命令：yum list

       yum list php

       列出所有可更新的软件包

       命令：yum list updates

       列出所有已安装的软件包

       命令：yum list installed

       列出所有已安装但不在 Yum Repository 内的软件包

       命令：yum list extras

       列出所指定的软件包

       命令：yum list package_name

       yum = Yellow dog Updater, Modified

       主要功能是更方便的添加/删除/更新RPM包.

       它能自动解决包的倚赖性问题.

       它能便于管理大量系统的更新问题

       yum特点

       可以同时配置多个资源库(Repository)

       简洁的配置文件(/etc/yum.conf

       自动解决增加或删除rpm包时遇到的倚赖性问题

       使用方便

       保持与RPM数据库的一致性

       yum安装

       CentOS 自带(yum-*.noarch.rpm)

       #rpm -ivh yum-*.noarch.rpm

       在第一次启用yum之前首先需要导入系统的RPM-GPG-KEY：

       #rpm --import /usr/share/doc/centos-release-3(4)/RPM-GPG-KEY-CentOS-3(4)

       yum指令

       注:当第一次使用yum或yum资源库有更新时,yum会自动下载 所有所需的headers放置于/var/cache/yum目录下,所需时间可能较长.

       rpm包的更新

       检查可更新的rpm包

       #yum check-update

       更新所有的rpm包

       #yum update

       更新指定的rpm包,如更新kernel和kernel source

       #yum update kernel kernel-source

       大规模的版本升级,与yum update不同的是,连旧的淘汰的包也升级

       #yum upgrade

       rpm包的安装和删除

       安装rpm包,如xmms-mp3

       #yum install xmms-mp3

       删除rpm包,包括与该包有倚赖性的包

       #yum remove licq

       注:同时会提示删除licq-gnome,licq-qt,licq-text

       yum暂存(/var/cache/yum/)的相关参数

       清除暂存中rpm包文件

       #yum clean packages

       清除暂存中rpm头文件

       #yum clearn headers

       清除暂存中旧的rpm头文件

       #yum clean oldheaders

       清除暂存中旧的rpm头文件和包文件

       #yum clearn 或#yum clearn all

       注:相当于yum clean packages + yum clean oldheaders

       包列表

       列出资源库中所有可以安装或更新的rpm包

       #yum list

       列出资源库中特定的可以安装或更新以及已经安装的rpm包

       #yum list mozilla#yum list mozilla

       注:可以在rpm包名中使用匹配符,如列出所有以mozilla开头的rpm包

       列出资源库中所有可以更新的rpm包

       #yum list updates

       列出已经安装的所有的rpm包

       #yum list installed

       列出已经安装的但是不包含在资源库中的rpm包

       #yum list extras

       注:通过其它网站下载安装的rpm包

       rpm包信息显示(info参数同list)

       列出资源库中所有可以安装或更新的rpm包的信息

       #yum info

       列出资源库中特定的可以安装或更新以及已经安装的rpm包的信息

       #yum info mozilla#yum info mozilla

       注:可以在rpm包名中使用匹配符,如列出所有以mozilla开头的rpm包的信息

       列出资源库中所有可以更新的rpm包的信息

       #yum info updates

       列出已经安装的所有的rpm包的信息

       #yum info installed

       列出已经安装的但是不包含在资源库中的rpm包的信息

       #yum info extras

       注:通过其它网站下载安装的rpm包的信息

       搜索rpm包

       搜索匹配特定字符的rpm包

       #yum search mozilla

       注:在rpm包名,包描述等中搜索

       搜索有包含特定文件名的rpm包

       #yum provides realplay

       增加资源库

       例如:增加rpm.livna.org作为资源库

       安装Livna.org rpms GPG key

       #rpm --import http://rpm.livna.org/RPM-LIVNA-GPG-KEY

       检查GPG Key

       # rpm -qa gpg-pubkey

       显示Key信息

       #rpm -qi gpg-pubkey-ab1ec-3f6ed5

       (注:如果要删除Key,使用#rpm -e gpg-pubkey-ab1ec-3f6ed5)

       yum常用的命令

       # yum install xxx 安装xxx软件

       # yum info xxx 查看xxx软件的信息

       # yum remove xxx 删除软件包

       # yum list 列出软件包

       # yum clean 清除缓冲和就的包

       # yum provides xxx 以xxx为关键字搜索包（提供的信息为关键字）

       # yum search xxx 搜索软件包（以名字为关键字）

       # yum groupupdate xxx

       # yum grouplist xxx

       # yum groupremove xxx

       这三个都是一组为单位进行升级 列表和删除的操作。。比如 Mysql Database就是一个组会同时操作相关的所有软件包；

       # yum update 系统升级

       # yum list available 列出所有升级源上的包；

       # yum list updates 列出所有升级源上的可以更新包；

       # yum list installed 列出已经安装的包；

       # yun update kernel 升级内核；

       yum常用的源

       1) 自动选择最快的源

       由于yum中有的mirror速度是非常慢的，如果yum选择了这个mirror，这个时候yum就会非常慢，对此，可以下载fastestmirror插件，它会自动选择最快的mirror：

       #yum install yum-fastestmirror

       配置文件：（一般不用动）/etc/yum/pluginconf.d/fastestmirror.conf

       你的yum镜像的速度测试记录文件：/var/cache/yum/timedhosts.txt

       (2)使用图形界面的yum

       如果觉得命令行的yum不方便，那么可以使用图形化的yumex，这个看起来更方便，因为可以自由地选择软件仓库：

       #yum install yumex

       然后在系统工具中就可以看到yum extender了。实际上系统自带的添加/删除程序也可以实现图形化的软件安装，但有些yumex的功能它没有。

2.讲讲Ubuntu中的高级包管理方法apt-get

       配置文件/etc/apt/sources.list

       对于Server版， 推荐使用aptitude来查看，安装、删除deb包

       sudo apt-get install aptitude

       然后执行 sudo aptitude 进入管 理

       也可以使用命令：

       aptitude update 更新可用的包列表

       aptitude upgrade 升级可用的包

       aptitude dist-upgrade 将系统升级到新的发行版

       aptitude install pkgname 安装包

       aptitude remove pkgname 删除包

       aptitude purge pkgname 删除包及其配置文件

       aptitude search string 搜索包

       aptitude show pkgname 显示包的详细信息

       aptitude clean 删除下载的包文件

       aptitude autoclean 仅删除过期的包文件

       考虑到系统的兼容性,并且上面的东东比较都大,不找最新版本了，直接用apt-get install XXX 来安装.因为我们的Ubuntu是dailyBulid的,所以光盘的内容基本上都是最新的了,无需重新下载.一定要最新版本的话，不妨先apt-get update 来更新一下软件的仓库,然后再 apt-get install.

常用的APT命令参数：

       apt-cache search package 搜索包

       apt-cache show package 获取包的相关信息，如说明、大小、版本等

       sudo apt-get install package 安装包

       sudo apt-get install package - - reinstall 重新安装包

       sudo apt-get -f install 修复安装-f = fix-missing

       sudo apt-get remove package 删除包

       sudo apt-get remove package - - purge 删除包，包括删除配置文件等

       sudo apt-get update 更新源

       sudo apt-get upgrade 更新已安装的包

       sudo apt-get dist-upgrade 升级系统

       sudo apt-get dselect-upgrade 使用 dselect 升级

       apt-cache depends package 了解使用依赖

       apt-cache rdepends package 是查看该包被哪些包依赖

       sudo apt-get build-dep package 安装相关的编译环境

       apt-get source package 下载该包的源代码

       sudo apt-get clean sudo apt-get autoclean 清理无用的包

       sudo apt-get check 检查是否有损坏的依赖

抽丝剥茧：Electron与Node.js的奇葩Bug

       起因是最近在用Electron开发一个桌面端项目，有个需求是需要遍历某个文件夹下的所有JavaScript文件，对它进行AST词法语法分析，解析出元数据并写入到某个文件里。需求整体不复杂，只是细节有些麻烦，当我以为开发的差不多时，注意到一个匪夷所思的问题，查的我快怀疑人生。

       缘起

       什么问题呢？

       原来这个需求一开始仅是遍历当前文件夹下的文件，我的获取所有JS文件的代码是这样的：

       后来需求改为要包含文件夹的子文件夹，那就需要进行递归遍历。按照我以前的做法，当然是手撸一个递归，代码并不复杂，缺点是递归可能会导致堆栈溢出：

       但做为一个紧跟时代浪潮的开发者，我知道Node.js的fs.readdir API中加了一个参数recursive，表示可以进行递归，人家代码的鲁棒性肯定比我的好多了：

       只改了一行代码，美滋滋~

       兼容性怎么样呢？我们到Node.js的API文档里看下：

       是从v..0添加的，而我本地使用的Node.js版本正是这个（好巧），我们Electron中的Node.js版本是多少呢？先看到electron的版本是.0.4：

       在Electron的 发布页上能找到这个版本对应的是..1，比我本地的还要多一个小版本号：

       这里需要说明一下，Electron之所以优于WebView方案，是因为它内置了Chrome浏览器和Node.js，锁定了前端与后端的版本号，这样只要Chrome和Node.js本身的跨平台没有问题，理论上Electron在各个平台上都能获得统一的UI与功能体验。 而以Tauri为代表的WebView方案，则是不内置浏览器，应用程序使用宿主机的浏览器内核，开发包的体积大大减小，比如我做过的同样功能的一个项目，Electron版本有M+，而Tauri的只有4M左右。虽然体积可以这么小，又有Rust这个性能大杀器，但在实际工作中的技术选型上，想想各种浏览器与不同版本的兼容性，换我也不敢头铁地用啊！ 所以，尽管Electron有这样那样的缺点，仍是我们开发客户端的不二之选。 之所以提这个，是因为读者朋友需要明白实际项目运行的是Electron内部的Node.js，而我们本机的Node.js只负责启动Electron这个工程。

       以上只是为了说明，我这里使用fs.readdir这个API新特性是没有问题的。

       排查

       为方便排查，我将代码再度简化，提取一个单独的文件中，被Electron的Node.js端引用：

       能看到控制台打印的 Node.js 版本与我们刚才查到的是一样的，文件数量为2：

       同样的代码使用本机的Node.js执行：

       难道是这个小版本的锅？按理说不应该。但为了排除干扰，我将本机的Node.js也升级为..1：

       这下就有些懵逼了！

       追踪

       目前来看，锅应该是Electron的。那么第一思路是什么？是不是人家已经解决了啊？我要不要先升个级？

       没毛病。

       升级Electron

       将Electron的版本号换成最新版本v.1.0：

       再看效果：

       我去，正常了！

       不过，这个包的升级不能太草率，尤其正值发版前夕，所以还是先改代码吧，除了我上面手撸的代码外，还有个包readdirp也可以做同样的事情：

       这两种方式，在原版本的Electron下都没有问题。

       GitHub上搜索

       下来接着排查。

       Electron是不是有人发现了这个Bug，才进行的修复呢？

       去 GitHub issue里瞅一瞅：

       没有，已经关闭的问题都是年提的问题，而我们使用的Electron的版本是年月日发布的。 那么就去 代码提交记录里查下（GitHub这个功能还是很好用的）：

       符合条件的就一条，打开看下：

       修复的这个瞅着跟我们的递归没有什么关系嘛。

       等等，这个文件是什么鬼？

       心血来潮的收获

       我们找到这个文件，目录在lib下：

       从命名上看，这个文件是对Node.js的fs模块的一个包装。如果你对Electron有了解的话，仔细一思索，就能理解为什么会有这么个文件了。我们开发时，项目里会有许多的资源，Electron的Node.js端读取内置的文件，与正常Node.js无异，但事实上，当我们的项目打包为APP后，文件的路径与开发状态下完全不一样了。所以Electron针对打包后的文件处理，重写了fs的各个方法。

       这段代码中重写readdir的部分如下：

       上面的判断isAsar就是判断是否打包后的归档文件，来判断是否要经Electron特殊处理。如果要处理的话，会调用Electron内部的C++代码方法进行处理。

       我发现，这里Electron并没有对打包后的归档文件处理递归参数recursive，岂不是又一个Bug？应该提个issue提醒下。

       不过，我们目前的问题，并不是它造成的，因为现在是开发状态下，上面代码可以简化为：

       对Promise了如指掌的我怎么看这代码也不会有问题，只是心血来潮执行了一下：

       我去，差点儿脑溢血！

       好的一点是，曙光似乎就在眼前了！事实证明，心血来潮是有用的！

       Node.js的源码

       这时不能慌，本地切换Node.js版本为v，同样的代码再执行下：

       这说明Electron是被冤枉的，锅还是Node.js的！

       Node.js你这个浓眉大眼的，居然也有Bug！呃，还偷偷修复了！

       上面的情况，其实是说原生的fs.readdir有问题：

       也就是说，fs.promises.readdir并不是用util.promisify(fs.readdir)实现的！

       换成同步的代码readdirSync，效果也是一样：

       我们来到Node.js的GitHub地址，进行 搜索：

       打开这两个文件，能发现，二者确实是不同的实现，不是简单地使用util.promisify进行转换。

       fs.js

       我们先看 lib/fs.js。

       当recursive为true时，调用了一个readdirSyncRecursive函数，从这个命名上似乎可以看出有性能上的隐患。正常来说，这个函数是异步的，不应该调用同步的方法，如果文件数量过多，会把主进程占用，影响性能。

       如果没有recursive，则是原来的代码，我们看到binding readdir这个函数，凡是binding的代码，应该就是调用了C++的底层库，进行了一次『过桥』交互。

       我们接着看readdirSyncRecursive，它的命名果然没有毛病，binding readdir没有第4个参数，是完全同步的，这个风险是显而易见的：

       fs/promises.js

       在lib/internal/fs/promises.js中，我们看到binding readdir的第4个参数是kUsePromises，表明是个异步的处理。

       当传递了recursive参数时，将调用readdirRecursive，而readdirRecursive的代码与readdirSyncRecursive的大同小异，有兴趣的可以读一读：

       fs.js的提交记录

       我们搜索readdir的提交记录，能发现这两篇都与深度遍历有关：

       其中 下面的这个，正是我们这次问题的罪魁祸首。

       刚才看到的fs.js中的readdirSyncRecursive里这段长长的注释，正是这次提交里添加的：

       从代码对比上，我们就能看出为什么我们的代码遍历的程序为2了，因为readdirResult是个二维数组，它的长度就是2啊。取它的第一个元素的长度才是正解。坑爹！

       也就是说，如果不使用withFileTypes这个参数，得到的结果是没有问题的：

       发版记录

       我们在Node.js的发版记录中，找到这条提交记录，也就是说，v..0才修复这个问题。

       而Electron只有Node.js更新到v后，这个功能才修复。

       而从Electron与Node.js的版本对应上来看，得更新到v了。

       只是需要注意的是，像前文提过的，如果是遍历的是当前项目的内置文件，Electron并没有支持这个新的参数，在打包后会出现Bug。

       fs的同步阻塞

       其实有人提过一个 issue：

       确实是个风险点。所以，建议Node.js开发者老老实实使用fs/promises代替fs，而Electron用户由于坑爹的fs包裹，还是不要用这个特性了。

       总结

       本次问题的起因是我的一个Electron项目，使用了一个Node.js fs API的一个新参数recursive递归遍历文件夹，偶然间发现返回的文件数量不对，就开始排查问题。

       首先，我选择了升级Electron的包版本，发现从v.0.4升级到最新版本v.1.0后，问题解决了。但由于发版在即，不能冒然升级这么大件的东西，所以先使用readdirp这个第三方包处理。

       接着排查问题出现的原因。我到Electron的GitHub上搜索issue，只找到一条近期的提交，但看提交信息，不像是我们的目标。我注意到这条提交的修改文件（asar-fs-wrapper.ts），是Electron针对Node.js的fs API的包装，意识到这是Electron为了解决打包前后内置文件路径的问题，心血来潮之下，将其中核心代码简化后，测试发现问题出在fs.promises readdir的重写上，继而锁定了Node.js版本v..1的fs.readdir有Bug。

       下一步，继续看Node.js的源码，确定了fs.promises与fs是两套不同的实现，不是简单地使用util.promisify进行转换。并在fs的代码找到关于recursive递归的核心代码readdirSyncRecursive。又在提交记录里，找到这段代码的修复记录。仔细阅读代码对比后，找到了返回数量为2的真正原因。

       我们在Node.js的发版记录中，找到了这条记录的信息，确定了v..0才修复这个问题。而内嵌Node.js的Electron，只有v版本起才修复。

       不过需要注意的是，如果是遍历的是当前项目的内置文件，由于Electron并没有支持这个新的参数，在打包后会出现Bug。而且由于fs.readdir使用recursive时是同步的，Electron重写的fs.promises readdir最终调用的是它，可能会有隐性的性能风险。

       本次定位问题走了些弯路，一开始将目标锁定到Electron上，主要是它重写fs的锅，如果我在代码中用的fs.readdirSync，那么可能会更早在Node.js上查起。谁能想到我调用的fs.promises readdir不是真正的fs.promises readdir呢？

       最后，针对此次问题，我们有以下启示：

       PS：我给Electron提了个 issue，一是让他们给fs.readdir添加recursive参数的实现，二是让他们注意下重写时fs.promises readdir的性能风险。