---

name: environment-setup-guide description: "指导开发者搭建开发环境，包括正确的工具、依赖项和配置" risk: unknown source: community date_added: "2026-02-27"

开发环境搭建指南

概述

帮助开发者从零开始搭建完整的开发环境。本技能提供安装工具、配置依赖项、设置环境变量以及验证设置是否正确的分步指导。

适用场景

• 启动新项目需要搭建开发环境时
• 新团队成员加入项目时
• 切换到新机器或操作系统时
• 排查环境相关问题时
• 为项目编写搭建说明文档时
• 创建开发环境文档时

工作流程

步骤 1：确定需求

帮助你确定需要安装的内容：

• 编程语言和版本（Node.js、Python、Go 等）
• 包管理器（npm、pip、cargo 等）
• 数据库系统（PostgreSQL、MongoDB、Redis 等）
• 开发工具（Git、Docker、IDE 扩展等）
• 环境变量和配置文件

步骤 2：检查当前设置

在安装任何内容之前，帮助你检查已安装的内容：

# Check versions of installed tools
node --version
python --version
git --version
docker --version

步骤 3：提供安装说明

提供特定平台的安装命令：

• macOS： 使用 Homebrew
• Linux： 使用 apt、yum 或包管理器
• Windows： 使用 Chocolatey、Scoop 或直接安装程序

步骤 4：配置环境

帮助设置：

• 环境变量（.env 文件）
• 配置文件（.gitconfig、.npmrc 等）
• IDE 设置（VS Code、IntelliJ 等）
• Shell 配置（.bashrc、.zshrc 等）

步骤 5：验证安装

提供验证步骤确保一切正常：

• 运行版本检查
• 测试基本命令
• 验证数据库连接
• 检查环境变量是否已加载

示例

示例 1：Node.js 项目搭建

## 搭建 Node.js 开发环境

### 前提条件
- macOS、Linux 或 Windows
- 终端/命令提示符访问权限
- 网络连接

### 步骤 1：安装 Node.js

**macOS（使用 Homebrew）：**
\`\`\`bash
# Install Homebrew if not installed
curl -fsSLo /tmp/homebrew-install.sh https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh
sed -n '1,160p' /tmp/homebrew-install.sh
/bin/bash /tmp/homebrew-install.sh

# Install Node.js
brew install node
\`\`\`

**Linux（Ubuntu/Debian）：**
\`\`\`bash
# Update package list
sudo apt update

# Install Node.js and npm
curl -fsSLo /tmp/nodesource-setup.sh https://deb.nodesource.com/setup_20.x
sed -n '1,160p' /tmp/nodesource-setup.sh
sudo -E bash /tmp/nodesource-setup.sh
sudo apt install -y nodejs
\`\`\`

**Windows（使用 Chocolatey）：**
\`\`\`powershell
# Install Chocolatey if not installed
Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))

# Install Node.js
choco install nodejs
\`\`\`

### 步骤 2：验证安装

\`\`\`bash
node --version  # Should show v20.x.x or higher
npm --version   # Should show 10.x.x or higher
\`\`\`

### 步骤 3：安装项目依赖

\`\`\`bash
# Clone the repository
git clone https://github.com/your-repo/project.git
cd project

# Install dependencies
npm install
\`\`\`

### 步骤 4：设置环境变量

创建 \`.env\` 文件：
\`\`\`bash
# Copy example environment file
cp .env.example .env

# Edit with your values
nano .env
\`\`\`

示例 \`.env\` 内容：
\`\`\`
NODE_ENV=development
PORT=3000
DATABASE_URL=postgresql://localhost:5432/mydb
API_KEY=your-api-key-here
\`\`\`

### 步骤 5：运行项目

\`\`\`bash
# Start development server
npm run dev

# Should see: Server running on http://localhost:3000
\`\`\`

### 故障排除

**问题：** "node: command not found"
**解决方案：** 重启终端或运行 \`source ~/.bashrc\`（Linux）或 \`source ~/.zshrc\`（macOS）

**问题：** "Permission denied" 错误
**解决方案：** 不要使用 sudo 运行 npm。修复权限：
\`\`\`bash
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
\`\`\`

示例 2：Python 项目搭建

## 搭建 Python 开发环境

### 步骤 1：安装 Python

**macOS：**
\`\`\`bash
brew install python@3.11
\`\`\`

**Linux：**
\`\`\`bash
sudo apt update
sudo apt install python3.11 python3.11-venv python3-pip
\`\`\`

**Windows：**
\`\`\`powershell
choco install python --version=3.11
\`\`\`

### 步骤 2：验证安装

\`\`\`bash
python3 --version  # Should show Python 3.11.x
pip3 --version     # Should show pip 23.x or higher
\`\`\`