Repolode
loeffel-io

loeffel-io/ls-lint

一个快速的命令行工具,通过 .ls-lint.yml 配置文件检查项目中目录和文件的命名规范。

Star
2,430
Fork
46
未关闭 Issue
43
最近提交
昨天

这是什么?

ls-lint 根据你定义的规则检查项目中目录和文件的命名,支持 kebab-case、camelCase、PascalCase 等格式,也可以要求某些文件(例如测试文件)与源文件配套存在。规则写在一个或多个 .ls-lint.yml 文件中,通过路径模式为不同目录指定对应的命名约定。

它支持所有文件扩展名和 Unicode 文件名,可运行于 Windows、macOS 和 Linux。除了独立的二进制文件,还可以通过 npm、Homebrew 或 Docker 安装,并提供 GitHub Action 用于 CI 中执行检查。通过 ignore 配置可以跳过 node_modules 等目录。

该工具使用 Go 编写,仅依赖少量用于 YAML 解析和通配符匹配的库。

核心功能

  • 01在 .ls-lint.yml 中按路径模式定义命名规则
  • 02支持 kebab-case、camelCase、PascalCase 及正则表达式规则
  • 03可要求测试等配套文件存在
  • 04支持所有文件扩展名和完整 Unicode 文件名
  • 05通过忽略规则跳过 node_modules 等目录

适用场景

  • 在前端或 monorepo 项目中统一文件命名风格
  • 在 CI 中合并 PR 前检查文件名规范
  • 确认每个组件目录都包含必需的测试文件

快速上手

  1. 1

    按 README 所列方式安装 npm 包 @ls-lint/ls-lint、Homebrew 公式或 Docker 镜像

  2. 2

    创建 .ls-lint.yml 文件,定义目录和文件名的命名规则

标签

常见问题

ls-lint 是什么?
一个快速的命令行工具,通过 .ls-lint.yml 配置文件检查项目中目录和文件的命名规范。 ls-lint 根据你定义的规则检查项目中目录和文件的命名,支持 kebab-case、camelCase、PascalCase 等格式,也可以要求某些文件(例如测试文件)与源文件配套存在。规则写在一个或多个 .ls-lint.yml 文件中,通过路径模式为不同目录指定对应的命名约定。
ls-lint 可以免费使用吗?用的什么许可证?
ls-lint 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
ls-lint 还在维护吗?
活跃维护中。ls-lint 最近一次提交是在 2026年10月21日。
ls-lint 适合用来做什么?
在前端或 monorepo 项目中统一文件命名风格 在 CI 中合并 PR 前检查文件名规范 确认每个组件目录都包含必需的测试文件
ls-lint 怎么安装和运行?
按 README 所列方式安装 npm 包 @ls-lint/ls-lint、Homebrew 公式或 Docker 镜像 创建 .ls-lint.yml 文件,定义目录和文件名的命名规则
在哪里获取 ls-lint?
源代码和安装说明在 GitHub 上:https://github.com/loeffel-io/ls-lint

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目