Node.js 教程

簡單的說 Node.js 就是運行在服務端的 JavaScript。

Node.js 是一個基於Chrome JavaScript 運行時建立的一個平臺。

Node.js是一個事件驅動I/O服務端JavaScript環境，基於Google的V8引擎，V8引擎執行Javascript的速度非常快，性能非常好。

誰適合閱讀本教程？

如果你是一個前端程序員，你不懂得像PHP、Python或Ruby等動態編程語言，然後你想創建自己的服務，那麼Node.js是一個非常好的選擇。

Node.js 是運行在服務端的 JavaScript，如果你熟悉Javascript，那麼你將會很容易的學會Node.js。

當然，如果你是後端程序員，想部署一些高性能的服務，那麼學習Node.js也是一個非常好的選擇。

學習本教程前你需要了解

在繼續本教程之前，你應該瞭解一些基本的計算機編程術語。如果你學習過Javascript,PHP，Java等編程語言，將有助於你更快的瞭解Node.js編程。

使用的版本

我們可以使用以下命令來查看當前的 Node 版本：

$ node -vv4.4.3

注意：不同版本間可能是有差異的。

第一個Node.js程序：Hello World！

腳本模式

以下是我們的第一個Node.js程序：

實例

console.log("Hello World");

運行實例 »

保存該文件，文件名為 helloworld.js， 並通過 node命令來執行：

node helloworld.js

程序執行後，正常的話，就會在終端輸出 Hello World。

交互模式

打開終端，鍵入node進入命令交互模式，可以輸入一條代碼語句後立即執行並顯示結果，例如：

$ node> console.log('Hello World!');Hello World!

Gif 實例演示

接下來我們通過 Gif 圖為大家演示實例操作：

Node.js 安裝配置

本章節我們將向大家介紹在window和Linux上安裝Node.js的方法。

本安裝教程以Node.js v4.4.3 LTS(長期支持版本)版本為例。

Node.js安裝包及源碼下載地址為：https://nodejs.org/en/download/。

你可以根據不同平臺系統選擇你需要的Node.js安裝包。

Node.js 歷史版本下載地址：https://nodejs.org/dist/

注意：Linux上安裝Node.js需要安裝Python 2.6 或 2.7 ，不建議安裝Python 3.0以上版本。

Window 上安裝Node.js

你可以採用以下兩種方式來安裝。

1、Windows 安裝包(.msi)

32 位安裝包下載地址 : https://nodejs.org/dist/v4.4.3/node-v4.4.3-x86.msi

64 位安裝包下載地址 : https://nodejs.org/dist/v4.4.3/node-v4.4.3-x64.msi

本文實例以 v0.10.26 版本為例，其他版本類似， 安裝步驟：

步驟 1 : 雙擊下載後的安裝包 v0.10.26，如下所示：

步驟 2 : 點擊以上的Run(運行)，將出現如下界面：

步驟 3 : 勾選接受協議選項，點擊 next（下一步） 按鈕 :

步驟 4 : Node.js默認安裝目錄為 "C:\Program Files\nodejs" , 你可以修改目錄，並點擊 next（下一步）：

步驟 5 : 點擊樹形圖標來選擇你需要的安裝模式 , 然後點擊下一步 next（下一步）

步驟 6 :點擊 Install（安裝） 開始安裝Node.js。你也可以點擊 Back（返回）來修改先前的配置。 然後並點擊 next（下一步）：

安裝過程：

點擊 Finish（完成）按鈕退出安裝嚮導。

檢測PATH環境變量是否配置了Node.js，點擊開始=》運行=》輸入"cmd" => 輸入命令"path"，輸出如下結果：

PATH=C:\oraclexe\app\oracle\product\10.2.0\server\bin;C:\Windows\system32;C:\Windows;C:\Windows\System32\Wbem;C:\Windows\System32\WindowsPowerShell\v1.0\;c:\python32\python;C:\MinGW\bin;C:\Program Files\GTK2-Runtime\lib;C:\Program Files\MySQL\MySQL Server 5.5\bin;C:\Program Files\nodejs\;C:\Users\rg\AppData\Roaming\npm

我們可以看到環境變量中已經包含了C:\Program Files\nodejs\

檢查Node.js版本

2、Windows 二進制文件 (.exe)安裝

32 位安裝包下載地址 : http://nodejs.org/dist/v0.10.26/node.exe

64 位安裝包下載地址 : http://nodejs.org/dist/v0.10.26/x64/node.exe

安裝步驟

