document/TranslateProject
2
0
Fork 0
mirror of https://github.com/LCTT/TranslateProject.git synced 2025-02-03 23:40:14 +08:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #8713 from wxy/20180126-How-To-Manage-NodeJS-Packages-Using-Npm

Browse Source 
PRF&PUB:20180126 How To Manage NodeJS Packages Using Npm
This commit is contained in:
Xingyu.Wang 2018-05-07 10:19:22 +08:00 committed by GitHub
commit f88c05762c
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 81 additions and 48 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

129
translated/tech/20180126 How To Manage NodeJS Packages Using Npm.md → published/20180126 How To Manage NodeJS Packages Using Npm.md
View File

@ -1,29 +1,32 @@
如何使用 Npm 管理 NodeJS 包
如何使用 npm 管理 NodeJS 包
=====
![](https://www.ostechnix.com/wp-content/uploads/2018/01/npm-720x340.png)
前一段时间，我们发布了一个[**使用 PIP 管理 Python 包**][3]的指南。今天，我们将讨论如何使用 Npm 管理 NodeJS 包。NPM 是最大的软件注册中心，包含 600,000 多个包。每天，世界各地的开发人员通过 npm 共享和下载软件包。在本指南中，我将解释使用 npm 基础知识，例如安装包（本地和全局）、安装特定版本的包、更新、删除和管理 NodeJS 包等等。
前一段时间，我们发布了一个[使用 pip 管理 Python 包][3]的指南。今天，我们将讨论如何使用 npm 管理 NodeJS 包。npm 是最大的软件注册中心，包含 600,000 多个包。每天，世界各地的开发人员通过 npm 共享和下载软件包。在本指南中，我将解释使用 npm 基础知识，例如安装包（本地和全局）、安装特定版本的包、更新、删除和管理 NodeJS 包等等。
### 使用 Npm 管理 NodeJS 包
##### 安装 NPM
### 安装 npm
用于 npm 是用 NodeJS 编写的，我们需要安装 NodeJS 才能使用 npm。要在不同的 Linux 发行版上安装 NodeJS，请参考下面的链接。
- [在 Linux 上安装 NodeJS](https://www.ostechnix.com/install-node-js-linux/)
检查 node 安装的位置：
```
$ which node
/home/sk/.nvm/versions/node/v9.4.0/bin/node
```
检查它的版本：
```
$ node -v
v9.4.0
```
进入 Node 交互式解释器：
```
$ node
> .help
@ -38,43 +41,46 @@ $ node
```
检查 npm 安装的位置：
```
$ which npm
/home/sk/.nvm/versions/node/v9.4.0/bin/npm
```
还有版本：
```
$ npm -v
5.6.0
```
棒极了！Node 和 NPM 已安装并能工作！正如你可能已经注意到，我已经在我的 $HOME 目录中安装了 NodeJS 和 NPM，这样是为了避免在全局模块时出现权限问题。这是 NodeJS 团队推荐的方法。
棒极了！Node 和 npm 已安装好！正如你可能已经注意到，我已经在我的 `$HOME` 目录中安装了 NodeJS 和 NPM，这样是为了避免在全局模块时出现权限问题。这是 NodeJS 团队推荐的方法。
那么，让我们继续看看如何使用 npm 管理 NodeJS 模块（或包）。
##### 安装 NodeJS 模块
### 安装 NodeJS 模块
NodeJS 模块可以安装在本地或全局（系统范围）。现在我将演示如何在本地安装包。
NodeJS 模块可以安装在本地或全局（系统范围）。现在我将演示如何在本地安装包（LCTT 译注：即将包安装到一个 NodeJS 项目当中，所以下面会先创建一个空项目做演示）。
**在本地安装包**
#### 在本地安装包
为了在本地管理包，我们通常使用 **package.json** 文件来管理。
为了在本地管理包，我们通常使用 `package.json` 文件来管理。
首先，让我们创建我们的项目目录。
```
$ mkdir demo
```
```
$ cd demo
```
在项目目录中创建一个 package.json 文件。为此，运行：
在项目目录中创建一个 `package.json` 文件。为此，运行：
```
$ npm init
```
输入你的包的详细信息，例如名称，版本，作者，github 页面等等，或者按下 ENTER 键接受默认值并键入 **YES** 确认。
输入你的包的详细信息，例如名称、版本、作者、GitHub 页面等等，或者按下回车键接受默认值并键入 `yes` 确认。
```
This utility will walk you through creating a package.json file.
It only covers the most common items, and tries to guess sensible defaults.
@ -112,19 +118,22 @@ About to write to /home/sk/demo/package.json:
Is this ok? (yes) yes
```
上面的命令初始化你的项目并创建了 package.json 文件。
上面的命令初始化你的项目并创建了 `package.json` 文件。
你也可以使用命令以非交互式方式执行此操作：
```
npm init --y
```
现在让我们安装名为 [**commander**][2] 的包。
现在让我们安装名为 [commander][2] 的包。
```
$ npm install commander
```
示例输出：
```
npm notice created a lockfile as package-lock.json. You should commit this file.
npm WARN demo@1.0.0 No repository field.
@ -133,11 +142,12 @@ npm WARN demo@1.0.0 No repository field.
added 1 package in 2.519s
```
这将在项目的根目录中创建一个名为 **" node_modules"** 的目录（如果它不存在的话），并在其中下载包。
这将在项目的根目录中创建一个名为 `node_modules` 的目录（如果它不存在的话），并在其中下载包。
让我们检查 `pachage.json` 文件。
让我们检查 pachage.json 文件。
```
$ cat package.json
$ cat package.json
{
"name": "demo",
"version": "1.0.0",
@ -148,30 +158,33 @@ $ cat package.json
},
"author": "",
"license": "ISC",
**"dependencies": {**
**"commander": "^2.13.0"**
"dependencies": {
"commander": "^2.13.0"
}
}
```
你会看到添加了依赖文件，版本号前面的插入符号 ( **^** ) 表示在安装时，npm 将取出它可以找到的最高版本的包。
你会看到添加了依赖文件，版本号前面的插入符号 ( `^` ) 表示在安装时，npm 将取出它可以找到的最高版本的包。
```
$ ls node_modules/
commander
```
package.json 文件的优点是，如果你的项目目录中有 package.json 文件，只需键入 "npm install"，那么 npm 将查看文件中列出的依赖关系并下载它们。你甚至可以与其他开发人员共享它或将其推送到你的 GitHub 仓库。因此，当他们键入 “npm install” 时，他们将获得你拥有的所有相同的包。
`package.json` 文件的优点是，如果你的项目目录中有 `package.json` 文件，只需键入 `npm install`，那么 `npm` 将查看文件中列出的依赖关系并下载它们。你甚至可以与其他开发人员共享它或将其推送到你的 GitHub 仓库。因此，当他们键入 `npm install` 时，他们将获得你拥有的所有相同的包。
你也可能会注意到另一个名为 **package-lock.json** 的文件，该文件确保在项目安装的所有系统上都保持相同的依赖关系。
你也可能会注意到另一个名为 `package-lock.json` 的文件，该文件确保在项目安装的所有系统上都保持相同的依赖关系。
要在你的程序中使用已安装的包，使用实际代码在项目目录中创建一个 `index.js`（或者其他任何名称）文件，然后使用以下命令运行它：
要在你的程序中使用已安装的包，使用实际代码在项目目录中创建一个 **index.js**（或者其他任何名称）文件，然后使用以下命令运行它：
```
$ node index.js
```
**在全局安装包**
#### 在全局安装包
如果你想使用一个包作为命令行工具，那么最好在全局安装它。这样，无论你的当前目录是哪个目录，它都能正常工作。
```
$ npm install async -g
+ async@2.6.0
@ -179,23 +192,27 @@ added 2 packages in 4.695s
```
或者
```
$ npm install async --global
```
要安装特定版本的包，我们可以：
```
$ npm install async@2.6.0 --global
```
##### 更新 NodeJS 模块
### 更新 NodeJS 模块
要更新本地包，转到 `package.json` 所在的项目目录并运行：
要更新本地包，转到 package.json 所在的项目目录并运行：
```
$ npm update
```
然后，运行以下命令确保所有包都更新了。
```
$ npm outdated
```
@ -203,6 +220,7 @@ $ npm outdated
如果没有需要更新的，那么它返回空。
要找出哪一个全局包需要更新，运行：
```
$ npm outdated -g --depth=0
```
@ -210,32 +228,37 @@ $ npm outdated -g --depth=0
如果没有输出，意味着所有包都已更新。
更新单个全局包，运行：
```
$ npm update -g <package-name>
```
更新所有的全局包，运行：
```
$ npm update -g <package>
$ npm update -g
```
##### 列出 NodeJS 模块
### 列出 NodeJS 模块
列出本地包，转到项目目录并运行：
```
$ npm list
demo@1.0.0 /home/sk/demo
└── commander@2.13.0
```
如你所见，我在本地安装了 "commander" 这个包。
如你所见，我在本地安装了 `commander` 这个包。
要列出全局包，从任何位置都可以运行以下命令：
```
$ npm list -g
```
示例输出：
```
/home/sk/.nvm/versions/node/v9.4.0/lib
├─┬ async@2.6.0
@ -252,7 +275,8 @@ $ npm list -g
该命令将列出所有模块及其依赖关系。
要仅仅列出顶级模块，使用 -depth=0 选项：
要仅仅列出顶级模块，使用 `-depth=0` 选项：
```
$ npm list -g --depth=0
/home/sk/.nvm/versions/node/v9.4.0/lib
@ -260,43 +284,48 @@ $ npm list -g --depth=0
└── npm@5.6.0
```
##### 寻找 NodeJS 模块
#### 寻找 NodeJS 模块
要搜索一个模块，使用 `npm search` 命令：
要搜索一个模块，使用 "npm search" 命令：
```
npm search <search-string>
```
例如：
```
$ npm search request
```
该命令将显示包含搜索字符串 "request" 的所有模块。
该命令将显示包含搜索字符串 `request` 的所有模块。
##### 移除 NodeJS 模块
要删除本地包，转到项目目录并运行以下命令，这会从 **node_modules** 目录中删除包：
要删除本地包，转到项目目录并运行以下命令，这会从 `node_modules` 目录中删除包：
```
$ npm uninstall <package-name>
```
要从 **package.json** 文件中的依赖关系中删除它，使用如下所示的 **save** 标志：
要从 `package.json` 文件中的依赖关系中删除它，使用如下所示的 `save` 选项：
```
$ npm uninstall --save <package-name>
```
要删除已安装的全局包，运行：
```
$ npm uninstall -g <package>
```
##### 清楚 NPM 缓存
### 清除 npm 缓存
默认情况下，NPM 在安装包时，会将其副本保存在 $HOME 目录中名为 npm 的缓存文件夹中。所以，你可以在下次安装时不必再次下载。
默认情况下，npm 在安装包时，会将其副本保存在 `$HOME` 目录中名为 `.npm` 的缓存文件夹中。所以，你可以在下次安装时不必再次下载。
查看缓存模块：
```
$ ls ~/.npm
```
@ -304,28 +333,33 @@ $ ls ~/.npm
随着时间的推移，缓存文件夹会充斥着大量旧的包。所以不时清理缓存会好一些。
从 npm@5 开始，npm 缓存可以从 corruption 问题中自行修复，并且保证从缓存中提取的数据有效。如果你想确保一切都一致，运行：
```
$ npm cache verify
```
清楚整个缓存，运行：
清除整个缓存，运行：
```
$ npm cache clean --force
```
##### 查看 NPM 配置
### 查看 npm 配置
要查看 npm 配置，键入：
要查看 NPM 配置，键入：
```
$ npm config list
```
或者
或者：
```
$ npm config ls
```
示例输出：
```
; cli configs
metrics-registry = "https://registry.npmjs.org/"
@ -339,26 +373,25 @@ user-agent = "npm/5.6.0 node/v9.4.0 linux x64"
```
要显示当前的全局位置：
```
$ npm config get prefix
/home/sk/.nvm/versions/node/v9.4.0
```
好吧，这就是全部了。我们刚才介绍的只是基础知识，NPM 是一个广泛话题。有关更多详细信息，参阅 [**NPM Getting Started**][3] 指南。
好吧，这就是全部了。我们刚才介绍的只是基础知识，npm 是一个广泛话题。有关更多详细信息，参阅 [**NPM Getting Started**][3] 指南。
希望这对你有帮助。更多好东西即将来临，敬请关注！
干杯！
--------------------------------------------------------------------------------
via: https://www.ostechnix.com/manage-nodejs-packages-using-npm/
作者：[SK][a]
译者：[MjSeven](https://github.com/MjSeven)
校对：[校对者ID](https://github.com/校对者ID)
校对：[wxy](https://github.com/wxy)
本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译，[Linux中国](https://linux.cn/) 荣誉推出