zh-CN 简体中文 项目首页 软件源安装 如何使用 开发环境 依赖库 引用compare-folders
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} }

© 2024-2025 CNOCTAVE © 2024-2025 Yu Hongbo