最近接手一个项目时，注意到其package.json中的依赖有的书写方式没见过，这里学习了一下package.json中dependency的不同写法。

接手的项目中出现了下面这样的写法：

"xxx": "git+ssh://git@xxx.xxx.com/xxx/xxx/xxx#v1.0.0"

"@xxx/project-name": "~0.0.1",

之前也在其他项目中见过：

"xxx": "http://gitlab.xxx.com/xxx/xxx/archive.tar.gz?ref=0.0.1"

在业务开发中我们经常会自己开发一些包，这些包可能放在不同的地方，多种写法可以帮助我们方便的使用这些包。

什么是一个package

首先来了解一个package是指什么，A package is:

1. folder containing a program described by a package.json file
2. gzipped tarball containing (1)
3. url that resolves to (2)
4. @ that is published on the registry (see npm-registry) with (3)
5. @ (see npm-dist-tag) that points to (4)
6. that has a “latest” tag satisfying (5)
7. that resolves to (1)

package中版本的写法

语义化版本号

最常见的是在package.json中制定版本号，版本号要符合semver。

"hexo": "^3.3.7"

大体有以下几种:

• version Must match version exactly
• >version Must be greater than version
• >=version etc
• <version
• <=version
• ~version “Approximately equivalent to version” See semver
• ^version “Compatible with version” See semver
• 1.2.x 1.2.0, 1.2.1, etc., but not 1.3.0
• * Matches any version
• "" (just an empty string) Same as *
• version1 - version2 Same as >=version1 <=version2.
• range1 || range2 Passes if either range1 or range2 are satisfied

tarball URL

直接指定一个tarball URL，在npm install时会将tarball文件，也就是.tar文件下载安装。

"xxx": "http://gitlab.xxx.com/xxx/xxx/archive.tar.gz?ref=0.0.1"

tarball的内容应当是

a folder containing a program described by a package.json file

通常gitlab在标记tag以后，会自动生成.tar文件。

Git URL

也可以使用git url直接从代码仓库中拉取包。

"xxx": "git+ssh://git@github.com:npm/npm.git#v1.0.27"

Git urls为以下形式：

<protocol>://[<user>[:<password>]@]<hostname>[:<port>][:][/]<path>[#<commit-ish> | #semver:<semver>]

其中，是以下几种形式：

• git
• git+ssh
• git+http
• git+https
• git+file.

GitHub URL

可以直接指定一个github目录，例如

`"express": "expressjs/express"

Local Paths

指定本地地址，只要指定的目录是有个package

"bar": "file:../foo/bar"

区分不同registry

这里有个区分不同registry的方法，在用户根目录下建立.npmrc，其中内容：

registry=https://registry.npm.taobao.org/
@xxx:registry=http://registry.npm.xxx.com

那么，在package.json中以"@xxx/xxx": ""方式书写的package都会使用不同的仓库。

npm install

除了package.json，这里也列举以下npm install可以接受的写法：

npm install (with no args, in package dir)
npm install [<@scope>/]<name>
npm install [<@scope>/]<name>@<tag>
npm install [<@scope>/]<name>@<version>
npm install [<@scope>/]<name>@<version range>
npm install <git-host>:<git-user>/<repo-name>
npm install <git repo url>
npm install <tarball file>
npm install <tarball url>
npm install <folder>

alias: npm i
common options: [-P|--save-prod|-D|--save-dev|-O|--save-optional] [-E|--save-exact] [-B|--save-bundle] [--no-save] [--dry-run]

本地开发多个package

有时候我们的项目可能会依赖我们自己开发的package，尽管可以指定Local Paths，但是每次都还要npm i，也是很麻烦。

这里可以使用sync-files, 来直接同步自己开发的package。

例如：

sync-files -w ./src ../other-project/node_modules/your-package/src