步驟 1 : 雙擊下載的安裝包 Node.exe ，將出現如下界面 :

點擊 Run（運行）按鈕將出現命令行窗口：

版本測試

進入 node.exe 所在的目錄，如下所示：

如果你獲得以上輸出結果，說明你已經成功安裝了Node.js。

Ubuntu 上安裝 Node.js

Node.js 源碼安裝

以下部分我們將介紹在Ubuntu Linux下安裝 Node.js 。 其他的Linux系統，如Centos等類似如下安裝步驟。

在 Github 上獲取 Node.js 源碼：

$ sudo git clone https://github.com/nodejs/node.gitCloning into 'node'...

修改目錄權限：

$ sudo chmod -R 755 node

使用 ./configure 創建編譯文件，並按照：

$ cd node$ sudo ./configure$ sudo make$ sudo make install

查看 node 版本：

$ node --versionv0.10.25

Ubuntu apt-get命令安裝

命令格式如下：

sudo apt-get install nodejssudo apt-get install npm

CentOS 下安裝 Node.js

1、下載源碼，你需要在https://nodejs.org/en/download/下載最新的Nodejs版本，本文以v0.10.24為例:

cd /usr/local/src/wget http://nodejs.org/dist/v0.10.24/node-v0.10.24.tar.gz

2、解壓源碼

tar zxvf node-v0.10.24.tar.gz

3、 編譯安裝

cd node-v0.10.24./configure --prefix=/usr/local/node/0.10.24makemake install

4、 配置NODE_HOME，進入profile編輯環境變量

vim /etc/profile

設置nodejs環境變量，在 export PATH USER LOGNAME MAIL HOSTNAME HISTSIZE HISTCONTROL 一行的上面添加如下內容:

#set for nodejsexport NODE_HOME=/usr/local/node/0.10.24export PATH=$NODE_HOME/bin:$PATH

:wq保存並退出，編譯/etc/profile 使配置生效

source /etc/profile

驗證是否安裝配置成功

node -v

輸出 v0.10.24 表示配置成功

npm模塊安裝路徑

/usr/local/node/0.10.24/lib/node_modules/

注：Nodejs 官網提供了編譯好的Linux二進制包，你也可以下載下來直接應用。

Node.js 創建第一個應用

如果我們使用PHP來編寫後端的代碼時，需要Apache 或者 Nginx 的HTTP 服務器，並配上 mod_php5 模塊和php-cgi。

從這個角度看，整個"接收 HTTP 請求並提供 Web 頁面"的需求根本不需 要 PHP 來處理。

不過對 Node.js 來說，概念完全不一樣了。使用 Node.js 時，我們不僅僅 在實現一個應用，同時還實現了整個 HTTP 服務器。事實上，我們的 Web 應用以及對應的 Web 服務器基本上是一樣的。

在我們創建 Node.js 第一個 "Hello, World!" 應用前，讓我們先了解下 Node.js 應用是由哪幾部分組成的：

1. 引入 required 模塊：我們可以使用 require 指令來載入 Node.js 模塊。

2. 創建服務器：服務器可以監聽客戶端的請求，類似於 Apache 、Nginx 等 HTTP 服務器。

3. 接收請求與響應請求 服務器很容易創建，客戶端可以使用瀏覽器或終端發送 HTTP 請求，服務器接收請求後返回響應數據。

創建 Node.js 應用

步驟一、引入 required 模塊

我們使用 require 指令來載入 http 模塊，並將實例化的 HTTP 賦值給變量 http，實例如下:

var http = require("http");

步驟二、創建服務器

接下來我們使用 http.createServer() 方法創建服務器，並使用 listen 方法綁定 8888 端口。 函數通過 request, response 參數來接收和響應數據。

實例如下，在你項目的根目錄下創建一個叫 server.js 的文件，並寫入以下代碼：

