# Node.js (简体中文)

翻译状态： 本文是英文页面 Node.js 的翻译，最后翻译时间：2016-06-29，点击这里可以查看翻译后英文页面的改动。

Related articles

- Electron

Node.js 是一个 javascript 运行环境，并附带有功能丰富的库.使用 Google's V8 引擎 在浏览器外执行代码. 由于其是事件驱动、非阻塞 I/O 模型，它适合于实时 web 应用.

## 安装

nodejs 包位于 官方软件仓库 .

如果需要使用多个 nodejs 版本，可以使用 NVM (Node Version Manger). NVM 可以很方便的安装多个版本，并在版本间快速切换。github 上有使用文档，命令很简单：

      $ nvm install VERSION_NUM

## Node Packaged Modules

npm 是官方的 node.js 包管理器，通过软件包 npm 进行安装。

### 使用 npm 管理包

#### 安装软件包

任何包可以用以下命令安装：

    $ npm install packageName

这个命令会将包安装在当前目录下 `node_modules` 目录内，可执行命令（如果有）安装在 `node_modules/.bin` 目录下.

作为系统级的全局安装使用 `-g` 选项:

    # npm -g install packageName

默认情形下这个命令会将包安装至 `/usr/lib/node_modules/npm` ，需要管理员权限.

作为个人用户级的安装您可以使用一个本地目录来配置 `npm` 。这可以通过多种方式完成：

- 在命令中添加 `--prefix` 标记 (e.g. `npm -g install packageName --prefix ~/.node_modules` )。
- 使用 `npm_config_prefix` 环境变量。
- 使用用户配置文件 `~/.npmrc` 。

第一个方法已不被推荐因为您需要记住位置并且每次操作都需要添加参数。

第二个方法只是添加下列行到您的 shell 配置文件 (e.g. `.bash_profile`)。

    PATH="$HOME/.node_modules/bin:$PATH"
    export npm_config_prefix=~/.node_modules

不要忘记重新登录或重启您的 shell。

第三个方法您可以使用命令：

    $ npm config edit

您可以找到 `prefix` 选项并且设置一个期望的位置：

    prefix=~/.node_modules

不要忘记删除行前面的 `;` 否则会被当作注释。

您现在可以添加可执行命令的位置到您的 shell 配置文件 (e.g. `.bash_profile` )。

    export PATH="$HOME/.node_modules/bin:$PATH"

再次提示不要忘记重新登录或重启您的 shell。

#### 更新包

更新包只需要执行

     $ npm update packageName

对于全局环境安装的包 ( `-g` )

     # npm update -g packageName

Note: 请记住全局安装的包需要管理员权限

##### 更新所有包

有时您只希望更新所有包，去掉包名将试图更新所有包。

     $ npm update

或者添加 `-g` 标记更新全局环境安装的包

     # npm update -g

#### 删除包

删除使用 `-g` 标记安装的包只须：

    # npm -g uninstall packageName

Note: 请记住全局安装的包需要管理员权限

若删除个人用户目录下的包去掉标记执行：

     $ npm uninstall packageName

#### 列出所有包

若要显示已安装的包的树形视图执行：

    $ npm -g list

### 使用 pacman 管理包

一些 node.js 包可以在 Arch User Repository 找到，命名为 `nodejs-packageName` 格式。

## 问题处理

### node-gyp python 错误

有些使用 `node-gyp` 的工具不支持系统上的 Python 3，要解决这个问题，需要安装 python2并在 nvm 中设置:

    $ npm config set python /usr/bin/python2

如果出现 gyp WARN EACCES user "root" does not have permission to access the ... dir，可以使用 --unsafe-perm 选项:

    $ sudo npm install --unsafe-perm -g node-inspector

## 其他资源

更多关于 nodejs 和官方包管理器 npm 的使用信息您也许需要查询下列额外资源。

- NodeJs Documentation Node 文档和教程。
- NodeJS Community
- API Documentation 官方 `npm` API 文档
- IRC channel #node.js on irc.freenode.net

中文社区

- v2ex NodeJS 节点 开发者作品发布与开发探讨
- cnodejs.org Node.js 专业中文社区

Category:

- Development (简体中文)