VS Code 中不存在 Steps-Counter 插件,实际应为 VSCode Counter;必须启用 "VSCodeCounter.useGitignore": true 并重启才能正确忽略 node_modules 等目录,否则统计虚高;单文件统计不准常因 .gitignore 规则过宽;需真实逻辑行数时应使用 tokei 工具。

Steps-Counter 不是 VS Code 官方或主流生态中真实存在的插件——你在扩展市场搜不到它,GitHub 上也无对应仓库,所有公开文档、插件评分、安装量数据均为空。你实际想用的,极大概率是 VSCode Counter(作者 uctakeoff),只是记混了名字。
为什么搜 Steps-Counter 找不到插件?
VS Code 扩展市场只认注册名和发布 ID,Steps-Counter 未被任何开发者发布过。常见混淆来源包括:
- 把其他工具(如 CLI 工具
tokei或 Python 库pygount)的命名风格套用到 VS Code 插件上 - 看到中文教程里错译/误写,比如把 “Step-by-step counter” 简写成 “Steps-Counter”
- 与
Word Count、CodeMetrics等带“count”“metric”字眼的插件名称记串
直接在 VS Code 中按 Ctrl+Shift+X 搜索 Steps-Counter,结果为空是正常现象;别折腾重装或离线导入,它根本不存在。
VSCode Counter 必须配 "VSCodeCounter.useGitignore": true
这是最常踩的坑:不开启这个配置,插件会无视你的 .gitignore,把 node_modules、yarn.lock、dist/ 全扫进去,统计结果虚高 3–10 倍。
- 打开
settings.json(Ctrl+,→ 右上角 `{}` 图标) - 添加这一行:
"VSCodeCounter.useGitignore": true - 必须重启 VS Code——热重载不生效
- 验证方式:右键项目根目录 →
VSCodeCounter: Count lines in workspace,输出里若还有node_modules/xxx.js,说明没识别到 Git 根目录,得用File → Open Folder重新打开正确路径
单文件统计不准?检查 .gitignore 规则是否意外命中
你以为只右键了一个 index.ts,结果统计为 0 行?很可能是 .gitignore 里写了类似 **/*.ts 或 src/**/*.test.ts 这类宽泛规则,插件开启 useGitignore 后直接跳过。
- 临时验证:把
.gitignore重命名为.gitignore.bak,再试一次单文件统计 - 更稳妥的做法是不用右键单文件,改用终端命令:
wc -l src/index.ts(Linux/macOS)或Get-Content src\index.ts | Measure-Object -Line(PowerShell) - 注意:
VSCode Counter对注释行的判定很粗糙——//行尾注释算 code 行,/* */的中间行也归 code,只有起始/结束行算 comment
要真实逻辑行数?别依赖插件,用 tokei
VSCode Counter 统计的是物理换行符数量(LOC),不剔除空行、不解析语法、不区分 .vue 里的 <script></script> 和 <template></template>。如果你需要“真实可维护的代码行”,tokei 是目前唯一可靠选择。
- 安装:
cargo install tokei(需 Rust 环境),或brew install tokei(macOS),Windows 用户可用 Scoop - 运行:
tokei(在项目根目录),输出中看code列,comment和blank是分开的 - 它自动识别语言、跳过二进制、严格读取
.gitignore,连.next、.nuxt都默认排除,无需额外配置
插件永远只是辅助,尤其当你要向团队同步“当前业务逻辑约 8k 行”这种结论时,tokei 输出才是能拿出去对齐的基准。


















