【npoi源码解析】【77主力源码】【人脸定位源码】取包裹源码_代取快递源码

来源:王者崛起指标源码

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 参数信息(在方法中调用的裹源npoi源码解析参数)

       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、77主力源码CTRL + 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 + ↑↑ 跳转到上一个方法

       、人脸定位源码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的区别详解

       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,svn上传源码 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

       重新配制一个已经安装的lorawan协议源码包裹,如果它使用的是 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的性能风险。

文章所属分类:百科频道,点击进入>>