在目录树下，点击pages目录，点击index目录，点击logs目录，点击utils目录，打开一切可以打开的目录，唯有如此，方能爽爽地窥探整个目录结构的全貌，方能更好地熟悉配置文件、应用文件和页面文件的应用。

2.1 配置文件

工程配置文件project.config.json，用来配置appid、项目名称、调试基础库，还有云开发的文件夹路径。如果你不想开发微信小程序了，不想在IT界混了，那你大可毫不留情地删除它，否则请保留。

索引配置文件sitemap.json，用于配置页面是否可被索引(搜索)。 action为allow表示同意索引，disallow表示不同意；page为*表示所有页面可被索引，pages/index/index则指定某个页面可被索引。

如果删除sitemap.json文件，则默认为所有页面都允许被索引。在实际开发产品时，几乎都是用默认，既aciton为allow的情况。细的规则在用到时，上网找一下就好了。

2.2 应用文件

一个小程序项目，在根目录下会有3个应用文件，一个是全局业务逻辑文件app.js，一个是公共配置文件app.json，还有一个是公共样式表文件app.wxss。在这3个文件中，app.js和app.json是不可删除，是必须有的文件。

1. app.js

打开文件的那一瞬间，我才知道：人生遇到的人很多，但真正懂你的人却寥寥无几。懂你的人，即使你不说话，他也知道你的喜怒哀乐。不懂你的人呢，就给你一大堆代码，也不管你是否有了基础。如果有基础，我看这个干啥，如果没有，我看这个干啥？

清空onLaunch里面的代码，只留一个空方法就好。好看的皮囊千篇一律，有趣的灵魂万里挑一。App()必须且只能在app.js中调用一次，否则会出现无法预期的后果。

在onLaunch或其他函数中，可通过this(App实例)调用globalData全局变量。

<code>//app.js
App({
  onLaunch: function () {
\t\tlet user = this.globalData.userInfo;
  },
  globalData: {
    userInfo: null 

  }
})/<code>

在App()里，除了onLaunch，还有onShow、onError等函数。

备注：当用户点击左上角关闭，或者按了设备 Home 键离开微信，小程序并没有直接销毁而是进入了后台；当再次进入微信或再次打开小程序，又会从后台进入前台。

如果想在onLaunch或onShow函数中，获取相关参数内容，只要带上参数option一起飞就可以了。

<code>//app.js
App({
  /**
   *启动执行的初始化方法
   * 首次打开时执行，全局只触发一次
   */
  onLaunch: function(options) {
    console.log('page:', options.path);
  },
  //小程序启动或从后台进入到前台时触发
  onShow: function(options) {
    console.log('scene:', options.scene);
  },
  //全局变量
  globalData: {
    userInfo: null
  }
})/<code>

输出结果：

<code>page: pages/index/index
scene: 1001/<code>

options可以获取的值列表

2. app.json

全局配置文件，可配置且必须配置的页面路径；可配置窗口风格，如标题栏背景色和标题；可配置全局tab标签、网络超时时间和多tab等。常用配置项列表如下。

pages

每一项代表对应页面的路径和文件名(不用后缀)，数组的第一项为首页。小程序添加或删除页面时，必须跟pages同步。

<code>"pages": [
  "pages/index/index",
  "pages/logs/logs"
 ]/<code>

window

用于设置小程序的状态栏、导航条、标题、窗口背景色。

类型中的HexColor为十六进制颜色值，如"#ff0000"。属性backgroundColor配置的窗口背景色，在下拉刷新或上拉加载时才能见到。如果要配置页面背景色，可到app.wxss进行全局配置或到index.wxss进行单个页面配置。

<code>"window": {
  "backgroundTextStyle": "light",
  "navigationBarBackgroundColor": "#00a24d",
  "navigationBarTitleText": "导航栏标题",
  "backgroundColor": "#cccccc",
  "navigationBarTextStyle": "white",
  "enablePullDownRefresh": true
}/<code>

tabBar

如果小程序是一个多 tab 应用，可以通过tabBar配置项指定tab栏的表现，以及 tab 切换时显示的对应页面。tab数目最少 2 个、最多 5 个。

其中 list 接受一个数组，数组中的每个项都是一个对象，属性列表。

图标大小限制为40kb，建议尺寸为 81px * 81px，当postion为top，既tab在顶部时，iconPath和selectedIconPath无效。

在项目根目录下新建images目录，上网搜索“首页”、“日志”图标。图标默认颜色为：#8b8b8b，选中时颜色为：#00a24d，大小为81*81。如果实在不想折腾，那就关注公众号半码，输入:芝麻开门，获取图标下载地址。

<code>"tabBar": {
    "borderStyle": "black",
    "backgroundColor": "#ffffff",
    "color": "#8b8b8b",
    "selectedColor": "#00a24d",
    "list": [
      {
        "iconPath": "images/index.png",
        "selectedIconPath": "images/index_p.png",
        "pagePath": "pages/index/index",
        "text": "首页"
      },
      {
        "iconPath": "images/log.png",
        "selectedIconPath": "images/log_p.png",
        "pagePath": "pages/logs/logs",
        "text": "日志"
      }
    ]
  }/<code>

networkTimeout

网络请求的超时时间，默认为60000毫秒，既1分钟，在调用wx.uploadFile上传文件，wx.downloadFile下载文件，wx.request上传/下载数据和wx.connectSocket网络通信接口时会用到。

<code>"networkTimeout": {
    "request": 10000,
    "downloadFile": 10000
  }/<code>

requiredBackgroundModes

