项目初始化

wescode 帮助你快速初始化和配置新项目，从脚手架生成到开发环境搭建。

快速开始

新建项目

在 wescode 中打开一个空文件夹，AI 帮你初始化项目：

"创建一个 Go Web 项目，使用 gin 框架和 PostgreSQL"
"初始化一个 React + TypeScript 项目"
"搭建一个 Python FastAPI 项目"

AI 会生成完整的项目结构：

• 目录布局
• 配置文件
• 依赖声明
• 入口文件
• 基础代码
• .gitignore
• README.md

项目模板

AI 了解常见项目结构，生成符合行业惯例的布局：

环境配置

开发工具链

AI 检测系统环境并建议配置：

• Go 版本与 GOPATH
• Node.js 版本（nvm 管理）
• Python 虚拟环境
• Docker 环境
• 数据库连接

配置文件生成

AI 生成必要的配置文件：

• 编辑器配置：.editorconfig、VS Code settings
• 代码质量：.golangci-lint.yml、ESLint、Prettier
• Git 配置：.gitignore、.gitattributes
• CI/CD：GitHub Actions、GitLab CI
• Docker：Dockerfile、docker-compose.yml
• 环境变量：.env.example

项目感知

自动识别项目类型

打开已有项目时，wescode 自动识别：

• 语言和框架：通过配置文件和依赖
• 构建系统：Makefile / npm scripts / Cargo
• 测试框架：testing / Jest / pytest
• 包管理器：go mod / npm / pip / cargo

约定感知

AI 理解项目中的隐式约定：

• 命名风格（camelCase / snake_case）
• 目录组织方式
• 错误处理模式
• 日志记录方式
• 注释风格

依赖管理

添加依赖

通过 AI 添加和配置依赖：

"给项目添加 Redis 支持"
→ 添加依赖 + 配置代码 + 连接管理 + 基础封装

"添加 JWT 认证中间件"
→ 添加库 + 中间件代码 + 配置项 + 使用示例

依赖分析

• 检查过时的依赖版本
• 识别安全漏洞
• 分析依赖树大小
• 发现未使用的依赖

数据库初始化

Schema 设计

AI 辅助数据库设计：

"设计一个用户管理系统的数据库表"
→ 生成 CREATE TABLE 语句
→ 创建迁移文件
→ 生成 Go 数据模型
→ 生成基础 CRUD 代码

迁移管理

• 生成迁移文件
• 版本号管理
• 回滚脚本
• 种子数据

最佳实践

项目结构原则

• 按功能/业务域组织，而非按技术层
• 保持依赖方向单一（向内依赖）
• 接口定义在消费方
• 配置集中管理

初始化检查清单

• README.md 包含项目说明和启动方式
• .gitignore 覆盖所有需要忽略的文件
• 有清晰的依赖声明和锁文件
• 开发/测试/生产环境配置分离
• CI/CD 配置就绪
• 代码质量工具配置完成

注意事项

• 生成的项目结构是起点，按需调整
• 配置文件中的敏感信息使用环境变量
• 定期更新依赖版本
• 遵循语言社区的项目结构惯例