# dev-env-setup

**Repository Path**: chen_ting_ting_1/dev-env-setup

## Basic Information

- **Project Name**: dev-env-setup
- **Description**: Local development environment automation scripts
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-06
- **Last Updated**: 2025-12-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 开发环境自动化搭建工具

这个仓库包含了用于在Ubuntu 22.04系统上自动化搭建开发环境的脚本。通过执行这些脚本，你可以在10分钟内完成原本需要2-3小时的手动配置工作，大大提高效率并降低配置错误的风险。

## 功能特点

- 自动安装和配置Python开发环境（包括pip、virtualenv等）
- 安装Node.js和npm，支持前端开发
- 配置Docker环境，便于容器化开发
- 安装Visual Studio Code并配置常用开发插件
- 创建标准的工作区目录结构
- 配置Git并设置SSH认证

## 快速开始

### 前置条件

- 操作系统：Ubuntu 22.04
- 已安装Python 3.6或更高版本

### 执行步骤

1. 克隆此仓库到本地：
   ```bash
   git clone git@github.com:Amy-by/dev-env-setup.git
   cd dev-env-setup
   ```

2. 给脚本添加执行权限：
   ```bash
   chmod +x setup_env.sh setup_dev_env.py
   ```

3. 执行Shell脚本（配置系统环境）：
   ```bash
   ./setup_env.sh
   ```

4. 应用环境变量更改：
   ```bash
   source ~/.bashrc
   ```

5. 执行Python脚本（安装开发工具）：
   ```bash
   ./setup_dev_env.py
   ```

6. 重启系统（使某些配置生效）：
   ```bash
   sudo reboot
   ```

## 脚本说明

### setup_env.sh

这个Shell脚本主要负责系统级别的配置：
- 更新系统包索引并安装基本开发工具
- 配置环境变量和工作区目录
- 设置Git用户信息
- 配置SSH密钥（如果需要）

### setup_dev_env.py

这个Python脚本负责安装和配置具体的开发工具：
- 安装Python包管理工具
- 安装Node.js和npm
- 安装Docker和Docker Compose
- 安装Visual Studio Code并配置常用扩展
- 创建标准的项目工作区结构

## 目录结构

```
dev-env-setup/
├── setup_env.sh          # 系统环境配置脚本
├── setup_dev_env.py      # 开发工具安装脚本
└── README.md             # 项目说明文档
```

## 自定义配置

如果你需要自定义安装内容，可以编辑相应的脚本：

- 要修改安装的Python包，编辑`setup_dev_env.py`中的`install_python_packages`函数
- 要更改Node.js版本，修改`setup_dev_env.py`中的`install_nodejs`函数
- 要添加或移除VS Code扩展，修改`setup_dev_env.py`中的`install_vscode`函数
- 要更改工作区目录结构，修改`setup_dev_env.py`中的`create_workspace_structure`函数

## 故障排除

### Git认证问题

如果遇到Git推送失败的问题，请确保：
1. 已正确配置SSH密钥并添加到GitHub账户
2. 远程仓库地址格式正确：`git@github.com:Amy-by/dev-env-setup.git`
3. 可以通过以下命令验证SSH连接：
   ```bash
   ssh -T git@github.com
   ```

### Docker权限问题

如果执行Docker命令时遇到权限问题，请执行：
```bash
sudo usermod -aG docker $USER
sudo reboot
```

### 脚本执行问题

如果脚本无法执行，请确保：
1. 脚本文件具有执行权限：`chmod +x setup_env.sh setup_dev_env.py`
2. 使用正确的Python版本执行：`python3 setup_dev_env.py`

## 贡献

如果你发现任何问题或有改进建议，请提交Issue或Pull Request。欢迎为这个项目做出贡献！