Henry
Henry
2017-08-03
目录

node 和 npm 简介

node 和 npm 简介

# node

# Windows 安装 node

  • 在 Node.js 官网 (opens new window)下载 node . 一般我们选择 LTS 版本的，因为这个相对稳定一些
  • 先在电脑创建 D:\nodejs 目录，并将 Node 安装在这个目录中，前辈说装在 C 盘会有权限的问题。该引导步骤会将 node.exe 文件安装到你指定目录下，并将该目录添加进 PATH 环境变量
  • 安装好之后，在 cmd 控制台输入：node -v , 控制台打印出版本表示安装成功。
  • 由于新版的 nodejs 已经集成了 npm , 所以 npm 也一并安装好了。同样可以使用 cmd 命令行输入：npm -v 来测试是否成功安装。出现版本提示表示安装成功。

# Mac 使用 Homebrew 安装 node

# 列出所有全局模块

通过  npm list -g(简写：npm ls -g)  可以列出所有已经安装的全局模块

F:\>npm list -g
D:\nodejs\node_global
+-- express@4.15.3
| +-- accepts@1.3.3
| | +-- mime-types@2.1.16
| | | `-- mime-db@1.29.0
| | `-- negotiator@0.6.1
| +-- array-flatten@1.1.1
| +-- content-disposition@0.5.2
| +-- content-type@1.0.2
  ........................
`-- less@2.7.2
  +-- errno@0.1.4
  | `-- prr@0.0.0
  +-- graceful-fs@4.1.11
  +-- image-size@0.5.5
  +-- mime@1.3.6
  +-- mkdirp@0.5.1
  | `-- minimist@0.0.8
  +-- promise@7.3.1
  ........................
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

但是，得到的输出信息会很冗长，我们可以加上  --depth=0  来精简一下输出

F:\>npm list -g --depth=0
D:\nodejs\node_global
+-- express@4.15.3
`-- less@2.7.2
1
2
3
4

现在输出信息就清楚了，我们只列出了我们安装的模块和版本号

# 基于 node 工程

# 包 (项目，工程)

# 概念

  1. 在 Node.js 语言中，包和模块并没有本质的不同，包是在模块的基础上更深一步的抽象。
  2. 包将某个独立的功能封装起来，用于发布、更新、依赖管理和进行版本控制。
  3. Node.js 根据 CommonJS 规范实现了包机制，开发了 npm 来解决包的发布和获取需求。

# 包的说明文件 (package.json)

使用 package.json 能干什么

  1. 相当于你本地项目的一个文档说明。
  2. 允许你指定你项目中所使用的 node 包的版本。
  3. 构建你的项目更加容易，便于给其他人共享。

package.json 属性详解

  • 本质：json 对象

    {
  "name": "npm_command", // 包名，全部小写，没有空格，可以使用下划线或者横线
  "version": "1.0.0", // 版本，x.x.x 的格式，符合“语义化版本规则”
  "scripts": {
    // 配置 npm 运行命令
    "start": "node bin/www"
  },
  "dependencies": {
    // 运行依赖的包
    "jquery": "^3.2.1"
  },
  "devDependencies": {
    // 开发依赖的包
    "babel": "^6.23.0"
  }
}
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16

  • 其他内容：

    description：描述信息，有助于搜索
main: 入口文件，一般都是 index.js
scripts：支持的脚本，默认是一个空的 test
keywords：关键字，有助于在人们使用 npm search 搜索时发现你的项目
author：作者信息
license：默认是 MIT
bugs：当前项目的一些错误信息，如果有的话
    1
    2
    3
    4
    5
    6
    7

  • 我们可以为 init 命令设置一些默认值，比如：

    npm set init.author.email "henrytsz@qq.com"
npm set init.author.name "henrytsz"
npm set init.license "MIT"
    1
    2
    3

  • Semantic versioning(语义化版本规则) (opens new window):

dependencies 的内容，以 "weex-HTML5": "^0.3.2" 为例，我们知道 key 是依赖的包名称，value 是这个包的版本。那版本前面的 ^ 或者版本直接是一个 * 是什么意思呢？

