在项目开发中统计代码行数的6种方式

Posted 前端江湖

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了在项目开发中统计代码行数的6种方式相关的知识,希望对你有一定的参考价值。

文章目录


上一篇文章介绍了,如何使用工具检测项目中的代码重复度,可见博文 使用jscpd统计代码重复度
本文将探索下,如何在前端项目统计代码的行数,目前博主所知的较方便的方式大概有6种,每种方式都对应的是不同的使用场景,下面将一一为大家介绍。

一、使用find和wc命令统计代码行数

直接在项目文件目录下使用命令行进行统计,是比较方便的,能统计所有的代码总行数、以及每个文件的行数、进行条件过滤统计等等,比如 findwc
findwc 两个命令是 LinuxUnix 系统中的常用命令,而在Windows系统下,如果安装了 Git,可以调出 Git Bash 工具,使用 findwc 命令统计代码行数。

Git Bash 可以在Windows系统中提供类似于 Unix shell 的命令行环境,包含了 GitUnix 工具常用的命令,方便管理、提高效率。

当前一般前端项目,核心业务代码基本都在 src 目录下,我们进入该目录,直接执行以下命令:

find . -type f -print | xargs wc -l

该命令,可以直接读取到所有的文件,并显示每个文件的代码行数,以及所有文件的总行数,如下图所示。


这是简单的文件读取,还可以通过各种条件过滤。

进行参数的过滤筛选

如进行文件格式过滤,以下命令只读取 .js.ts 格式的文件:

find . "(" -name "*.js" -or -name "*.ts" ")" -print | xargs wc -l

过滤代码文件中的空行,使用 grep -v "^$"

find . "(" -name "*.js" -or -name "*.ts" ")" -print | xargs | grep -v "^$" | wc -l

进行目录过滤,比如不统计 node_modules 目录:

find . -name "*.js" | grep -v "node_modules"  | xargs wc -l

命令参数简要说明

find:在给定路下寻找匹配的文件,-name表示文件名,-type文件类型
wc:统计文件中的文件行数、字数和字符数,-l统计文件的行数
grep:逐行搜索,找出匹配的内容,-v表示不匹配

在Windows下,还可以使用 PowerShell 命令行工具来统计项目的代码行数。

二、PowerShell工具统计代码行数

在项目的 src 目录下,我们只需要在该目录下运行 PowerShell 工具,打开命令行窗口,输入以下命令:

(Get-ChildItem -Recurse -File | Get-Content | Measure-Object).Count
## 63240

通过该命令,可以输出 src 目录下所有文件的行数总和,如果要过滤空行,可以使用 -Line 参数选项:

(Get-ChildItem -Recurse -File | Get-Content | Measure-Object -Line).Lines
## 58691

这里输出的就是不包含空行的代码行数。

条件过滤

如果要过滤文件格式,可以使用通配符:

(Get-ChildItem -Recurse "*.ts","*.js" | Get-Content | Measure-Object).Count

上面的格式过滤方式,无法使用路径,所以也可以使用 Where-Object 命令来过滤文件格式,可以限定路径为 .\\src,如下所示:

(Get-ChildItem .\\src -Recurse | Where-Object $_.Name -like "*.ts" -or $_.Name -like "*.js" | Get-Content | Measure-Object).Count

输出所有文件的行数

如果要输出每个文件的行数:

Get-ChildItem -Recurse -File | ForEach-Object Write-Output $_.FullName $(Get-Content $_.FullName | Measure-Object).Count

PowerShell相关命令的简要说明

Get-ChildItem:获取指定目录中的文件和子目录的列表。在 PowerShell 中还可以使用 dir 命令,效果差不多。
-Recurse:命令参数,用于在搜索目录时递归子目录。
Get-Content:读取文本文件的内容,包含文件行数、字符、字节等数据。
Measure-Object:用于对一组对象进行测量和计算,如进行求和。
Where-Object:根据指定条件筛选过滤对象集合的数据。
ForEach-Object:迭代命令,对于输入的对象组中的每个对象进行指定操作,可用于遍历文件。
Write-Output:将指定的字符串或值输出到 PowerShell 控制台。

三、git命令

除了以上两种命令行统计方案以外,还可以使用git命令来统计代码行数,命令也很简单,主要使用到以下两个命令:

  • git ls-files:列出项目中所有的文件,可用于查看项目中文件的代码行数和总代码行数。
  • git log:获取所有提交的历史记录,通过记录,统计分支下的修改代码的行数。

git ls-files

如下,统计项目中所有文件的总代码行数:

git ls-files | xargs cat | wc -l
## 58927

但需要注意的是:如果使用git统计,需要代码已经提交入库到git仓库,否则,统计命令会报错:

git ls-files | xargs cat | wc -l
## fatal: not a git repository (or any of the parent directories): .git

统计每个文件的代码行数,命令如下:

git ls-files | xargs wc -l


显示文件的行数以及总代码行数。

从上面命令可看出,使用 git ls-files 和前文提到的 find 较相似,也可以对它的结果进行过滤。

