如何在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 文件中的