Name
必须字段。
提示：
- 不要在name中包含js, node字样；
- 这个名字不能以点号或下划线开头；
- 这个名字不能包含有大写字母；
- 这个名字可能在require()方法中被调用，所以应该尽可能短；
-
name字段不能含有非URL安全的字符，因为它将当发布的时候，它将作为你的包的相关信息被写入URL中那么，有哪些算是非URL安全的字符呢？
Version
必须字段。
npm有自己的检验version的模块——node-semver
const semver = require(‘semver‘) semver.valid(‘1.2.3‘) // ‘1.2.3‘ semver.valid(‘a.b.c‘) // null
Description
可选字段，必须是字符串。npm search的时候会用到。
Keywords
可选字段，字符串数组。npm search的时候会用到。
简单地说，Description和Keywords是npm搜索系统中的搜索条件，所以。如果你试图发布的是一个开源插件，那么这两个字段你应该重视
Homepage
可选字段，没有http://等带协议前缀的URL。
Bugs
可选字段，问题追踪系统的URL或邮箱地址；npm bugs用的上。
{ "url" :"http://github.com/owner/project/issues",
"email" :"project@hostname.com"
}
License
可选字段。
如果是使用一个普遍的license，比如BSD-3-Clause或MIT，直接使用：
{ "license" : "BSD-3-Clause" }Author, contributors
都是可选字段。author是一个人，contributors是一组人。
Author的格式如下：
{ "name" : "Barney Rubble", "email" : "b@rubble.com", "url" : "http://barnyrubble.tumblr.com/"}
这种格式也可以：
"Barney Rubble <b@rubble.com> (http://barnyrubble.tumblr.com/)"Files
可选字段，项目包含的一组文件。如果是文件夹，文件夹下的文件也会被包含。如果需要把某些文件不包含在项目中，添加一个”.npmignore”文件。这个文件和”gitignore”类似。
Main
可选字段。这个字段的值是你程序主入口模块的ID。
Bin
可选字段。很多的包都会有执行文件需要安装到PATH中去。
这个字段对应的是一个Map，每个元素对应一个{ 命令名：文件名 }。
{ "bin" : { "npm" : "./cli.js" } }Directories
用于指示包的目录结构：
Directories.lib
指示库文件的位置。
Directories.bin
和前面的bin是一样的，但如果前面已经有bin，那么这个就无效。
除了以上两个，还有Directories.doc& Directories.man & Directories.example。
Repository
可选字段。用于指示代码存放的位置。
"repository" : { "type" : "git" , "url" : "http://github.com/npm/npm.git" } "repository" : { "type" : "svn" , "url" : "http://v8.googlecode.com/svn/trunk/" }Scripts
写进scripts的命令(command),可以通过npm run <command>或者npm <command> 运行对应的shell指令，例如：
{
"scripts": { "start": "node main.js"}
}
可以让你在终端输入npm start的时候，等同于运行了node main.js
什么时候要加“run”,什么时候可以不用加“run”呢？
"scripts": {
"build": "XXX.js"
}
的时候，你运行XXX.js就只能通过npm run build去运行了
npm为script字段中的脚本路径都加上了node_moudles/.bin前缀
就多了一个叫做webpack的脚本
"scripts": {"start": "webpack"}
"scripts": {"start": "node_modules/.bin webpack"}
npm start是有默认值的，默认为：node server.js
· "scripts":{"start": "node server.js"}
如果你的包里有server.js文件，npm默认将执行： node server.js.
· "scripts":{"preinstall":"node-gyp rebuild"}
如果包里有binding.gyp，npm默认在preinstall命令时，使用node-gyp做编译。
better-npm-run的安装与betterScript字段的使用
"scripts": {
"test": "NODE_ENV=production karma start"
}
"scripts": {
"test": "better-npm-run test"
},
"betterScripts": {
"test": {
"command": "karma start",
"env": {
"NODE_ENV": "test"
}
}
}
if (process.env.NODE_ENV === ‘development‘) {
// 省略诸多内容
app.use(require(‘webpack-hot-middleware‘)(compiler, {
path: ‘/__webpack_hmr‘
}))
}
Config
可选字段，object。
Config对象中的值在Scripts的整个周期中皆可用，专门用于给Scripts提供配置参数。
Dependencies
可选字段，指示当前包所依赖的其他包。
{ "dependencies" : { "foo" : "1.0.0 - 2.9999.9999" , "bar" : ">=1.0.2 <2.1.2" , "baz" : ">1.0.2 <=2.3.4" , "boo" : "2.0.1" , "qux" : "<1.0.0 || >=2.3.1 <2.4.5 || >=2.5.2 <3.0.0" , "asd" : "http://asdf.com/asdf.tar.gz" , "til" : "~1.2" , "elf" : "~1.2.3" , "two" : "2.x" , "thr" : "3.3.x" }}版本格式可以是下面任一种：
version完全匹配>version大于这个版本>=version大于或等于这个版本<version<=version~version非常接近这个版本^version与当前版本兼容1.2.xX代表任意数字，因此1.2.1, 1.2.3等都可以http://...Unix系统下使用的tarball的URL。*任何版本都可以""任何版本都可以version1 - version2等价于>=version1 <=version2.range1 || range2满足任意一个即可git...Git地址user/repo
devDependencies
可选字段。如果只需要下载使用某些模块，而不下载这些模块的测试和文档框架，放在这个下面比较不错。
dependencies字段和devDependencies字段的区别
怎么区分到底安装包的时候放在dependencies中还是devDepencies中呢？
peerDependencies
可选字段。兼容性依赖。如果你的包是插件，适合这种方式。
bundledDependencies
可选字段。发布包时同时打包的其他依赖。
optionalDependencies
可选字段。如果你想在某些依赖即使没有找到，或则安装失败的情况下，npm都继续执行。那么这些依赖适合放在这里。
Engines
可选字段。既可以指定node版本：
{ "engines" : {"node" : ">=0.10.3 <0.12" } }
也可以指定npm版本：
{ "engines" : {"npm" : "~1.0.20" } }
engineStrick
可选字段，布尔值。如果你肯定你的程序只能在制定的engine上运行，设置为true。
Os
可选字段。指定模块可以在什么操作系统上运行：
"os" : [ "darwin","linux" ]
"os" : [ "!win32" ]
CPU
可选字段。指定CPU型号。
"cpu" : [ "x64","ia32" ]
"cpu" : [ "!arm","!mips" ]
preferGlobal
可选字段，布尔值。如果你的包是个命令行应用程序，需要全局安装，就可以设为true。
Private
可选字段，布尔值。如果private为true，npm会拒绝发布。这可以防止私有repositories不小心被发布出去。
publishConfig
可选字段。发布时使用的配置值放这。
