valalang/lint

Vala代码风格检查工具镜像

镜像概述和主要用途

本镜像是一个轻量级Docker镜像，专门用于检查Vala代码文件的代码风格规范性。它基于静态分析原理，通过预设或自定义规则对Vala源代码进行风格检查，帮助开发者及团队在开发过程中自动检测代码格式问题，确保代码风格统一、符合项目规范，提升代码可读性和可维护性。

核心功能和特性

• Vala代码专项支持：针对Vala语言语法特性优化，精准识别语言特定代码风格问题（如缩进、命名规范、括号使用等）。
• 多规则支持：内置Vala官方推荐代码风格规则集，同时支持加载自定义规则配置文件。
• 详细结果输出：检查结果包含错误/警告类型、文件路径、行号及具体问题描述，便于定位修复。
• 轻量级设计：基于Alpine基础镜像构建，镜像体积小，启动速度快，资源占用低。
• 灵活集成：支持本地命令行调用、Git Hooks集成及CI/CD流水线自动化检查。
• 多输出格式：支持文本（默认）、JSON等多种输出格式，适配不同场景需求（如人工查看、机器解析）。

使用场景和适用范围

• 本地开发辅助：开发者在提交代码前，通过本工具快速检查本地Vala代码风格问题。
• Git Hooks集成：配置到pre-commit等Git钩子中，自动拦截不符合风格规范的代码提交。
• CI/CD自动化检查：集成到Jenkins、GitHub Actions等CI/CD流程，在构建阶段自动执行代码风格验证，确保合并代码符合规范。
• 团队协作规范：作为团队代码风格统一标准的执行工具，减少因风格差异导致的协作成本。
• 开源项目质量保障：为Vala开源项目提供自动化代码风格门禁，提升项目整体代码质量。

详细使用方法和配置说明

基本使用

前提条件

• 已安装Docker引擎（20.10+版本推荐）。
• 待检查的Vala代码文件或目录可通过Docker卷挂载到容器内。

核心操作：检查代码文件/目录

通过docker run命令启动容器，挂载本地代码目录，并指定待检查的文件或路径：

bash
# 检查当前目录下所有.vala文件（默认输出文本格式结果）
docker run --rm -v $(pwd):/code vala-code-style-checker /code

# 检查指定目录（如./src）下的Vala代码
docker run --rm -v $(pwd):/code vala-code-style-checker /code/src

# 检查单个文件（如./src/main.vala）
docker run --rm -v $(pwd):/code vala-code-style-checker /code/src/main.vala

高级配置

使用自定义规则配置文件

若需使用自定义代码风格规则（而非内置规则），可将规则文件（如style-config.json）挂载到容器内，并通过--config参数指定路径：

bash
# 挂载自定义配置文件并应用规则
docker run --rm \
  -v $(pwd):/code \
  -v $(pwd)/style-config.json:/config/style-config.json \
  vala-code-style-checker \
  --config /config/style-config.json \
  /code/src

规则文件格式：支持JSON格式，配置项包括缩进长度（indent_size）、命名规范（naming_convention，如snake_case/camelCase）、括号风格（brace_style）等，具体字段参考工具内置规则模板。

输出格式调整

通过--format参数指定输出格式，支持text（默认）或json：

bash
# 输出JSON格式结果（便于机器解析）
docker run --rm -v $(pwd):/code vala-code-style-checker --format json /code/src

指定检查严格程度

通过--severity参数过滤结果级别，可选值：error（仅显示错误）、warning（显示错误+警告，默认）、info（显示所有信息）：

bash
# 仅输出错误级别结果
docker run --rm -v $(pwd):/code vala-code-style-checker --severity error /code/src

Docker部署方案示例

docker run 命令示例

示例1：基础检查（当前目录，文本输出）

bash
docker run --rm -v $(pwd):/code vala-code-style-checker /code

示例2：自定义配置+JSON输出

bash
docker run --rm \
  -v $(pwd)/src:/code/src \
  -v $(pwd)/custom-rules.json:/app/config.json \
  vala-code-style-checker \
  --config /app/config.json \
  --format json \
  /code/src

示例3：CI环境集成（仅输出错误，非0退出码触发构建失败）

bash
docker run --rm \
  -v $(pwd):/code \
  vala-code-style-checker \
  --severity error \
  /code/src || exit 1  # 若存在错误，CI流程终止

docker-compose 配置示例

适用于需要固定配置的场景（如本地开发环境），创建docker-compose.yml：

yaml
version: '3.8'

services:
  vala-style-check:
    image: vala-code-style-checker
    volumes:
      - ./src:/code/src  # 挂载待检查代码目录
      - ./style-config.json:/config/style-config.json  # 挂载自定义规则文件
    command: 
      --config /config/style-config.json  # 指定规则文件路径
      --format json  # 输出JSON格式
      /code/src  # 检查目标目录
    environment:
      - TZ=Asia/Shanghai  # 时区配置（可选）

启动检查：

bash
docker-compose run --rm vala-style-check

配置参数与环境变量

环境变量

命令行参数

注意事项

• 文件权限：确保挂载的代码目录对容器内用户（默认root）有读权限，避免因权限不足导致文件无法访问。
• 规则文件兼容性：自定义规则文件需符合工具支持的JSON格式，字段错误可能导致检查失败（容器日志会输出具体错误信息）。
• 输出解析：JSON格式输出可通过jq等工具进一步处理（如筛选错误数量、生成报告），示例：docker run ... | jq '.errors'。
• 镜像更新：定期更新镜像以获取最新的规则库和功能优化，命令：docker pull vala-code-style-checker。