在项目开发中统计代码行数的6种方式
文章目录
- 一、使用find和wc命令统计代码行数
- 进行参数的过滤筛选
- 命令参数简要说明
- 二、PowerShell工具统计代码行数
- 条件过滤
- 输出所有文件的行数
- PowerShell相关命令的简要说明
- 三、git命令
- git ls-files
- git log
- 四、代码编辑器插件
- 五、jscpd
- 六、自己实现一个
- 注释和空行
- 忽略目录和文件
- 总结
上一篇文章介绍了，如何使用工具检测项目中的代码重复度，可见博文 使用jscpd统计代码重复度。
本文将探索下，如何在前端项目统计代码的行数，目前博主所知的较方便的方式大概有6种，每种方式都对应的是不同的使用场景，下面将一一为大家介绍。
一、使用find和wc命令统计代码行数
直接在项目文件目录下使用命令行进行统计，是比较方便的，能统计所有的代码总行数、以及每个文件的行数、进行条件过滤统计等等，比如 find 和 wc。
find 和 wc 两个命令是 Linux 和 Unix 系统中的常用命令，而在Windows系统下，如果安装了 Git，可以调出 Git Bash 工具，使用 find 和 wc 命令统计代码行数。
Git Bash 可以在Windows系统中提供类似于 Unix shell 的命令行环境，包含了 Git 和 Unix 工具常用的命令，方便管理、提高效率。
当前一般前端项目，核心业务代码基本都在 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 += ; subs += ; loc += - } 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 += ; subs += ; loc += - } 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-01 到 2023-3-26之间，提交人为 zuozhe 的所有修改过的代码行数。
四、代码编辑器插件
现在的代码编辑器也有提供一些插件，用于统计代码行数，比如博主使用的 VS Code，就很方便。
这里介绍 VS Code Counter 插件，它能统计项目代码行数、注释行数、以及空行，并且还会展示每个文件的行数以及分不同格式的文件显示。
首先，在插件中心安装该插件，然后使用快捷键 ctrl + shift + p，在输入框选择 VSCodeCounter: Count lines in directory，接着会出现项目目录输入框，默认是当前工作目录，可以更改。
确定好项目路径以后，回车就会显示已选路径下的项目文件代码的统计行数，以 .md 文件的形式展示出来，如下图：
该插件会在当前目录下，生成一个名为 .VSCodeCounter 的目录，里面放置生成的各种代码统计数据，可以自行查询。
五、jscpd
前文提到上一篇博文有介绍如何统计代码重复度，使用了 jscpd 工具库，它当然也有统计项目代码行数的能力。
如下图所示，会显示整个项目总的代码行数，Total 行，更多的使用可查看上篇博文。
六、自己实现一个
除了使用以上5种方式以外，我们也可以自己动手，实现一个读取项目代码行数的工具。
而要想实现一个简单的代码行数的统计工具，只需要以下三个步骤：
- 迭代遍历项目目录下的所有文件
- 读取文件的内容，行数使用换行符 \n 进行判断即可
- 计算所有的代码行数
对于前端同学，使用 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 统计代码的修改行数、不同人员和时间段的各种提交修改等。
代码编辑器，有各种插件工具，除了统计代码行数，还能区分文件格式、注释行数、空行，也比较直观方便。
自己实现一个统计工具，能够实现更多的功能，并进行定制化处理，或者集成到构建工具中等等，满足更多需求。
还没有评论，来说两句吧...