資訊專欄INFORMATION COLUMN
摘要：概述本篇文章承接上文，記錄的的配置和命令的詳細說明。的配置說明項目名稱，的時候就是使用這個。案例說明版本號，符合的版本規范的版本號，默認從開始。
0x000 概述
本篇文章承接上文，記錄的package.json的配置和npm命令的詳細說明。
0x001 package.json的配置
name：
說明：項目名稱，npm install的時候就是使用這個name。
案例：lodash、@followwinter/lodash
version：
說明：版本號，符合npm的版本規范的版本號，默認從1.0.0開始。
案例：1.0.0，2.0.1
description ：
說明：項目的簡介，如果不寫會默認讀去README.md的第一樣作為npmjs搜索時候的簡介
案例：這是一個好項目
keywords：
說明：關鍵詞
案例：lodash、js
homepage：
說明：項目主頁
案例：http://lodashjs.com/
license：
說明：協議
案例：BSD-3-Clause
main：
說明：模塊ID
案例：如果你的模塊名為foo,如果一個用戶使用require("foo")，就會返回一個你export出來的主對象。例如之前我們export一個printMsg,我們直接@followwinter/0x007-local-global-diff1就得到了一個對象，是因為我們指定了@followwinter/0x007-local-global-diff1中的package.json的mian為index。js。
// @followwinter/0x007-local-global-diff1/package.json
{
"name": "@followwinter/0x007-local-global-diff1",
"version": "1.0.2",
"description": "",
"main": "index.js",
"scripts": {
"test": "echo "Error: no test specified" && exit 1"
},
"author": "",
"license": "ISC"
}
// @followwinter/0x008-local-global-diff2/index.js
var myModule = require("@followwinter/0x007-local-global-diff1");
console.log(myModule);
myModule.printMsg();
dependencies：
說明：項目的依賴庫
version： 必須等于該版本
>version：必須大于該版本
>=version： 必須大于等于該版本
<=version： 必須小于等于該版本
~version： 大約等于該版本
^version： 和該版本可兼容的版本
1.2.x：1.2.* 版本
http://...：http地址
*：任意版本
""：任意版本
version1 - version2： 在version1到version2之間，包含version1和version2
range1 || range2：在范圍1或者范圍2之間
git...：git地址
user/repo：user/repo地址
tag： 該tag的版本
path/path/path 本地地址
案例：
{ "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"
, "lat" : "latest"
, "dyl" : "file:../dyl"
}
}
特殊說明
git地址格式：
git地址示例：
git+ssh://git@github.com:npm/npm.git#v1.0.27
git+ssh://git@github.com:npm/npm#semver:^5.0
git+https://isaacs@github.com/npm/npm.git
git://github.com/npm/npm.git#v1.0.27
//現在還可以直接這么寫
{
"name": "foo",
"version": "0.0.0",
"dependencies": {
"express": "expressjs/express",
"mocha": "mochajs/mocha#4727d357ea",
"module": "user/repo#feature/branch"
}
}
本地地址
../foo/bar ~/foo/bar ./foo/bar /foo/bar // 以下寫法更優
{
"name": "baz",
"dependencies": {
"bar": "file:../foo/bar"
}
}
devDependencies：
說明：開發依賴
案例：同上
bin:
說明：可執行目錄
案例：
//`npm installl -g`的時候回將`cli.js`復制到`/usr/local/bin/myapp`,就可以使用`myapp`作為命令了，比如`webpack` { "bin" : { "myapp" : "./cli.js" } }
scripts:
說明：自定義命令，也可以覆蓋自定義命令
默認值：
"start": "node server.js"：執行server.js
"install": "node-gyp rebuild"：安裝依賴
自定義指令：
"test":"jtest", "build":"npm install && npm test && npm publish --access public"
執行自定義指令：
如果是覆蓋默認指令，直接使用默認指令便可，比如npm install、npm start，如果是自定義指令，則需要使用npm run
version：版本
npm version [| major | minor | patch | premajor | preminor | prepatch | prerelease | from-git] "npm [-v | --version]" 查看`npm`版本 "npm view version" 查看某個包的版本 "npm ls" 列出當前依賴的包
cache：緩存
"npm cache clean []" 清除緩存 aliases: npm cache clear, npm cache rm
dedupe：重構
"npm dedupe" 重新整理依賴包架構
"npm ddp"
aliases: find-dupes, ddp
// 執行前
+-- b <-- depends on c@1.0.x
| `-- c@1.0.3
`-- d <-- depends on c@~1.0.9
`-- c@1.0.10
//執行后
+-- b
+-- d
`-- c@1.0.10
init：初始化
npm init [-f|--force|-y|--yes] 加了參數就不會提示任何信息了
install：安裝
npm install (with no args, in package dir) npm install [<@scope>/]npm install [<@scope>/] @ npm install [<@scope>/] @ npm install [<@scope>/] @ npm install : / npm install npm install npm install npm install alias: npm i common options: [-P|--save-prod|-D|--save-dev|-O|--save-optional] [-E|--save-exact] [-B|--save-bundle] [--no-save] [--dry-run]
upinstall：卸載
npm uninstall [<@scope>/][@ ]... [-S|--save|-D|--save-dev|-O|--save-optional|--no-save] aliases: remove, rm, r, un, unlink
update：更新
npm update [-g] [...] aliases: up, upgrade
publish：發布