git ls-files '*.tsx' '*.js' | grep -v 'src/assets' | xargs wc -l

以上命令,统计文件格式为 .tsx.js 的文件,并且会过滤掉 src/assets 目录下的文件,可以通过这种方式进行自定义的筛选。

git log

也可以使用git log命令,统计对应分支下的修改代码的行数。

git log --no-merges --pretty=tformat: --numstat | awk ' add += $1; subs += $2; loc += $1 - $2  END  printf "added lines: %s, removed lines: %s, total lines: %s\\n", add, subs, loc '

这里统计了当前分支下的代码行数,包含增加的行数、删除的行数、以及代码总行数,如下图所示:


也可以增加一些参数,通过这些参数进行条件过滤:

–no-merges:是去除该提交中merges的代码,因为开发人员有可能会merge其他分支的代码,此时应该去除
–since= --until=:是要统计修改记录的开始和结束时间,当统计某个迭代,就是迭代开始时间和结束时间
–author:是指修改代码的人 过滤多人时使用 | 分开
–pretty=:控制显示的记录格式
–numstat:对增加和删除的行数进行统计 第一列显示的是增加的行数 第二列显示的是删除的行数

git log master --no-merges --since=2023-03-01 --until=2023-3-26 --author="zuozhe" --pretty=tformat: --numstat | awk ' add += $1 ; subs += $2 ; loc += $1 - $2  END  printf "added lines: %s removed lines : %s total lines: %s\\n",add,subs,loc '
## added lines: 28750 removed lines : 7767 total lines: 20983

如上命令所示,统计了 master 分支下,时间从 2023-03-012023-3-26之间,提交人为 zuozhe 的所有修改过的代码行数。

四、代码编辑器插件

现在的代码编辑器也有提供一些插件,用于统计代码行数,比如博主使用的 VS Code,就很方便。
这里介绍 VS Code Counter 插件,它能统计项目代码行数、注释行数、以及空行,并且还会展示每个文件的行数以及分不同格式的文件显示。

首先,在插件中心安装该插件,然后使用快捷键 ctrl + shift + p,在输入框选择 VSCodeCounter: Count lines in directory,接着会出现项目目录输入框,默认是当前工作目录,可以更改。



确定好项目路径以后,回车就会显示已选路径下的项目文件代码的统计行数,以 .md 文件的形式展示出来,如下图:


该插件会在当前目录下,生成一个名为 .VSCodeCounter 的目录,里面放置生成的各种代码统计数据,可以自行查询。

五、jscpd

前文提到上一篇博文有介绍如何统计代码重复度,使用了 jscpd 工具库,它当然也有统计项目代码行数的能力。
如下图所示,会显示整个项目总的代码行数,Total 行,更多的使用可查看上篇博文。

六、自己实现一个

除了使用以上5种方式以外,我们也可以自己动手,实现一个读取项目代码行数的工具。
而要想实现一个简单的代码行数的统计工具,只需要以下三个步骤:

  1. 迭代遍历项目目录下的所有文件
  2. 读取文件的内容,行数使用换行符 \\n 进行判断即可
  3. 计算所有的代码行数

对于前端同学,使用 nodejs 可以很好的完成这个事情,如迭代文件,代码如下:

// 可以通过执行命令传入目录参数
const params = process.argv.splice(2)
const root = params[0]

// 遍历读取文件
let stat = fs.statSync(root)
if (stat.isDirectory()) 
  let files = fs.readdirSync(root)
  for (let file of files) 
    file = `$root/$file`
    const dirStat = fs.statSync(file)
    if (dirStat.isDirectory()) 
      queryAllFiles(file)
     else 
      // 读取文件行数
    
  
 else 
  // 读取文件行数

下面是,读取文件内容和行数:

// 读取文件内容,通过 `\\n` 换行符分割内容后,统计长度,即行数
let fileContent = fs.readFileSync(path)  
fileContent = fileContent.toString()
const fileLines = fileContent.split('\\n')
const lines = fileLines.length
console.log(path + ' ' + lines)

读取了每一个文件的行数,我们只需要对它们进行累加就可以统计出总的代码行数。

注释和空行

还可以统计代码注释,这里以前端的JS代码为示例,使用正则表达式,判断一行代码是否注释:

const reg = new RegExp('^(//|/\\\\*|\\\\*|\\\\*/)', 'g')
const commentLines = fileLines.filter(line => reg.test(line.trimStart())).length

注意,这里注释的判断,使用的JS代码相关的注释方式:///***/,TS代码也一样适用。
如果是使用其他注释方式的代码,需要定义对应的过滤。

空行的判断,也很简单,只需要判断一行没有内容即可:

const blankLines = fileLines.filter(line => line.trim() === '').length

忽略目录和文件

如果还要加条件进行过滤筛选,也比较方便,只需要在循环迭代送文件时进行过滤。
比如我们需要忽略掉 'node_modules''dist'等目录:

// 定义过滤的目录,也可以使用配置文件、命令参数等方式
const ignores = ['node_modules', 'dist']

