一个典型的微信小程序项目的基本目录结构如下:
1project-name/
2│
3├── pages/ # 页面文件夹
4│ ├── index/ # 页面文件夹(例如:首页)
5│ │ ├── index.wxml # 页面结构文件
6│ │ ├── index.wxss # 页面样式文件
7│ │ ├── index.js # 页面逻辑文件
8│ │ └── index.json # 页面配置文件(可选)
9│ ├── logs/ # 另一个页面文件夹(例如:日志页)
10│ │ ├── logs.wxml
11│ │ ├── logs.wxss
12│ │ ├── logs.js
13│ │ └── logs.json
14│ └── ... # 更多页面
15│
16├── utils/ # 工具函数文件夹
17│ ├── util.js # 工具函数文件
18│ └── ...
19│
20├── assets/ # 静态资源文件夹
21│ ├── images/ # 图片资源
22│ │ ├── logo.png
23│ │ └── ...
24│ ├── audio/ # 音频资源
25│ ├── video/ # 视频资源
26│ └── ...
27│
28├── styles/ # 全局样式文件夹(如果需要)
29│ ├── app.wxss # 应用全局样式文件
30│ └── ...
31│
32├── components/ # 自定义组件文件夹
33│ ├── my-component/ # 自定义组件文件夹
34│ │ ├── my-component.wxml
35│ │ ├── my-component.wxss
36│ │ ├── my-component.js
37│ │ └── my-component.json
38│ └── ...
39│
40├── app.js # 小程序入口文件
41├── app.json # 小程序公共配置文件
42├── app.wxss # 小程序全局样式文件
43└── project.config.json # 项目配置文件(记录小程序的配置信息和第三方插件等)
主要目录和文件的功能说明:
-
pages/: 存放所有页面的文件夹。每个页面由四个文件组成(
.wxml
,.wxss
,.js
,.json
),分别代表页面的结构、样式、逻辑和配置。 -
utils/: 存放项目中复用的工具函数或模块,比如日期格式化、网络请求封装等。
-
assets/: 存放项目中使用的静态资源,如图片、音频、视频等。
-
styles/: 如果有全局样式需求,可以在这里定义,最常见的是
app.wxss
,用于存放整个小程序的全局样式。 -
components/: 自定义组件的存放目录,每个自定义组件也包含
.wxml
,.wxss
,.js
,.json
四个文件,用于构建可复用的UI部件。 -
app.js: 小程序的入口JavaScript文件,用于注册小程序实例,进行全局的初始化设置等。
-
app.json: 小程序的全局配置文件,用于配置小程序的页面路径、窗口表现、网络超时时间、底部tab等。
-
app.wxss: 小程序的全局样式文件,用于设置小程序的整体样式。
-
project.config.json: 项目的配置文件,记录了项目的配置信息,如编译设置、插件依赖等,由开发者工具自动生成并维护。