check-tools

检查工具 — 开发环境验证器

按生态系统分组，报告已安装的开发工具及其版本。默认情况下会报告所有工具，但不会导致验证失败——适用于多样化的 PaaS/容器环境，这类环境通常只需要部分生态系统。

适用场景

• 验证容器或环境是否具备任务所需的工具
• 排查可能由缺少依赖导致的构建失败
• 记录系统要求
• 入门：确认开发环境已准备就绪

运行

# Fast check with exit code (0 = all required core tools present)
bash assets/check-tools.sh

# Development tools only
bash assets/environment-diagnostic.sh tools

# System info: hardware, mounts, processes
bash assets/environment-diagnostic.sh system

# Complete diagnostic (tools + system + package inventories), written to a file
bash assets/environment-diagnostic.sh full /path/to/report.txt

只有在缺少某个必需核心工具（python3、pip、node、npm、java、gcc、git、curl、awk、grep、gzip、tar、make、sed）时，check-tools.sh 才会以非零状态码退出。其他所有工具都会报告（✅ 已找到 / ⚠️ 可选且缺失），但不会导致运行失败。

各生态系统的必需工具与可选工具

生态系统	必需	可选
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 调用）中，而非本文件中。若要更改必需工具，请编辑该脚本。