这就是 npm 的 Semantic versioning , 简称 Semver , 中文含义即"语义化版本规则". 如果一个项目打算与别人分享，应该从 1.0.0 版本开始。以后要升级版本应该遵循以下标准：

  • 补丁版本：解决了 Bug 或者一些较小的更改，增加最后一位数字，比如 1.0.1
  • 小版本：增加了新特性，同时不会影响之前的版本，增加中间一位数字，比如 1.1.0
  • 大版本：大改版，无法兼容之前的，增加第一位数字，比如 2.0.0

  • 作为使用者，我们可以在 package.json 文件中写明我们可以接受这个包的更新程度 (假设当前依赖的是 1.0.4 版本):

    • 如果只打算接受补丁版本的更新 (也就是最后一位的改变), 就可以这么写：

      • 1.0
      • 1.0.x
      • ~1.0.4
      • 波浪线可以管理三级版本

    • 如果接受小版本的更新 (第二位的改变), 就可以这么写：

      • 1
      • 1.x
      • ^1.0.4
      • 向上的尖括号可以管理二级，三级版本

    • 如果可以接受大版本的更新 (自然接受小版本和补丁版本的改变), 就可以这么写：

      • *
      • x

  • npm(包管理工具) - 详述：

    1. Node 包管理器 ( npm ) 是一个由 Node.js 官方提供的第三方包管理工具，
    2. npm 是一个完全由 JavaScript 实现的命令行工具，通过 Node.js 执行，因此严格来讲它不属于 Node.js 的一部分。
    3. 在最初的版本中，我们需要在安装完 Node.js 以后手动安装 npm . 但从 Node.js 0.6 开始，npm 已包含在发行包中了，安装 Node.js 时会自动安装 npm . 现在的版本大都使用 6.0 以上

具体详情可查看：package.json 知多少？ (opens new window), NPM 如何管理依赖包版本 (opens new window), npm install 原理分析 (opens new window)

# npm 获取配置有 6 种方式，优先级由高到底。

  1. 命令行参数.  --proxy http://server:port 即将 proxy 的值设为 http://server:port .

  2. 环境变量。以 npm_config_ 为前缀的环境变量将会被认为是 npm 的配置属性。如设置 proxy 可以加入这样的环境变量 npm_config_proxy=http://server:port .

  3. 用户配置文件。可以通过 npm config get userconfig 查看文件路径。如果是 mac 系统的话默认路径就是 $HOME/.npmrc .

  4. 全局配置文件。可以通过 npm config get globalconfig 查看文件路径.mac 系统的默认路径是 /usr/local/etc/npmrc .

  5. 内置配置文件。安装 npm 的目录下的 npmrc 文件。

  6. 默认配置。npm 本身有默认配置参数，如果以上 5 条都没设置，则 npm 会使用默认配置参数。

# 针对 npm 配置的命令行操作

npm config set <key> <value> [--global]
npm config get <key>
npm config delete <key>
npm config list
npm config edit
npm get <key>
npm set <key> <value> [--global]
1
2
3
4
5
6
7

在设置配置属性时属性值默认是被存储于用户配置文件中，如果加上 --global , 则被存储在全局配置文件中。

如果要查看 npm 的所有配置属性 (包括默认配置), 可以使用 npm config ls -l .

如果要查看 npm 的各种配置的含义，可以使用 npm help config .

