environment-setup-guide

Environment Setup Guide - 开发环境配置指南

技能概述

提供从零开始搭建开发环境的完整指导，涵盖工具安装、依赖管理、环境变量配置和验证测试的全流程。

适用场景

启动新项目时配置开发环境：确保团队成员拥有统一的开发环境，避免因环境差异导致的问题。

新成员入职或切换设备：为开发者提供标准化的环境配置流程，快速上手项目开发。

排查环境相关问题：诊断并解决依赖冲突、版本不匹配、环境变量缺失等常见问题。

核心功能

环境需求分析与工具安装：自动识别项目所需的编程语言、包管理器、数据库等依赖，提供跨平台的安装指令。

环境配置与初始化：指导设置环境变量、配置文件、IDE 插件和 Shell 配置，确保开发环境正常运行。

安装验证与故障排除：提供检查清单和测试命令，快速定位并解决环境配置中的常见问题。

常见问题

开发环境配置需要哪些基础工具？

通常包括编程语言运行环境（如 Node.js、Python）、包管理器（npm、pip）、版本控制工具（Git）、数据库（可选）以及代码编辑器或 IDE。具体需求根据项目技术栈而定，本技能会根据项目自动生成对应的工具清单。

如何验证开发环境配置是否成功？

运行版本检查命令（如 node --version、python --version）确认工具已正确安装。然后尝试运行项目的基本命令（如 npm install、npm run dev），确保依赖正常加载且服务能顺利启动。

换电脑后如何快速迁移开发环境？

建议使用 Docker 容器化开发环境，或编写自动化配置脚本（如 setup.sh）记录安装步骤。本技能提供标准化的脚本模板，包含依赖安装、环境变量设置和验证测试，在新设备上执行即可一键完成环境配置。