资源描述
Solidarity 是一款专为开发团队设计的项目环境强制执行工具。它通过配置文件自动检查并验证团队成员的本地开发环境（如 Node.js 版本、包管理器及依赖 CLI 工具），确保跨机器环境的高度一致性。适用于中大型前端或 Node.js 项目，有效消除“在我的机器上能跑”的经典难题，降低环境配置带来的沟通成本，提升团队协作与开发效率。
详细内容
## 工具定位与核心价值
Solidarity 是一款跨平台的项目环境强制执行器（Environment Enforcer）。其核心价值在于彻底消除“在我的机器上可以运行”的经典开发痛点。通过自动化检查机制，它确保团队所有成员的本地开发环境与项目要求严格一致，大幅减少因环境差异导致的 Bug 和排查时间，提升团队整体交付效率。
## 主要功能列表
- **环境规则定义**：支持通过项目根目录的 `.solidarity.json` 配置文件，声明式定义项目所需的具体环境规则。
- **多维度环境检查**：支持检查 Node.js 版本、包管理器（npm/yarn/pnpm）版本，以及各类系统级 CLI 工具（如 git, ruby, python, watchman 等）。
- **语义化版本匹配**：支持 SemVer（语义化版本控制）语法，精确控制依赖工具的主版本、次版本或补丁版本范围。
- **自定义规则扩展**：允许开发者编写自定义的检查脚本或正则表达式，以满足特殊的环境验证需求。
- **自动化流程集成**：可无缝集成到 Git Hooks（如 Husky）中，在代码提交、切换分支时自动触发环境检查。
## 典型使用场景
- **团队新人入职**：新成员拉取代码后，一键运行检查，快速发现本地缺失的依赖或版本错误，降低老员工的指导成本。
- **复杂全栈或跨语言项目**：当项目同时依赖特定版本的 Node.js、Ruby、Python 或特定的数据库 CLI 时，统一管理环境基线。
- **CI/CD 流水线**：在持续集成环境中作为前置步骤，验证构建机器的环境合规性，防止因构建环境不一致导致的部署失败。
## 上手步骤与操作要点
1. **全局安装**：通过 npm 全局安装 Solidarity 工具。
```bash
npm install -g solidarity
```
2. **生成初始配置**：在项目根目录运行快照命令，工具会自动读取当前环境并生成 `.solidarity.json` 配置文件。
```bash
solidarity snapshot
```
3. **调整与精简规则**：打开生成的配置文件，根据项目实际需求，删除不必要的检查项，并精确调整所需工具的版本号范围。
4. **执行环境检查**：团队成员在本地运行 `solidarity` 命令，工具将输出详细的环境检查报告，清晰标出通过和失败的项。
5. **集成 Git Hooks（进阶）**：结合 `husky`，在 `package.json` 中配置 `post-checkout` 或 `post-merge` 钩子，实现拉取代码后自动校验环境。