compare-folders文档

欢迎广大开发者将此文档翻译为其他语言。

软件源安装

compare-folders可以通过NPM软件源安装。

通过NPM软件源安装compare-folders，代码如下：

$ npm i compare-folders

compare-folders可以通过Snap软件源安装。

通过Snap软件源安装compare-folders，代码如下：

$ sudo snap install compare-folders --edge

如何使用

点击左上角的按钮和左侧的按钮即可打开文件夹1和文件夹2，如图所示：

在打开文件夹1和文件夹2之后，左侧会显示文件夹1和文件夹2中的文件列表，如图所示：

左侧的按钮将显示文件夹1和文件夹2的路径

如果一个文件夹中有某个文件，而另一个文件夹中没有同名文件，则这个文件名将在文件列表中显示为

绿色

如果两个文件夹中均有同名文件，但两个文件的内容不同，则这个文件名将在文件列表中显示为

红色

如果两个文件夹中均有同名文件，且两个文件的内容相同，则这个文件名将在文件列表中显示为

透明色（黑色）

点击两个文件列表中的任意文件名即可对比两个文件

如果两个文件夹中均有同名文件，文件能够打开且不为空，则文件标题栏将显示“文件夹1：文件名”或“文件夹2：文件名”，文件窗口将显示文件内容

如果两个文件夹中均有同名文件，文件能够打开但为空，则文件标题栏将显示“（空文件）文件夹1：文件名”或“（空文件）文件夹2：文件名”，文件窗口将显示“无内容”报错

如果在点击文件名时，系统发生文件错误（例如文件夹中没有这个文件），则文件标题栏将显示“（文件错误）文件夹1：文件名”或“（文件错误）文件夹2：文件名”，文件窗口将显示“无内容”报错

文件按行进行对比

行号在文件窗口中显示为

靛蓝

如果行发生增加，则在行号前显示加号“+”，用

绿色

表示这种情况

如果行发生减少，则在行号前显示减号“-”，用

红色

表示这种情况

如果两行相同，则这行将在文件窗口中显示为

透明色（黑色）

如果文件夹1中的某个文件添加了一行，或者文件夹2中的某个文件删除了一行，则这行将在文件窗口1中显示为

红色

，这行将在文件窗口2中显示为

绿色

如果文件夹2中的某个文件添加了一行，或者文件夹1中的某个文件删除了一行，则这行将在文件窗口1中显示为

绿色

，这行将在文件窗口2中显示为

红色

如果文件修改了一行，则当前文件的这一行显示为

红色

，另一个文件的这一行显示为

绿色

下面使用10个文件作为文件对比的示范，如图所示：

对比两个相同的文件，如图所示：

一个文件夹中有某个文件，而另一个文件夹中没有同名文件，对比文件，如图所示：

文件夹1中的某个文件为空，文件夹2中的同名文件不为空，对比文件，如图所示：

文件夹1中的某个文件增加1行，文件夹2中的同名文件删除1行，对比文件，如图所示：

文件修改了一行，对比文件，如图所示：

点击最小化按钮即可最小化窗口，如图所示：

点击最大化/还原按钮即可最大化/还原窗口，如图所示：

点击关闭按钮即可退出程序，如图所示：

实用小技巧

文件窗口1中的行号对应文件2的真实行号

文件窗口2中的行号对应文件1的真实行号

一个文件去掉

红色

所在行，再加上

绿色

所在行，就能改为另一个文件

要想找到一个文件比另一个文件多的行，就找

红色

所在行

要想找到一个文件比另一个文件少的行，就找

绿色

所在行

要想找到某一行修改了哪里，

红色

是当前文件的版本，

绿色

是另一个文件的版本。在某一行有修改时，

红色

在上，

绿色

在下，直接可以看到同一行不同版本之间的区别，非常方便

开发环境

此软件要求Node版本大于等于22。

准备开发环境，代码如下：

$ npm i

调试代码如下：

$ npm start

打包代码如下：

$ npm run build

打包前要关闭占用8080端口的所有程序，否则将打包失败。

依赖库

electron

electron-builder

diff

winston

引用compare-folders

如果你在学术研究中涉及compare-folders，那么可以按需引用以下内容。

compare-folders源码(BibTeX)

@misc{CNOCTAVE2025, author = {Yu Hongbo, }, title = {compare-folders}, year = {2025}, howpublished = {\url{https://github.com/CNOCTAVE/compare-folders}}, }

compare-folders文档(BibTeX)

@techreport{CNOCTAVE2025, author = {Yu Hongbo, }, title = {compare-folders Document}, institution = {BA DU XIN SHANG}, year = {2025}, number = {7}, month = {2}, url = {https://cnoctave.github.io/compare-folders/index.html}, urldate = {2025-02-07}, }

compare-folders: An Open Source Folder and File Comparison Tool(BibTeX)

@article{https://doi.org/10.31224/4396, doi = {10.31224/4396}, url = {https://engrxiv.org/preprint/view/4396/7671}, author = {Yu Hongbo, }, keywords = {CNOCTAVE, compare-folders, folder comparison, file comparison, open-source, Electron}, title = {compare-folders: An Open Source Folder and File Comparison Tool}, publisher = {engrxiv}, year = {2025}, copyright = {Creative Commons Attribution 4.0 International} }