【微信小程序】project.config.json配置

{
  "description": "項目配置文件。",
  "packOptions": { //打包配置選項
    "ignore": [] //配置打包時對符合指定規則的文件或文件夾進行忽略，跳過打包的過程，這些文件或文件夾不會出現在預覽或上傳的結果內
  },
  "setting": { //項目設置
    "urlCheck": true, //是否檢查安全域名和TLS版本
    "es6": true, //是否啟用es5轉es6
    "postcss": true, //上傳代碼時樣式是否自動補全
    "minified": true, //上傳代碼時是否自動壓縮
    "newFeature": true
  },
  "compileType": "miniprogram", //編譯類型,miniprogram當前為普通小程序項目。plugin當前為小程序插件項目
  "libVersion": "2.0.8", //基礎庫版本
  "appid": "wxf5b8ab7a81a76efa", //APPID，只在新建項目時讀取
  "projectname": "test2", //項目名稱，只在新建項目時讀取
  "isGameTourist": false,
  "condition": {
    "search": {
      "current": -1,
      "list": []
    },
    "conversation": {
      "current": -1,
      "list": []
    },
    "game": {
      "currentL": -1,
      "list": []
    },
    "miniprogram": {
      "current": -1,
      "list": []
    }
  }
}

參數
字段名 類型 說明
miniprogramRoot Path String 指定小程序源碼的目錄(需為相對路徑)
qcloudRoot Path String 指定騰訊雲項目的目錄(需為相對路徑)
pluginRoot Path String 指定插件項目的目錄(需為相對路徑)
compileType String 編譯類型
setting Object 項目設置
libVersion String 基礎庫版本
appid String 項目的 appid，只在新建項目時讀取
projectname String 項目名字，只在新建項目時讀取
packOptions Object 打包配置選項
debugOptions Object 調試配置選項
scripts Object 自定義預處理
 

compileType 有效值

名字 說明
miniprogram 當前為普通小程序項目
plugin 當前為小程序插件項目
setting 中可以指定以下設置

字段名 類型 說明
es6 Boolean 是否啟用 es6 轉 es5
postcss Boolean 上傳代碼時樣式是否自動補全
minified Boolean 上傳代碼時是否自動壓縮
urlCheck Boolean 是否檢查安全域名和 TLS 版本
uglifyFileName Boolean 是否進行代碼保護
scripts 中指定自定義預處理的命令

名字 說明
beforeCompile 編譯前預處理命令
beforePreview 預覽前預處理命令
beforeUpload 上傳前預處理命令
 

packOptions

packOptions 用以配置項目在打包過程中的選項。打包是預覽、上傳時對項目進行的必須步驟。

目前可以指定 packOptions.ignore 字段，用以配置打包時對符合指定規則的文件或文件夾進行忽略，以跳過打包的過程，這些文件或文件夾將不會出現在預覽或上傳的結果內。

packOptions.ignore 為一對象數組，對象元素類型如下：

字段名 類型 說明
value string 路徑1或取值
type string 類型
其中，type 可以取的值為 folder、file、suffix、prefix、regexp2、glob2，分別對應文件夾、文件、后綴、前綴、正則表達式、Glob 規則。所有規則值都會自動忽略大小寫。

注 1: value 字段的值若表示文件或文件夾路徑，以小程序目錄 (miniprogramRoot) 為根目錄。

注 2: regexp、glob 僅 1.02.1809260 及以上版本工具支持。

{
  "packOptions": {
    "ignore": [{
      "type": "file",
      "value": "test/test.js"
    }, {
      "type": "folder",
      "value": "test"
    }, {
      "type": "suffix",
      "value": ".webp"
    }, {
      "type": "prefix",
      "value": "test-"
    }, {
      "type": "glob",
      "value": "test/**/*.js"
    }, {
      "type": "regexp",
      "value": "\\.jsx$"
    }]
  }
}

注: 這部分設置的更改可能需要重新打開項目才能生效。

debugOptions
debugOptions 用以配置在對項目代碼進行調試時的選項。

目前可以指定 debugOptions.hidedInDevtools 字段，用以配置調試時於調試器 Sources 面板隱藏源代碼的文件。

hidedInDevtools 的配置規則和 packOptions.ignore 是一致的。

當某個 js 文件符合此規則時，調試器 Sources 面板中此文件源代碼正文內容將被隱藏，顯示為：

// xxx.js has been hided by project.config.json
注：配置此規則后，可能需要關閉並重新打開項目才能看到效果。

項目配置示例：
---------------------

{
  "miniprogramRoot": "./src",
  "qcloudRoot": "./svr",
  "setting": {
    "postcss": true,
    "es6": true,
    "minified": true,
    "urlCheck": false
  },
  "packOptions": {
    "ignore": []
  },
  "debugOptions": {}
}