如何在VSCode中一键统计整个项目的总代码行数
Tokei是统计项目代码行数最准最快工具,自动识别语言、剔除注释与空行、遵守.gitignore;安装后运行tokei即可获精确code/comment/blank分项统计。

免费影视、动漫、音乐、游戏、小说资源长期稳定更新! 👉 点此立即查看 👈
用 tokei 命令行工具最准也最快
想在VSCode里统计整个项目的代码行数?你会发现自带的计数器只对单个文件有效。这时候,就得请出外部工具了。而在众多选择中,tokei 凭借其轻量和精准,几乎成了不二之选。它能自动识别编程语言、聪明地跳过注释和空行、严格遵守 .gitignore 规则,而且完全不需要你事先配置任何项目文件。
安装之后,用法简单到极致:直接在项目根目录下运行命令就行。
tokei
如果还没安装,各平台都很方便:macOS 用 brew install tokei,Windows 用 choco install tokei,Linux 用户则可以通过 cargo install tokei 来获取。
- 默认输出会清晰列出代码行(
code)、注释行(comment)和空白行(blank),我们通常最关注的就是code这一列。 - 加上
--output json参数,可以直接导出结构化的结果,方便后续用脚本做进一步处理。 - 最省心的是,它会自动读取项目的
.gitignore文件,像node_modules这类目录根本无需你手动排除。
VSCode 内一键触发:配个自定义任务
是不是觉得每次都要切换到终端有点麻烦?完全可以在VSCode内部绑定一个快捷键,一键运行 tokei。秘诀就在于利用VSCode的自定义任务功能。
操作起来也不复杂:在项目根目录下,创建或编辑 .vscode/tasks.json 文件,然后把下面的配置填进去。
{
"version": "2.0.0",
"tasks": [
{
"label": "count lines",
"type": "shell",
"command": "tokei",
"group": "build",
"presentation": {
"echo": true,
"reveal": "always",
"focus": false,
"panel": "shared",
"showReuseMessage": true,
"clear": true
}
}
]
}
- 保存后,按下
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(Mac),调出命令面板,输入Tasks: Run Task然后选择count lines任务即可。 - 想绑定到专属快捷键?打开键盘快捷方式设置(
Ctrl+K Ctrl+S),搜索类似workbench.action.terminal.runActiveFile的动作进行绑定。但要注意,为了可靠控制,最好绑定到workbench.action.terminal.runSelectedText或通过扩展自定义命令。 - 这里有个关键点:任务类型务必设为
"shell"。如果错用"process"类型,它可能无法正确识别shell别名或管道命令,导致tokei调用失败。
别信插件:CodeMetrics 和 Project Statistics 都不准
看到这里,你可能会想:VSCode插件商店里不是有现成的统计插件吗?何必这么麻烦。但经验表明,这条路往往不准。像常见的 CodeMetrics 或 Project Statistics 这类插件,其原理大多是递归读取文件并进行简单计数。
问题恰恰出在这里:它们通常不会自动剔除依赖目录(如 vendor),无法区分注释行和空行,也不遵守 .gitignore 规则。举个例子,CodeMetrics 会把 node_modules 里成千上万的 .js 文件全部计入,仅仅一次 npm install 就可能导致你的项目“代码行数”虚增几十万行,这显然失去了统计意义。
Project Statistics插件默认会统计所有扩展名的文件。即便你的项目主要是Python,它也会把.log、.md甚至.zip文件都扫一遍。- 对于混合语言文件(例如
.vue文件中的和区块),这些插件缺乏识别能力,经常把模板语法也误判为Ja vaScript代码。 - 此外,它们普遍没有增量缓存机制,每次点击统计都会重新遍历整个项目目录树,在大型项目上会造成明显的卡顿。
要精确统计某类文件?用 tokei 加过滤参数
实际开发中,我们常常需要更精细的统计。比如,只想看 src/ 目录下TypeScript业务代码的行数,要排除测试文件和类型声明文件。这种需求,靠插件的简单勾选很难实现,但 tokei 的原生过滤功能可以轻松搞定。
举个例子,只统计 src/ 目录下的 .ts 和 .tsx 文件,同时跳过 test/ 和 types/ 目录,可以这样写:
tokei src --exclude test --exclude types --languages TypeScript
- 注意,
--exclude参数后面跟的是路径前缀,而不是glob模式。直接写--exclude test比写--exclude src/test更稳妥,因为tokei默认从当前目录开始扫描。 --languages参数对大小写敏感,必须写成TypeScript,写成typescript或ts是无效的。- 如果想排除所有的
.d.ts声明文件怎么办?由于它们也属于TypeScript语言范畴,无法通过语言类型单独过滤。可行的办法是通过路径排除,例如--exclude types。
话说回来,真正棘手的往往是那些隐形的依赖结构。比如在monorepo项目中,包含多个 packages/xxx 子目录,tokei 并不会自动识别Lerna或pnpm的工作区配置。这时候就需要手动列出所有需要统计的路径,或者写一个shell循环来遍历,否则很容易漏算一半的代码,这一点特别容易被忽略。
相关攻略
Ctrl+P搜不到文件?问题可能出在工作区索引上 遇到Ctrl+P搜不到文件的情况,先别急着怀疑快捷键失灵。十有八九,问题根源在于文件压根没被索引进工作区。这个功能依赖的是对当前工作区的完整索引,而非全局磁盘扫描。 Ctrl+P搜不到文件的三个典型原因 VSCode的Ctrl+P(在macOS上是C
VSCode状态栏消失通常因误触发View: Toggle Status Bar命令、进入Zen Mode或系统全屏模式,而非崩溃;恢复只需再次执行该命令、退出Zen Mode(Esc)或取消F11全屏。 先别慌,VSCode的状态栏其实不是“丢了”,它大概率只是被关掉了。绝大多数情况下,这都是一次
VSCode中FastAPI接口不提示async await,根本原因是Pylance默认未开启异步函数深度推导,需启用类型检查、显式标注返回类型、规范Pydantic联合类型写法、避免async中混用yield。 VSCode里FastAPI接口不提示async await怎么办 很多开发者都遇到
VSCode启动慢?问题可能出在这些“隐形”的内置扩展上 说到VSCode启动慢,很多人第一反应就是去排查第三方插件。这思路没错,但方向可能偏了。真正拖慢冷启动速度的“主力”,往往是那几个默认启用、自带激活事件、且从不提醒你它在后台干活的内置扩展。 VSCode启动慢主因是内置扩展强制onStart
怎么为VSCode添加个性化背景图-Background插件配置方法 想给VSCode编辑器换个背景图,提升一下写代码的“氛围感”?这事儿,VSCode本身并不支持。你可能试过硬改CSS,或者在workbench colorCustomizations里寻找backgroundImage选项,但结果
热门专题
热门推荐
迎着夏天的到来 春日的温婉脚步刚刚远去,夏天这个顽皮的孩子,便像发现了心爱的游乐场,迫不及待地、欢天喜地地奔涌而来。 山野之间,大树早已披上浓密的绿装。这种时候,蘑菇们又怎会错过自己的天然乐园?伴着风雨的呼唤,它们便戴着一顶顶“小帽子”,像跳高运动员似的从泥土里一跃而出。瞧瞧那模样,东张西望,仿佛怀
我爱那繁花似锦,百花争奇斗艳的春天,我爱那硕果累累,显出一派丰收之景的秋天,我爱那白雪皑皑,到处银装素裹的冬天,但我更爱那绿树成荫、植物郁郁葱葱、生机勃勃的夏天。 瞧,美丽动人的春姑娘前脚刚走,那股子烈日炎炎、充满生机的劲儿就迫不及待地涌了上来。太阳公公这回可是铆足了力气,把火辣辣的光毫无保留地倾泻
啊!夏天来了 夏天,就这么热热闹闹地来了。提起它,人们的第一反应总是炎热,但这股子热浪里,包裹着的可是一个生机勃发、色彩斑斓的世界。 你瞧,花儿们最先响应季节的号召。美人蕉、百合、荷花、凤仙花、鸡冠花、牵牛花、紫薇……品种多得数不过来,它们铆足了劲儿争奇斗艳,竞相开放,每一朵都仿佛带着笑意,热情地准
虚拟币长期持有指南:从市值与流通量看懂真实价值 很多刚接触加密市场的朋友,心里总绕不开两个问题:虚拟币到底值不值得长期持有?又该怎么判断一个币种的真正价值?其实,答案往往藏在两个最基础、也最关键的指标里——市值和流通量。今天,我们就来把这两个概念掰开揉碎了讲清楚,帮你建立起一套更理性的投资视角和持有
你曾经尝过美味可口的鱼翅吗? 那碗中的珍馐,其实是鲨鱼的鱼鳍。为了满足市场的需求,捕捞者捕获鲨鱼,割下鱼鳍后,便将仍在挣扎的鲨鱼抛回大海,任其在痛苦中沉没。这一过程不仅引发了深刻的道德争议,更因长期叠加的过度捕捞,使得全球鲨鱼种群数量急剧下滑。国际社会对此的回应,是一波接一波的生态保护行动。 万物之





