Check Tools 是一个开发环境验证工具集,用于报告已安装的开发工具及其版本,并按生态分组。默认行为是报告所有工具而不判定失败,适合只预期存在部分生态的 PaaS/容器环境。
用途:验证容器或环境是否具备任务所需工具;排查可能因缺少依赖导致的构建失败;记录系统需求;在入职或上手时确认开发环境就绪。
主要用法: 快速检查并返回退出码(0 表示所需核心工具齐全): bash assets/check-tools.sh 仅检查开发工具: bash assets/environment-diagnostic.sh tools 查看系统信息(硬件、挂载、进程): bash assets/environment-diagnostic.sh system 完整诊断(工具 + 系统 + 软件包清单),写入文件: bash assets/environment-diagnostic.sh full /path/to/report.txt
判定规则:check-tools.sh 仅在缺少必需核心工具(python3、pip、node、npm、java、gcc、git、curl、awk、grep、gzip、tar、make、sed)之一时返回非零退出码。其他工具仅报告(✅ 已找到 / ⚠️ 可选但缺失),不会导致运行失败。
必需与可选工具按生态划分:Python 必需 python3、pip,可选 python、uv、poetry、black、mypy、pytest、ruff;Node.js 必需 node、npm,可选 nvm、yarn、pnpm、eslint、prettier、chromedriver;Java 必需 java,可选 mvn、gradle;Go 可选 go;Rust 可选 rustc、cargo;C/C++ 必需 gcc,可选 clang、cmake、ninja、conan;实用工具必需 git、curl、awk、sed、grep、gzip、tar、make,可选 jq、rg、tmux、yq、vim、nano。每个工具的版本检查命令与安装说明位于 references/tool-categories.md。
文件组成:assets/check-tools.sh 为快速验证脚本(退出码、快速检查);assets/environment-diagnostic.sh 为综合诊断,含 tools/system/full 模式;references/tool-categories.md 为逐工具明细与安装说明。
扩展方式:必需/可选的划分位于 assets/check-tools.sh 中的 check_required_tool / check_optional_tool 调用处,而非本文档;如需调整必需工具,编辑该脚本。