开发指南
欢迎阅读 Hx前端技术规范开发指南。本指南将帮助您快速搭建开发环境并开始项目开发。
文档导航
环境搭建
开发流程
问题解决
- 常见问题 - 开发中常见问题和解决方案
快速入门
1. 环境准备
确保您已经完成以下准备:
- [x] 已安装 Node.js(推荐 18+ LTS)
- [x] 已安装 pnpm 包管理器
- [x] 已安装 VS Code 及相关扩展
- [x] 已配置 Git
详细步骤请参考 环境搭建。
2. 项目初始化
bash
# 克隆项目
git clone <repository-url>
cd <project-name>
# 切换 Node 版本
nvm use
# 安装依赖
pnpm install
# 启动开发服务器
pnpm run dev详细步骤请参考 快速开始。
3. 开发与提交
bash
# 创建功能分支
git checkout -b feature/your-feature-name
# 开发代码...
# 检查代码
pnpm run lint
# 提交代码
git add .
git commit -m "feat: 添加新功能"
# 推送到远程
git push origin feature/your-feature-name详细流程请参考 开发流程。
核心概念
代码规范
项目遵循严格的代码规范,包括:
- HTML 规范 - 语义化、可访问性
- CSS 规范 - BEM 命名、性能优化
- JavaScript 规范 - ES6+、最佳实践
- Vue 规范 - 组件设计、状态管理
详细规范请参考 代码规范。
工具链
项目使用以下工具保证代码质量:
- ESLint - 代码检查
- Prettier - 代码格式化
- Git Hooks - 提交前检查
- VS Code - 统一开发环境
详细配置请参考 工具链。
学习资源
官方文档
推荐阅读
获取帮助
如果在开发过程中遇到问题:
- 查看 常见问题 章节
- 搜索相关错误信息
- 查看官方文档
- 联系团队成员寻求帮助