# npm 命令详解

  • 常用命令：

    • npm init : 生成 package.json
    • npm init --yes (简写：npm init -y ): 跳过回答问题步骤，直接生成默认值的 package.json 文件。使用此方法时，文件夹名字必须符合 package.json 的 name 命名规范
    • npm view packageName versions: 查看 npm 服务器上所有的 packageName 版本信息
    • npm view packageName version: 查看 npm 服务器上最新的 packageName 版本信息
    • npm info packageName : 显示包的信息
    • npm install (简写：npm i ): 用来安装 package.json 里的相关依赖包 ( dependencies 和 devDependencies 里的所有模块)
    • npm install --production : 只安装 dependencies 中的内容
    • npm install packageName --global (简写：npm i -g packageName ): 全局安装
    • npm install packageName --save (简写：npm i -S packageName ): 局部安装运行依赖
    • npm install packageName@version --save : 安装指定版本的包 (局部安装)
    • npm install packageName --save-dev (简写：npm i -D packageName ): 局部安装开发依赖
    • npm list -g (简写：npm ls -g): 列出全局安装的模块的详细信息
    • npm list -g --depth=0 (简写：npm ls -g --depth=0): 列出全局安装的模块简略信息
    • npm list packageName (简写：npm ls packageName): 查看本地安装的 packageName 版本信息
    • npm rm packageName --save : 移除包并删除依赖
    • npm config set prefix "E:\nodejs\node_global" : 设置全局模块安装地址
    • npm config get prefix : 获取全局安装包的所在地址，并且可见对应的 cmd 命令
    • npm config set registry http://registry.npmmirror.com : 设置 npm 库
    • npm config get registry : 查看 npm 库地址
    • npm config set proxy http://example@proxymsn.com : 设置代理地址
    • npm config get proxy : 查看代理地址
    • npm outdated : 检查依赖的包是否有新版本
    • npm update packageName : 更新指定依赖的包 (如更新失败，需要检查 package.json 中语义化版本规则，能否从当前版本升级到最新版本)
    • npm update : 更新所有有新版本的包

  • 阮一峰-npm 模块管理器 (opens new window)

  • 使用 npm 导致的问题

    • 下载慢，甚至下载不了

# 淘宝镜像

原淘宝 npm 域名即将停止解析，官方链接 (opens new window)，以下命令已更新，放心食用。

# 方法一：

使用阿里定制的 cnpm 命令行工具代替默认的 npm，输入以下代码

npm install -g cnpm --registry=http://registry.npmmirror.com
1

检查是否安装成功：

cnpm -v
1

安装成功之后，以后安装依赖包的方式和 npm 的是一样的，只是 npm 的命令换成是 cnpm 就可以了。

# 方法二：

a:单次使用：

npm install --registry=http://registry.npmmirror.com
1

b:永久替换：

在开发 react-native 的时候，不要使用 cnpm，cnpm 安装的模块路径比较奇怪，packager 不能正常识别。

所以，为了方便开发，我们最好是直接永久使用淘宝的镜像源

直接命令行的设置

npm config set registry http://registry.npmmirror.com
1

手动修改设置

1.打开.npmrc 文件（C:\Program Files\nodejs\node_modules\npm\npmrc，没有的话可以使用 git 命令行建一个 ( touch .npmrc)，用 cmd 命令建会报错）
2.增加 registry =http://registry.npmmirror.com  即可。
1
2

如果需要恢复成原来的官方地址只需要执行如下命令：

npm config set registry https://registry.npmjs.org
1

检测是否安装成功：

npm config get registry
1

# yarn Facebook 开发的包管理工具

  • yarn (包管理工具)

    • yarn 是 Facebook 开源的新的包管理器，可以用来代替 npm
    • 配置：npm install yarn -g
    • 特点：有缓存，没有自己的仓库地址
    • 常用命令
      yarn --version
yarn
yarn init
yarn global package (全局安装)
yarn add package (局部安装)
yarn add package --dev
yarn remove package
yarn list
      1
      2
      3
      4
      5
      6
      7
      8
  • 地址：https://yarnpkg.com/zh-Hans/

  • cyarn

    • 使用淘宝镜像，更快

    • 配置：npm install cyarn -g --registry "http://registry.npmmirror.com"

    • 常用命令：将 yarn 使用 cyarn 代替即可

# 参考资料

编辑 (opens new window)
#node#npm
上次更新: 5/14/2024, 6:30:23 AM
node 和 npm 常见问题
手搓一个 TinyPng 压缩图片的脚手架

← 手搓一个 TinyPng 压缩图片的脚手架→

最近更新
01
搭配 Jenkins 实现自动化打包微前端多个项目
09-15
02
自动化打包微前端多个项目
09-15
03
el-upload 直传阿里 oss 并且显示自带进度条和视频回显封面图
06-05
更多文章>
Theme by Vdoing | Copyright © 2017-2024 HenryTSZ | MIT License