FeatureLint

一款功能开关（feature flag）规范性分析器，可在问题进入生产环境前识别陈旧开关、SDK 误用、安全风险及架构缺陷。

Emoji： flag 官网： https://featurelint.pages.dev 产品名： featurelint 主题色： #e84393

功能说明

FeatureLint 对代码库进行静态分析，覆盖六大类功能开关规范性问题：

• 陈旧开关（SF） — 检测硬编码布尔值、带 TODO 注释的开关、被注释掉的条件分支，以及引用已过期时间的开关
• 开关复杂度（FC） — 发现嵌套的开关条件、过度分支、开关耦合（entanglement），以及循环中缺失缓存机制
• 开关安全性（FS） — 当开关控制身份认证、支付流程、加密操作、数据删除或审计日志等关键路径时发出警告
• SDK 误用（SM） — 捕获缺失默认值、在循环中重复求值、多次初始化 SDK、以及缺少错误处理逻辑等问题
• 开关生命周期（FL） — 识别未设置清理日期的开关、已被弃用的实验、100% 全量发布的开关，以及缺失负责人标注的情况
• 开关架构（FA） — 检测跨层误用（如在错误层级执行开关判断）、服务间紧耦合、缺失注册中心，以及服务端状态意外泄露等问题

共支持 90 种检测模式，全部基于 POSIX ERE 正则表达式匹配，并提供严重等级划分与可操作的修复建议。

安装方式

作为 Git Hook（Lefthook）

# lefthook.yml
pre-commit:
  commands:
    featurelint:
      glob: "*.{js,jsx,ts,tsx,py,rb,java,go,rs}"
      run: bash path/to/featurelint/scripts/dispatcher.sh staged --severity error

直接使用 CLI

# 扫描指定目录
bash scripts/dispatcher.sh scan ./src

# 以 JSON 格式输出扫描结果
bash scripts/dispatcher.sh scan --format json --output report.json ./src

# 分析 Git 暂存区中的文件
bash scripts/dispatcher.sh staged

# 单文件分析
bash scripts/dispatcher.sh file ./src/flags.ts

# 运行健康检查
bash scripts/dispatcher.sh health

版本分级体系

通过设置许可证密钥激活对应版本：

export FEATURELINT_LICENSE_KEY="FEATURELINT-XXXX-XXXX-XXXX-XXXX"

命令列表

命令行选项

环境变量

输出格式

Text（默认格式）

面向人类阅读的终端输出，含颜色标识的严重等级、按文件分组、源码上下文定位，以及可操作的修复建议。

JSON

结构化输出，适用于 CI/CD 集成。包含元数据、汇总计数器，以及由文件路径、行号、严重等级、检测 ID、描述与修复建议组成的 findings 数组。

CSV

兼容电子表格的输出格式，便于跟踪与报表生成。每条发现单独一行，涵盖全部字段。

Markdown

包含摘要表格、分类统计、严重等级分布与发现详情表的报告模板。若存在 report.md.tmpl 文件，则使用该模板生成报告。

支持的语言

JavaScript、TypeScript、Python、Ruby、Java、Kotlin、Scala、Go、Rust、C#、F#、PHP、Swift、Dart、Vue、Svelte、Elixir、Clojure、Lua、R、YAML、JSON、TOML、XML、Terraform/HCL 以及 Shell。

项目结构

featurelint/
  scripts/
    dispatcher.sh    # CLI 入口与参数解析
    analyzer.sh      # 核心分析引擎与输出格式化器
    patterns.sh      # 覆盖六大类别的 90 种检测模式
    license.sh       # 许可证校验与版本权限控制
  config/
    lefthook.yml     # Git hook 配置文件
  templates/
    report.md.tmpl   # Markdown 报告模板
  SKILL.md           # 本文档

使用示例

CI/CD 集成（GitHub Actions）

- name: FeatureLint
  run: |
    bash featurelint/scripts/dispatcher.sh scan 
      --format json 
      --output featurelint-report.json 
      --severity warning 
      ./src

基线工作流

# 创建初始基线
bash scripts/dispatcher.sh baseline ./src

# 修改代码后执行比对
bash scripts/dispatcher.sh compare ./src

Pre-commit Hook（仅阻断 error 级别问题）

bash scripts/dispatcher.sh staged --severity error

系统要求

• Bash 4.0 或更高版本
• 标准 POSIX 工具：grep、sed、awk、find、sort、uniq、wc、cut
• 可选依赖：curl（用于在线许可证校验）、git（用于暂存区分析）

许可证

商业软件。提供含 30 种检测模式的免费版本。 详细定价与条款请参阅：https://featurelint.pages.dev