工具家族总目录
研发工具真正产生价值，不在于安装数量，而在于能否把一次操作变成可复现、可诊断、可审查、可回退的工程能力。这里按研发活动中的问题域组织工具：先找到当前卡点，再进入对应家族，最后定位到独立工具或专题。
快速入口
| 现场问题 | 工具家族 | 可以解决什么 |
|---|---|---|
| 新开发机怎样快速达到团队基线 | 开发机基础环境 | 操作系统、运行时、包管理入口、代理与环境诊断 |
| 代码怎样安全地协作、审查和追溯 | Git 与代码协作 | Git、托管平台、认证签名、分支协作与仓库治理 |
| IDE 怎样承担导航、调试和远程开发 | IDE 与编辑器 | JetBrains、VS Code、远程开发、调试与团队配置 |
| 依赖和构建为什么在不同机器上表现不一致 | 包管理、构建与任务脚本 | Maven、Gradle、npm、pnpm、多语言构建与任务编排 |
| 本地服务怎样隔离运行并可重复重建 | 本地运行时与容器 | Docker、Compose、Podman、卷、网络与开发容器 |
| Kubernetes 资源怎样在开发阶段安全操作 | Kubernetes 开发工具链 | kubectl、本地集群、Helm、Kustomize、可视化与调试 |
| 数据怎样存储、检索、缓存和分析 | 数据库与存储工具 | 关系数据库、缓存、文档库、搜索、分析库与对象存储 |
| 异步消息为什么丢失、重复、乱序或积压 | 消息与事件工具 | RabbitMQ、Kafka、RocketMQ、Pulsar、NATS 与控制台 |
| 服务发现、配置发布和协调状态怎样核验 | 注册配置与协调工具 | Nacos、Consul、etcd、ZooKeeper、Apollo 与配置发布 |
| 外部依赖怎样在本地稳定复现 | 本地 Mock 与辅助服务 | 邮件捕获、HTTP Mock、身份源、云服务模拟与故障注入 |
| 请求和契约哪里发生了偏差 | 浏览器、接口与契约调试 | DevTools、HTTP 客户端、OpenAPI、gRPC 与 GraphQL |
| 怎样检查数据又避免误操作 | 数据客户端与控制台 | SQL、缓存、文档库、搜索与消息控制台的安全访问 |
| 下载、代理、TLS 或抓包为什么异常 | 网络、代理与证书工具 | 连通性、分层代理、证书链、HTTPS 抓包与隧道 |
| 本地域名、路由、WebSocket 或 CORS 怎样统一调试 | 本地网关与入口工具 | Nginx、Caddy、Traefik、Envoy 与本地 HTTPS |
| 故障发生后怎样获得日志、指标和调用链证据 | 观测、日志与链路工具 | 本地日志、集中日志、Prometheus、OpenTelemetry 与 APM |
| 慢在哪里、容量够不够、优化是否有效 | 性能、压测与诊断工具 | 接口压测、JVM 诊断、在线剖析与前端性能 |
| 缺陷和供应链风险怎样在提交前阻断 | 质量与安全门禁工具 | 静态检查、依赖扫描、密钥扫描与提交门禁 |
| 一次提交怎样成为可追溯、可验证的制品 | CI/CD、制品与发布工具 | 流水线、制品库、镜像库、签名、SBOM 与版本发布 |
三层知识结构
工具数量多并不可怕，关键是不要把不同问题硬塞进同一篇文章。知识树采用三层结构：
- 工具家族围绕一个研发问题域建立入口，例如数据库与存储、消息与事件、观测与链路。
- 子家族继续按机制分组，例如关系型数据库、缓存与 KV、搜索引擎、分析型数据库。
- 独立工具文章深入一个具体工具或一组不可分割的协作组件，例如 MySQL、Redis、Elasticsearch、ClickHouse。
因此，MySQL 不会只是“数据库概览”里的几段命令。它需要从安装部署走到连接与配置，再进入复制、高可用、容量、备份恢复和团队治理；Redis、Kafka、Nacos、Kubernetes 等基础设施同样沿着自己的机制展开。
从问题而不是产品名出发
遇到故障时，先判断问题发生在哪一层：
- 环境层：命令不存在、版本漂移、代理或证书失败，先看 01～06。
- 依赖层：数据库、消息、注册配置或外部沙箱异常，进入 07～10。
- 交互层：请求、数据、网络和本地入口不符合预期，进入 11～14。
- 证据与交付层：日志不足、性能退化、门禁失败或制品不可追溯，进入 15～18。
产品名只能告诉你“可能用什么”，现场证据才能告诉你“问题在哪里”。若暂时无法确定入口，先记录环境、时间、输入、错误原文和最近变更，再从工具效率阅读指南选择排查路径。
架构决策的共同坐标
工具选型不能只比较功能列表。无论对象是数据库、IDE、网关还是流水线，都要放到同一组工程约束下观察：
| 决策坐标 | 需要回答的问题 |
|---|---|
| 可用性 | 单点怎样失效，恢复依赖哪些状态，切换是否会丢数据或上下文 |
| 性能与容量 | 瓶颈位于 CPU、内存、磁盘、网络、锁还是外部配额，容量如何验证 |
| 一致性与数据边界 | 哪些状态需要强一致，哪些允许延迟，数据能否离开本机或组织边界 |
| 权限与凭证 | 谁能读取、写入、发布和管理，凭证怎样签发、轮换、撤销和审计 |
| 成本 | 许可证、基础设施、流量、存储、席位和维护时间如何进入总成本 |
| 可运维性 | 日志、指标、备份、升级、回滚、资源回收和责任人是否明确 |
| 退出机制 | 工具失效、停服或不再适用时，数据、配置和工作流怎样迁移 |
安装成功只是起点。能够解释这些问题，工具才真正进入团队工程体系。