环境搭建指南

要解决什么问题

新项目开工、新人入职、换电脑或换系统时，开发环境往往缺一块、版本对不上，或者「装好了却 command not found」。文档零散在 README、Wiki 和口口相传里，排查时也很难判断是 PATH、权限还是数据库没起来。

技能如何工作

本技能按可复现的搭建流程组织对话，而不是只丢一串安装链接：

1. 识别需求：语言与版本（如 Node.js、Python）、包管理器、数据库（PostgreSQL、MongoDB、Redis 等）、Git/Docker/IDE 扩展，以及 .env 等配置项。
2. 检查当前环境：在安装前先盘点本机已有什么，避免重复装或版本冲突。
3. 分平台安装说明：针对 macOS（Homebrew）、Linux（apt/yum 等）、Windows（Chocolatey、Scoop 或官方安装包）给出对应命令与路径说明。
4. 配置与验证：协助设置环境变量、.gitconfig、shell 配置（.bashrc/.zshrc），并通过版本检查、基本命令、数据库连通性等步骤确认环境可用。

文档化方面会强调版本管理器（nvm、pyenv）、env.example、固定依赖版本，以及可选的 setup.sh 自动化脚本。

适用边界与注意点

• 适合从零或半成环境做结构化搭建与故障定位；不能替代你项目私有的密钥、内网镜像或公司强制安全策略。
• 权限类问题（如 npm EACCES）会引导不用 sudo、改权限或用虚拟环境，而不是粗暴全局安装。
• 端口占用、数据库连接失败等常见陷阱会按症状给出检查清单；若涉及生产部署或 CI 镜像定制，需结合 @systematic-debugging 或项目自有规范另行细化。