配置在后台运行的能力，目前只支持audio:后台播放音乐和location:后台定位两项。

<code>"requiredBackgroundModes": [
   "audio",
   "location"
 ]/<code>

navigateToMiniProgramAppIdList

当前小程序需要使用 wx.navigateToMiniProgram 接口跳转到其他小程序时，需要先在配置文件中声明需要跳转的小程序appId 列表，最多允许填写 10 个。

<code>navigateToMiniProgramAppIdList

当前小程序需要使用 wx.navigateToMiniProgram 接口跳转到其他小程序时，需要先在配置文件中声明需要跳转的小程序appId 列表，最多允许填写 10 个。/<code> 

permission

小程序用到敏感功能,如获取地理位置时，需要弹窗询问用户，用户点击同意后才可调用接口获取相关信息，如经纬度。询问窗口上的内容，就是这里的desc值。

<code>"permission": {
    "scope.userLocation": {
      "desc": "唯有授予位置权限，才好找你吹牛皮"
    }
  }/<code>

3. app.wxss

WXSS是一套样式语言，用于描述WXML文件里的组件样式，决定组件应该怎么显示。为了可对wxss资源进行复用，小程序对CSS进行了扩充，使其支持：通过@import语句后接外联样式表的相对路径并用;结束的方式导入样式。

app.wxss为公共样式表，不用显示引入，便可在页面文件wxml中使用。

<code>/** common.wxss **/
.bg {
    background-color: #cccccc;
}

/**app.wxss**/
@import "common.wxss";

.container {
  height: 100%;
  display: flex;
  flex-direction: column;
  align-items: center;
  justify-content: space-between;
  padding: 200rpx 0;
  box-sizing: border-box;
} /<code>

2.3 页面文件

一个小程序应用，由index，logs等多个页面组成。一个页面，包含4个同名，不同后缀的文件，它们分别是负责配置的json，布局的wxml，样式的wxss和业务逻辑的js。其中，wxml和js是不可删除，是必须有的文件。

1. index.json

每一个小程序页面也可以使用.json文件来对本页面的窗口表现进行配置。页面中配置项在当前页面会覆盖app.json的window中相同的配置项。

以上属性的含义跟app.json里的是一模一样的，我就不重复讲了，再讲的话，怕你用时间跟我换金钱。

<code>{ 

  "navigationBarTitleText": "首页",
  "navigationBarTextStyle": "black"
}/<code>

我没钱，只好说下页面json文件才有的disableScroll和usingComponents属性。disableScroll默认为false，设置为true时页面不能上下滚动。usingComponents用来引入第3方组件，唯有在json文件中引入的，才可以在wxml文件中使用。这个只是示例代码，等讲到组件时，就自然明白了。

<code>{
  "usingComponents": {
    "mp-cells": "../../components/cells/cells",
    "mp-cell": "../../components/cell/cell"
  },
  "disableScroll": true
}/<code>

2. index.js

在页面js文件中，可在Page()里面指定页面的初始数据、生命周期回调、事件处理函数等；可在外面引入模块和getApp()等。

<code>const util = require('../../utils/util.js')
const app = getApp()

Page({
  data: {
    motto: 'Hello World'
  },
  //自定义函数
  bindViewTap: function() {},
  //页面加载时触发
  onLoad: function() {}
})/<code>

初始化数据的data，在页面第一次渲染时使用。自定义函数bindViewTap，绑定页面组件，在用户触发时调用。onLoad为生命周期函数，在页面加载时触发，可通过this调用自定义函数。有关函数的更多内容，咱骑驴看唱本，走着瞧。

3. index.wxml

WXML（WeiXin Markup Language）是框架设计的一套标签语言，结合基础组件、事件系统，可以构建出wxml页面的结构。关于WXML的更多内容，在后面会花多点篇章、花多点时间、花多点心思进行详细的介绍。

<code>
<view>
    <text>{{motto}}/<text>
/<view>/<code>

4. index.wxss

在page的 wxss文件中定义的样式为局部样式，只作用在对应的页面，并会覆盖 app.wxss 中相同的选择器。

<code>/**index.wxss**/
.userinfo {
  display: flex;
  flex-direction: column;
  align-items: center;
}

.userinfo-avatar {
  width: 128rpx;
  height: 128rpx;
}

.usermotto {
  margin-top: 200px;
}/<code>

能坚持看到这的人，都是能做事的码农，如果能答对我要问的问题，肯定会让他人佩服得五体投床的。那么问题就来了：仔细观察上面index.wxss里的内容，猜一猜哪一个东西在CSS是没见过的？

没错，rpx在CSS里是不曾有过的，你猜对没？--如果猜对的话，我就五体投床去了，如果没猜对的话，我就五体投床去了，因为五体投地还得洗衣服。

rpx为小程序特有的尺寸单位，可解决屏幕宽度进行自适应的问题。它以屏幕宽为750rpx为基准。如在 iPhone6 上，屏幕宽度为375px，共有750个物理像素，则750rpx = 375px = 750物理像素，1rpx = 0.5px = 1物理像素。

猜对上面问题的人，给你10分钟，一边嘚瑟去吧。没猜对的人，赶紧抓紧机会，猜猜.userinfo和.usermotto用的是哪种选择器？

没错，答案就在下表中。你真聪明！

好了，项目文件就这样了，没什么要说的了。如果你还没搞懂的话，就从头到尾再多学几遍，如果你还没搞懂的话，就从头到尾再多学几遍，直到能去框架语法为止。

閱讀更多 半碼 的文章

關鍵字: 一个 Pages 文件