// 文件迭代时,忽略相应目录
for (let file of files) 
  const isNotIgnore = ignores.indexOf(file) > -1
  if (isNotIgnore) 
    continue
  
  // ...

筛选文件和目录的方式较类似,使用不同的比较方式而已。

文件格式的过滤:

// 只统计 js 和 ts 的代码文件
const formats = ['.js', '.ts']
if (stat.isFile()) 
  let ext = path.extname(file)
  if (formats.indexOf(ext) !== -1) 
    // 读取文件内容和行数
    // ...
  

看看简单的执行结果,如下图所示:

总结

六种不同的方式,都能方便的统计代码行数,但也各有特点。
find 命令行适用不同系统,而 PowerShell 在Windows系统下可用;jscpd 统计代码行数和重复度。
安装了 Git 工具的,可以使用 git log 统计代码的修改行数、不同人员和时间段的各种提交修改等。
代码编辑器,有各种插件工具,除了统计代码行数,还能区分文件格式、注释行数、空行,也比较直观方便。
自己实现一个统计工具,能够实现更多的功能,并进行定制化处理,或者集成到构建工具中等等,满足更多需求。

未解决对于使用Windows的IDEA进行编译的文件,但无法在Linux系统中统计代码行数的疑问

在我学习使用Windows的IDEA的过程中,将代码文件转移到Linux虚拟机当中,但无法在Linux系统中统计代码行数。

注意:拷贝进虚拟机的文件均能编译运行。

具体过程如下:

root@yogile-VirtualBox:/alive/string# ls
bin/  docs/  statistics.sh  string/  work/
##/shared/为虚拟机与宿主机的共享文件夹
root@yogile-VirtualBox:/alive/string# cp -r /shared/idea/ ./      ##步骤一
root@yogile-VirtualBox:/alive/string# ls
bin/  docs/  idea/  statistics.sh  string/  work/

root@yogile-VirtualBox:/alive/string# tree -a idea/
idea/
├── BorderOfP(n,m)
    ├── BorderOfP(n,m).iml
    ├── .idea
    │   ├── misc.xml
    │    ├── modules.xml
    │    ├── .name
    │    ├── vcs.xml
    │    └── workspace.xml
    ├── out
    │   └── production
    │       ├── BorderOfP(n,m)
    │       ├── Arrangement.class
    │       ├── factorial.class
    │       └── struct.class
    └── src
        ├── Arrangement.java
        ├── factorial.java
        └── struct.java

统计代码行数脚本statistics.sh来自使用码云和博客园学习简易教程,部分如下

#!/bin/sh
echo "//==========All================================="
echo "code summary infomation:"
find . -name "*.java"| xargs cat | grep -v ^$ | wc -l 
echo ""

然后执行脚本:

root@yogile-VirtualBox:/alive/string# ./statistics.sh
//==========All=================================
code summary infomation:
508
xargs: cat:因信号 13 而终止

注意 :在执行 <步骤一> 之前脚本运行结果如下:

root@yogile-VirtualBox:/alive/string# ./statistics.sh
//==========All=================================
code summary infomation:
508

这时,如果将idea/中的文件夹BorderOfP(n,m)/直接复制进string/文件夹中,再执行脚本则成功:

root@yogile-VirtualBox:/alive/string# cp -r idea/*/ string/
root@yogile-VirtualBox:/alive/string# tree -a strong/
string/
├── BorderOfP(n,m)
    ├── BorderOfP(n,m).iml
    ├── .idea
    │   ├── misc.xml
    │    ├── modules.xml
    │    ├── .name
    │    ├── vcs.xml
    │    └── workspace.xml
    ├── out
    │   └── production
    │       ├── BorderOfP(n,m)
    │       ├── Arrangement.class
    │       ├── factorial.class
    │       └── struct.class
    └── src
        ├── Arrangement.java
        ├── factorial.java
        └── struct.java

root@yogile-VirtualBox:/alive/string# ./statistics.sh
//==========All=================================
code summary infomation:
842
xargs: cat:因信号 13 而终止

这时,哪怕新建一个新的文件夹,将string/内的文件移动进去,依然为:

root@yogile-VirtualBox:/alive/string# mkdir retry
root@yogile-VirtualBox:/alive/string# mv string/*/ retry/
root@yogile-VirtualBox:/alive/string# ./statistics.sh
//==========All=================================
code summary infomation:
508
xargs: cat:因信号 13 而终止

在同样的条件下删除.idea文件夹依然不成功
在同样的条件下删除.xml文件依然不成功
在同样的条件下修改文件或文件夹权限依然不成功
在同样的条件下在脚本中添加\'-maxdepth\'依然不成功

这个问题依然无法解决,希望得到大佬们的解答。

以上是关于在项目开发中统计代码行数的6种方式的主要内容,如果未能解决你的问题,请参考以下文章

java中统计JTextArea中的行数有两个方法的问题!

C语言---统计字符串中统计单词个数

怎么用vba在excel中统计每列有多少行数

PyTorch中统计模块参数的学习笔记

如何在 Python 中统计比较两种不同线性回归模型的截距和斜率?

php中统计中文字符串长度的两种方法