当前位置：首页 > ai >正文

《校园生活平台从 0 到 1 的搭建》第一篇：创建项目与构建目录结构

ai 2025/6/29 15:37:56

在本系列第一篇中，我们将从项目初始化开始，搭建基本的目录结构，并完成四个主页面的创建与 TabBar 设置。
（tip：你可能会觉得有点 ai 化，因为这个文案是我自己写了一遍文案之后让 ai 去优化输出的）

- 一、创建项目与规范目录结构
- - 1. 打开 HBuilderX，创建一个新的 uni-app 项目。在创建时请选择 Vue 2 版本。
  - 2. 项目创建完成后，建议提前划分好目录结构。
- 二、配置四个 Tab 页面与底部导航栏
- - 2.1 添加图标资源
  - 2.2 页面结构准备
  - 2.3 配置 pages.json
- ✅ 总结

👍 点赞，你的认可是我创作的动力！

⭐️ 收藏，你的青睐是我努力的方向！

✏️ 评论，你的意见是我进步的财富！

一、创建项目与规范目录结构

1. 打开 HBuilderX，创建一个新的 uni-app 项目。在创建时请选择 Vue 2 版本。

2. 项目创建完成后，建议提前划分好目录结构。

虽然部分目录在初期可能暂未使用，但良好的结构有助于后续开发的规范和扩展。
推荐的目录结构如下：

/uni-app-wxschool/              # 项目根目录
├── /components/                # 公共组件（如卡片、导航栏等）
│   └── ...
│
├── /pages/                     # 页面目录
│   ├── /home/                  # 首页
│   │   └── index.vue
│   ├── /services/              # 校园服务
│   │   └── index.vue
│   ├── /forum/                 # 校园论坛
│   │   └── index.vue
│   ├── /profile/               # 用户中心
│   │   └── index.vue
│   └── /login/                 # 登录注册页
│       └── index.vue
│
├── /store/                     # Vuex 状态管理
│   └── index.js
│
├── /utils/                     # 工具函数（如请求封装、表单验证等）
│   └── ...
│
├── /common/                    # 通用配置（样式、常量、mixin 等）
│   └── ...
│
├── /static/                    # 静态资源（图片、图标等）
│   └── ...
└── config.js                   # 项目配置（如接口地址、环境变量等）
│ 	...													# 项目自带的其他文件

💡 注意事项：如果你手动创建了某些页面文件，记得检查 pages.json 是否正确引入了这些页面路径，否则页面将无法被识别。

二、配置四个 Tab 页面与底部导航栏

2.1 添加图标资源

在 /static/tabbar/ 目录中添加四个页面的图标，分别为选中与未选中状态，例如：

static/
└── tabbar/├── 11.png   # 首页默认图标├── 12.png   # 首页选中图标├── 21.png   # 服务默认图标├── 22.png   # 服务选中图标├── 31.png   # 论坛默认图标├── 32.png   # 论坛选中图标├── 41.png   # 我的默认图标└── 42.png   # 我的选中图标

👉 图标推荐来源：阿里巴巴矢量图标库（iconfont）

2.2 页面结构准备

确保以下页面结构已创建：

/pages/
├── /home/        → 首页
├── /services/    → 校园服务
├── /forum/       → 校园论坛
├── /profile/     → 用户中心

每个目录下至少应有一个 index.vue 页面文件。

2.3 配置 pages.json

在 pages.json 中添加页面配置与底部 tabBar 设置：

{"pages": [{"path": "pages/home/index","style": {"navigationBarTitleText": "首页"}},{"path": "pages/services/index","style": {"navigationBarTitleText": "校园服务"}},{"path": "pages/forum/index","style": {"navigationBarTitleText": "校园论坛"}},{"path": "pages/profile/index","style": {"navigationBarTitleText": "我的"}}],"tabBar": {"color": "#999999","selectedColor": "#007AFF","backgroundColor": "#FFFFFF","borderStyle": "black","list": [{"pagePath": "pages/home/index","text": "首页","iconPath": "static/tabbar/11.png","selectedIconPath": "static/tabbar/12.png"},{"pagePath": "pages/services/index","text": "服务","iconPath": "static/tabbar/21.png","selectedIconPath": "static/tabbar/22.png"},{"pagePath": "pages/forum/index","text": "论坛","iconPath": "static/tabbar/31.png","selectedIconPath": "static/tabbar/32.png"},{"pagePath": "pages/profile/index","text": "我的","iconPath": "static/tabbar/41.png","selectedIconPath": "static/tabbar/42.png"}]},"globalStyle": {"navigationBarTextStyle": "black","navigationBarTitleText": "校园生活平台","navigationBarBackgroundColor": "#F8F8F8","backgroundColor": "#F8F8F8"}
}