什么是 package.json?
package.json 文件是一个我的项目一种展现形式。
它是工具配置的地方存储库。这也是 npm 和 yarn 存储所有已安装包的名称和版本的中央。

1. 文件构造

上面是 package.json 文件的一个例子：

{}

这是一个空对象。对于一个利用中的 package.json 文件来说，除了须要恪守 JSON 格局，没有任何固定的要求。
然而如果你正在构建一个想要通过 npm 散发的 Node.js 包，事件的性质不太一样了，必须有一组属性来帮忙其他人应用它。

这是另外一个 package.json 文件：

{"name": "test-project"}

这个文件中，定义了 name 属性，这个属性能够定义 app 或者包的名称。

上面这个文件有更多的属性：

{
  "name": "test-project",
  "version": "1.0.0",
  "description": "A Vue.js project",
  "main": "src/main.js",
  "private": "true",
  "scripts": {
    "dev": "webpack-dev-server --inline --progress --config build/webpack.dev.conf.js",
    "start": "npm run dev",
    "unit": "jest --config test/unit/jest.conf.js --coverage",
    "test": "npm run unit",
    "lint": "eslint --ext .js,.vue src test/unit",
    "build": "node build/build.js"
  },
  "depedencies": {"vue": "^2.5.2"},
  "devDependencies": {
    "autoprefixer": "^7.1.2",
    "babel-core": "^6.22.1",
    "babel-eslint": "^8.2.1",
    "babel-helper-vue-jsx-merge-props": "^2.0.3",
    "babel-jest": "^21.0.2",
    "babel-loader": "^7.1.1",
    "babel-plugin-dynamic-import-node": "^1.2.0",
    "babel-plugin-syntax-jsx": "^6.18.0",
    "babel-plugin-transform-es2015-modules-commonjs": "^6.26.0",
    "babel-plugin-transform-runtime": "^6.22.0",
    "babel-plugin-transform-vue-jsx": "^3.5.0",
    "babel-preset-env": "^1.3.2",
    "babel-preset-stage-2": "^6.22.0",
    "chalk": "^2.0.1",
    "copy-webpack-plugin": "^4.0.1",
    "css-loader": "^0.28.0",
    "eslint": "^4.15.0",
    "eslint-config-airbnb-base": "^11.3.0",
    "eslint-friendly-formatter": "^3.0.0",
    "eslint-import-resolver-webpack": "^0.8.3",
    "eslint-loader": "^1.7.1",
    "eslint-plugin-import": "^2.7.0",
    "eslint-plugin-vue": "^4.0.0",
    "extract-text-webpack-plugin": "^3.0.0",
    "file-loader": "^1.1.4",
    "friendly-errors-webpack-plugin": "^1.6.1",
    "html-webpack-plugin": "^2.30.1",
    "jest": "^22.0.4",
    "jest-serializer-vue": "^0.3.0",
    "node-notifier": "^5.1.2",
    "optimize-css-assets-webpack-plugin": "^3.2.0",
    "ora": "^1.2.0",
    "portfinder": "^1.0.13",
    "postcss-import": "^11.0.0",
    "postcss-loader": "^2.0.8",
    "postcss-url": "^7.2.1",
    "rimraf": "^2.6.0",
    "semver": "^5.3.0",
    "shelljs": "^0.7.6",
    "uglifyjs-webpack-plugin": "^1.1.1",
    "url-loader": "^0.5.8",
    "vue-jest": "^1.0.2",
    "vue-loader": "^13.3.0",
    "vue-style-loader": "^3.0.1",
    "vue-template-compiler": "^2.5.2",
    "webpack": "^3.6.0",
    "webpack-bundle-analyzer": "^2.9.0",
    "webpack-dev-server": "^2.9.1",
    "webpack-merge": "^4.1.0"
  },
  "engines": {
    "node": ">= 6.0.0",
    "npm": ">=3.0.0"
  },
  "browserslist": ["> 1%", "last 2 versions","not ie<=8"]
}

version表明了以后的版本
description 是 app/ 包 的简要形容
main 设置利用的入口处
private 如果被设置为 true，将会阻止 app/ 包 在 npm 上意外公布
scripts 定义了一系列开发人员能够运行的 node 脚本
dependencies 设置了一系列的须要被装置的包
devDependencies 设置了一系列的开发时须要被装置的包
engines 设置了以后包 /app 应该运行的 node.js 的版本
browserslist 被用来通知这个我的项目你心愿反对的浏览器版本

2. 属性拆分

这一部分具体介绍能够应用的属性。指的是“包”的属性，但同样也实用于不用作包的本地应用程序。

大多数这些属性仅在 https://www.npmjs.com/ 上应用，其余属性则由与您的代码交互的脚本应用，例如 npm 或其余。

2.1 name

设置包的名称。
例子：
"name": "test-project"
这个名称必须要小于 214 个字符，只能蕴含小写字母，连字符和下划线。

2.2 author

列举包的作者名称

{"author": "Joe<joe@whatever.cim>(http://whatever.com)"
}

2.3 contributors

和 author 一样，一个我的项目有一个或者多个贡献者。这个属性是一个数组。

{"contributors": ["Joe <joe@whatever.com> (https://whatever.com)"]
}

2.4 bugs

包的问题跟踪器的链接，就像是 GitHub 问题页面。

{"bugs": "https://github.com/whatever/package/issues"}

2.5 homepage

设置包的主页

{"homepage": "https://whatever.com/package"}

2.6 version

显示包的以后版本。

{"version": "1.0.0"}

2.7 license

显示包的许可证。

{"license": "MIT"}

2.8 keywords

此属性蕴含一组与包的性能相关联的关键字。

{
  "keywords": [
    "email",
    "machine learning",
    "ai"
  ]
}

2.9 description

此属性蕴含了包的简要形容。

{"description": "A package to work woth strings"}

2.10 repository

此属性具体形容了这个包的库位于什么地位。

{"repository": "github:whatever/testing"}

2.11 main

设置包的入口处。

{"main": "scr/main.js"}

2.12 private

如果被设置为true，将会阻止 app/ 包 在 npm 上意外公布。

{"private": true}

2.13 scripts

定义了一系列开发人员能够运行的 node 脚本。

{
  "scripts": {
    "dev": "webpack-dev-server --inline --progress --config build/webpack.dev.conf.js",
    "start": "npm run dev",
    "unit": "jest --config test/unit/jest.conf.js --coverage",
    "test": "npm run unit",
    "lint": "eslint --ext .js,.vue src test/unit",
    "build": "node build/build.js"
  }
}

2.14 dependencies

设置了一系列的须要被装置的包。

{
  "dependencies": {"vue": "^2.5.2"}
}

2.15 devDependencies

设置了一系列的开发时须要被装置的包。

{
  "devDependencies": {
    "autoprefixer": "^7.1.2",
    "babel-core": "^6.22.1"
  }
}

2.16 engines

设置了以后包 /app 应该运行的 node.js 的版本。

{
  "engines": {
    "node": ">= 6.0.0",
    "npm": ">= 3.0.0",
    "yarn": "^0.13.0"
  }
}

2.17 browserslist

被用来通知这个我的项目你心愿反对的浏览器版本。

{
  "browserslist": [
    "> 1%",
    "last 2 versions",
    "not ie <= 8"
 ]
}