var http = require('http');http.createServer(function (request, response) {// 發送 HTTP 頭部// HTTP 狀態值: 200 : OK// 內容類型: text/plainresponse.writeHead(200, {'Content-Type': 'text/plain'});// 發送響應數據 "Hello World"response.end('Hello World\n');}).listen(8888);// 終端打印如下信息console.log('Server running at http://127.0.0.1:8888/');

以上代碼我們完成了一個可以工作的 HTTP 服務器。

使用 node 命令執行以上的代碼：

node server.jsServer running at http://127.0.0.1:8888/

接下來，打開瀏覽器訪問 http://127.0.0.1:8888/，你會看到一個寫著 "Hello World"的網頁。

分析Node.js 的 HTTP 服務器：

• 第一行請求（require）Node.js 自帶的 http 模塊，並且把它賦值給 http 變量。

• 接下來我們調用 http 模塊提供的函數： createServer 。這個函數會返回 一個對象，這個對象有一個叫做 listen 的方法，這個方法有一個數值參數， 指定這個 HTTP 服務器監聽的端口號。

Gif 實例演示

接下來我們通過 Gif 圖為大家演示實例操作：

NPM 使用介紹

NPM是隨同NodeJS一起安裝的包管理工具，能解決NodeJS代碼部署上的很多問題，常見的使用場景有以下幾種：

• 允許用戶從NPM服務器下載別人編寫的第三方包到本地使用。

• 允許用戶從NPM服務器下載並安裝別人編寫的命令行程序到本地使用。

• 允許用戶將自己編寫的包或命令行程序上傳到NPM服務器供別人使用。

由於新版的nodejs已經集成了npm，所以之前npm也一併安裝好了。同樣可以通過輸入 "npm -v" 來測試是否成功安裝。命令如下，出現版本提示表示安裝成功:

$ npm -v2.3.0

如果你安裝的是舊版本的 npm，可以很容易得通過 npm 命令來升級，命令如下：

$ sudo npm install npm -g/usr/local/bin/npm -> /usr/local/lib/node_modules/npm/bin/[email protected] /usr/local/lib/node_modules/npm

如果是 Window 系統使用以下命令即可：

npm install npm -g

使用淘寶鏡像的命令：

cnpm install npm -g

使用 npm 命令安裝模塊

npm 安裝 Node.js 模塊語法格式如下：

$ npm install <Module Name>

以下實例，我們使用 npm 命令安裝常用的 Node.js web框架模塊 express:

$ npm install express

安裝好之後，express 包就放在了工程目錄下的 node_modules 目錄中，因此在代碼中只需要通過 require('express') 的方式就好，無需指定第三方包路徑。

var express = require('express');

全局安裝與本地安裝

npm 的包安裝分為本地安裝（local）、全局安裝（global）兩種，從敲的命令行來看，差別只是有沒有-g而已，比如

npm install express # 本地安裝npm install express -g # 全局安裝

如果出現以下錯誤：

npm err! Error: connect ECONNREFUSED 127.0.0.1:8087

解決辦法為：

$ npm config set proxy null

本地安裝

• 1. 將安裝包放在 ./node_modules 下（運行 npm 命令時所在的目錄），如果沒有 node_modules 目錄，會在當前執行 npm 命令的目錄下生成 node_modules 目錄。

• 2. 可以通過 require() 來引入本地安裝的包。

全局安裝

• 1. 將安裝包放在 /usr/local 下或者你 node 的安裝目錄。

• 2. 可以直接在命令行裡使用。

如果你希望具備兩者功能，則需要在兩個地方安裝它或使用 npm link。

接下來我們使用全局方式安裝 express

$ npm install express -g

安裝過程輸出如下內容，第一行輸出了模塊的版本號及安裝位置。

[email protected] node_modules/express├── [email protected]├── [email protected]├── [email protected]├── [email protected]├── [email protected]├── [email protected]├── [email protected]├── [email protected]├── [email protected]├── [email protected]├── [email protected]├── [email protected]├── [email protected]├── [email protected]├── [email protected]├── [email protected]├── [email protected]├── [email protected]├── [email protected] ([email protected])├── [email protected] ([email protected])├── [email protected] ([email protected], [email protected])├── [email protected] ([email protected])├── [email protected] ([email protected], [email protected])├── [email protected] ([email protected], [email protected])└── [email protected] ([email protected], [email protected], [email protected], [email protected], [email protected])

查看安裝信息

你可以使用以下命令來查看所有全局安裝的模塊：

$ npm list -g├─┬ [email protected]│ ├── [email protected]│ ├── [email protected]│ ├── [email protected]│ ├─┬ [email protected]│ │ └── [email protected]│ ├─┬ [email protected]│ │ └── [email protected]……

如果要查看某個模塊的版本號，可以使用命令如下：

$ npm list gruntprojectName@projectVersion /path/to/project/folder└── [email protected]

使用 package.json

package.json 位於模塊的目錄下，用於定義包的屬性。接下來讓我們來看下 express 包的 package.json 文件，位於 node_modules/express/package.json 內容：

{ "name": "express", "description": "Fast, unopinionated, minimalist web framework", "version": "4.13.3", "author": { "name": "TJ Holowaychuk", "email": "[email protected]" }, "contributors": [ { "name": "Aaron Heckmann", "email": "[email protected]" }, { "name": "Ciaran Jessup", "email": "[email protected]" }, { "name": "Douglas Christopher Wilson", "email": "[email protected]" }, { "name": "Guillermo Rauch", "email": "[email protected]" }, { "name": "Jonathan Ong", "email": "[email protected]" }, { "name": "Roman Shtylman", "email": "[email protected]" }, { "name": "Young Jae Sim", "email": "[email protected]" } ], "license": "MIT", "repository": { "type": "git", "url": "git+https://github.com/strongloop/express.git" }, "homepage": "http://expressjs.com/", "keywords": [ "express", "framework", "sinatra", "web", "rest", "restful", "router", "app", "api" ], "dependencies": { "accepts": "~1.2.12", "array-flatten": "1.1.1", "content-disposition": "0.5.0", "content-type": "~1.0.1", "cookie": "0.1.3", "cookie-signature": "1.0.6", "debug": "~2.2.0", "depd": "~1.0.1", "escape-html": "1.0.2", "etag": "~1.7.0", "finalhandler": "0.4.0", "fresh": "0.3.0", "merge-descriptors": "1.0.0", "methods": "~1.1.1", "on-finished": "~2.3.0", "parseurl": "~1.3.0", "path-to-regexp": "0.1.7", "proxy-addr": "~1.0.8", "qs": "4.0.0", "range-parser": "~1.0.2", "send": "0.13.0", "serve-static": "~1.10.0", "type-is": "~1.6.6", "utils-merge": "1.0.0", "vary": "~1.0.1" }, "devDependencies": { "after": "0.8.1", "ejs": "2.3.3", "istanbul": "0.3.17", "marked": "0.3.5", "mocha": "2.2.5", "should": "7.0.2", "supertest": "1.0.1", "body-parser": "~1.13.3", "connect-redis": "~2.4.1", "cookie-parser": "~1.3.5", "cookie-session": "~1.2.0", "express-session": "~1.11.3", "jade": "~1.11.0", "method-override": "~2.3.5", "morgan": "~1.6.1", "multiparty": "~4.1.2", "vhost": "~3.0.1" }, "engines": { "node": ">= 0.10.0" }, "files": [ "LICENSE", "History.md", "Readme.md", "index.js", "lib/" ], "scripts": { "test": "mocha --require test/support/env --reporter spec --bail --check-leaks test/ test/acceptance/", "test-ci": "istanbul cover node_modules/mocha/bin/_mocha --report lcovonly -- --require test/support/env --reporter spec --check-leaks test/ test/acceptance/", "test-cov": "istanbul cover node_modules/mocha/bin/_mocha -- --require test/support/env --reporter dot --check-leaks test/ test/acceptance/", "test-tap": "mocha --require test/support/env --reporter tap --check-leaks test/ test/acceptance/" }, "gitHead": "ef7ad681b245fba023843ce94f6bcb8e275bbb8e", "bugs": { "url": "https://github.com/strongloop/express/issues" }, "_id": "[email protected]", "_shasum": "ddb2f1fb4502bf33598d2b032b037960ca6c80a3", "_from": "express@*", "_npmVersion": "1.4.28", "_npmUser": { "name": "dougwilson", "email": "[email protected]" }, "maintainers": [ { "name": "tjholowaychuk", "email": "[email protected]" }, { "name": "jongleberry", "email": "[email protected]" }, { "name": "dougwilson", "email": "[email protected]" }, { "name": "rfeng", "email": "[email protected]" }, { "name": "aredridel", "email": "[email protected]" }, { "name": "strongloop", "email": "[email protected]" }, { "name": "defunctzombie", "email": "[email protected]" } ], "dist": { "shasum": "ddb2f1fb4502bf33598d2b032b037960ca6c80a3", "tarball": "http://registry.npmjs.org/express/-/express-4.13.3.tgz" }, "directories": {}, "_resolved": "https://registry.npmjs.org/express/-/express-4.13.3.tgz", "readme": "ERROR: No README data found!"}

Package.json 屬性說明

• name - 包名。

• version - 包的版本號。

• description - 包的描述。

• homepage - 包的官網 url 。

• author - 包的作者姓名。

• contributors - 包的其他貢獻者姓名。

• dependencies - 依賴包列表。如果依賴包沒有安裝，npm 會自動將依賴包安裝在 node_module 目錄下。

• repository - 包代碼存放的地方的類型，可以是 git 或 svn，git 可在 Github 上。

• main - main 字段指定了程序的主入口文件，require('moduleName') 就會加載這個文件。這個字段的默認值是模塊根目錄下面的 index.js。

• keywords - 關鍵字

卸載模塊

我們可以使用以下命令來卸載 Node.js 模塊。

$ npm uninstall express

卸載後，你可以到 /node_modules/ 目錄下查看包是否還存在，或者使用以下命令查看：

$ npm ls

更新模塊

我們可以使用以下命令更新模塊：

$ npm update express

搜索模塊

使用以下來搜索模塊：

$ npm search express

創建模塊

創建模塊，package.json 文件是必不可少的。我們可以使用 NPM 生成 package.json 文件，生成的文件包含了基本的結果。

$ npm initThis utility will walk you through creating a package.json file.It only covers the most common items, and tries to guess sensible defaults.See `npm help json` for definitive documentation on these fieldsand exactly what they do.Use `npm install <pkg> --save` afterwards to install a package andsave it as a dependency in the package.json file.Press ^C at any time to quit.name: (node_modules) runoob # 模塊名version: (1.0.0) description: Node.js 測試模塊(www.runoob.com) # 描述entry point: (index.js) test command: make testgit repository: https://github.com/runoob/runoob.git # Github 地址keywords: author: license: (ISC) About to write to ……/node_modules/package.json: # 生成地址{ "name": "runoob", "version": "1.0.0", "description": "Node.js 測試模塊(www.runoob.com)", ……}Is this ok? (yes) yes

以上的信息，你需要根據你自己的情況輸入。在最後輸入 "yes" 後會生成 package.json 文件。

接下來我們可以使用以下命令在 npm 資源庫中註冊用戶（使用郵箱註冊）：

$ npm adduserUsername: mcmohdPassword:Email: (this IS public) [email protected]

接下來我們就用以下命令來發布模塊：

$ npm publish

如果你以上的步驟都操作正確，你就可以跟其他模塊一樣使用 npm 來安裝。

版本號

使用NPM下載和發佈代碼時都會接觸到版本號。NPM使用語義版本號來管理代碼，這裡簡單介紹一下。

語義版本號分為X.Y.Z三位，分別代表主版本號、次版本號和補丁版本號。當代碼變更時，版本號按以下原則更新。

• 如果只是修復bug，需要更新Z位。

• 如果是新增了功能，但是向下兼容，需要更新Y位。

• 如果有大變動，向下不兼容，需要更新X位。

版本號有了這個保證後，在申明第三方包依賴時，除了可依賴於一個固定版本號外，還可依賴於某個範圍的版本號。例如"argv": "0.0.x"表示依賴於0.0.x系列的最新版argv。

NPM支持的所有版本號範圍指定方式可以查看官方文檔。

NPM 常用命令

除了本章介紹的部分外，NPM還提供了很多功能，package.json裡也有很多其它有用的字段。

除了可以在npmjs.org/doc/查看官方文檔外，這裡再介紹一些NPM常用命令。

NPM提供了很多命令，例如install和publish，使用npm help可查看所有命令。

• NPM提供了很多命令，例如install和publish，使用npm help可查看所有命令。

• 使用npm help <command>可查看某條命令的詳細幫助，例如npm help install。

• 在package.json所在目錄下使用npm install . -g可先在本地安裝當前命令行程序，可用於發佈前的本地測試。

• 使用npm update <package>可以把當前目錄下node_modules子目錄裡邊的對應模塊更新至最新版本。

• 使用npm update <package> -g可以把全局安裝的對應命令行程序更新至最新版。

• 使用npm cache clear可以清空NPM本地緩存，用於對付使用相同版本號發佈新版本代碼的人。

• 使用npm unpublish <package>@<version>可以撤銷發佈自己發佈過的某個版本代碼。

使用淘寶 NPM 鏡像

大家都知道國內直接使用 npm 的官方鏡像是非常慢的，這裡推薦使用淘寶 NPM 鏡像。

淘寶 NPM 鏡像是一個完整 npmjs.org 鏡像，你可以用此代替官方版本(只讀)，同步頻率目前為 10分鐘 一次以保證儘量與官方服務同步。

你可以使用淘寶定製的 cnpm (gzip 壓縮支持) 命令行工具代替默認的 npm:

$ npm install -g cnpm --registry=https://registry.npm.taobao.org

這樣就可以使用 cnpm 命令來安裝模塊了：

$ cnpm install [name]