npm初识 Getting Started

npm官方文档

• npm更新：npm install npm@latest -g
• npm权限：当你要安装一个npm包到全局时，如果发现提示没有权限写入到指定路径，那么解决方法就是修改npm全局包安装目录即可：npm config set prefix ‘newpath’。具体请参见fixing-npm-permissions
• 安装npm包到本地: npm install package_name
• 使用package.json: http://blog.csdn.net/zmrdlb/article/details/53190696

• 更新本地package: npm update。可以先运行npm outdated来看哪些包已经不是最新的。

  有时候你会发现，明明用npm outdated查看已经不是最新的包，用npm update还是更新不到。这个是因为package.json里面包的版本号标识，默认后是(如)：^1.2.3，标明版本号version>=1.2.3 <2.0.0；那么如果要更新的包的最新版本是2.1.1，不属于版本范围，自然是更新不到了。解决办法是：将package.json里面包的版本号设置为”(>=0.0.0)，然后执行npm update，则会更新到最新版本

• 卸载本地package:

  npm uninstall package
  同时从dependencies配置中删除：npm uninstall –save package
  同时从devDependencies配置中删除：npm uninstall –save-dev package

• 安装package到全局: npm install -g package

• 更新全局package: npm update -g package
• 卸载全局package: npm uninstall -g package

• 创建node模块:

  1. 在一个目录里执行npm init， 创建package.json。默认main指向index.js
  2. 创建index.js，写入代码
  3. 发布包到npm
  4. 在其他地方npm install 刚刚发布的包，然后require测试

• 发布npm包

  1. 如果在npm registry还没有一个用户，则运行npm adduser 创建npm registry user
  2. npm login来登录
  3. npm publish 发布包
     

  注意：默认每个文件都会被包含发布，除非用.gitignore或.npmignore里面配置相关文件来忽略
  如果提示403错误等，先修改当前所在文件夹名和package.json里面的name配置，这两个命名是一样的，比如：zmrdlb-npm-module-test（复杂点）；要么就是version得修改了。
  发布成功后，则在https://www.npmjs.com/~看到你刚刚发布的包了

• Working with scoped packages: 暂时翻译为-使用作用域包。scopes: 就像npm包的命名空间。如果一个包名以@开头，那么它就是一个scoped package。官方参考文章CLI documentation

  @scope/project-name
  @username/project-name

  1. 初始化一个scooped package

     package.json中的配置会如下：
     {
     “name”: “@username/project-name”
     }
     如果使用npm init，则可以在cli中指定scope
     npm init –scope=username
     也可以设置npm全局配置： npm config set scope username

  2. 发布scoped package

     scoped package默认是私有的。为了发布私有模块，你需要成为一个付费的私有模块用户
     然而，public scoped modules是免费的并不需要付费。为了发布一个public scoped module, 设置access配置并且发布：npm publish –access=public

  3. 使用一个scoped package: npm install @username/project-name –save

     {
     “dependencies”: {
     “@username/project-name”: “^1.0.0”
     }
     }
     var projectName = require(“@username/project-name”)

  4. 使用scoped private modules: https://www.npmjs.com/private-modules

• 使用dist-tags: tags是semver(就是npm包的版本号规范语法)的一个补充，组织标记包的不同版本

  1. add tags: npm dist-tag add <pkg>@<version> [<tag>]
  2. 更多语法介绍：https://docs.npmjs.com/cli/dist-tag

  3. publishing with tags: 默认，npm publish 会标记你的包使用latest标签。如果使用–tag, 你能指定使用其他标签。如：

     npm publish –tag beta
     表明这是一个测试版

  4. 安装使用tag标记：npm install <pkg>默认安装latest标签标记的包。

     npm install <pkg>@<tag> 安装指定tag的包