npm基础使用、模块发布

基本信息

npm 是基于nodeJS的，
官网下载安装即可http://nodejs.cn/download/

// 通过查看版本号，来确认是否安装成功
node -v
npm -v
// 安装最新稳定版
npm install npm@latest -g
// 安装beta版
npm install npm@next -g

模块管理

• npm install <package_name>正常安装模块依赖到当前项目中。

• npm install <package_name> -g 全局安装模块，作为一个命令行工具，比如npm是一个全局模块。

• npm update更新依赖的模块，参数-g更新全局的模块。

• npm uninstall <package_name>卸载模块，配置还在；--save参数从dependencies删除；--save-dev参数从devDependencies删除。参数-g删除全局的模块。

模块配置文件

package.json

• npm init 创建文件，手动输入配置选项，nameetc.

• npm init --yes创建文件，所有属性为默认值。
  通过设置默认值,创建默认配置文件：name/version/author/lincense

    npm set init.author.name "test"
    npm set init.license "MIT"
  

• dependencies生产环境的依赖库。

• devDependencies用于测试环境和开发环境中需要的模块库。

• npm install <package_name> --save 安装生产环境的依赖。

• npm install <package_name> --save-dev安装开发、测试环境的依赖。

发布自定义模块

初始化项目

1. npm init --yes初始配置文件package.json
   

2. 创建入口文件index.js，配置文件中默认入口文件index.js；也可命名修改。

    exports.printLog = function(){
    	console.log("this is test");
    }
   

3. 增加文件.gitignore忽略不需要提交的文件、目录。

    home.js
   

4. 测试文件home.js模块的测试文件;对比步骤3发布后的模块没有包含home.js文件

    const Log = require("./index");
   
    // test the module pringLog
    Log.printLog();
   

5. npm publish发布模块

6. 查询发布的模块https://www.npmjs.com/package/<package_name>
   

7. 新建一个项目，安装发布的模块npm install <package_name>进行测试
   编辑index.js

    const Log = require("bo_npmdemo");
   
    Log.printLog();
   

   启动node index.js
   查看项目目录，确认安装了刚发布的模块。没有包含
   

遇到错误，按照提示信息分析排查：

1. 先确认登录账号正常；

2. 确认你的模块命是否被占用，重新起一个名字发布。
   

3. 由于npm源 导致的发布失败 401
   

    // 设置为npm 源
    npm config set registry "https://registry.npmjs.org/"
   

项目更新

• 单纯的更新模块版本
  npm version 1.1.0更新文件package.json

• npm publish完成更新

• 每次的文件更新都需要调整版本号，包括readme.md文件，需要执行npm version <patch>,在执行npm publish

  ---

  版本说明：

  版本	说明
  1.0.0第三位	bug修复，小改动
  1.1.0第二位	新增特性、模块
  2.0.0第一位	大版本，模块重构；核心理念变动