這里有一篇很好的 Node.js 介紹文章 great nodejs intro ，它將給你一個非常方便的介紹 Node.js 和 CouchDB，并給出一個實例實現 REST 的服務用于執行書簽的 CRUD 操作，使用 CouchDB 作為數據庫。
本文將介紹在 Mac OS X 下安裝并開始使用 Node.js ，這個過程大概需要 30 分鐘左右的時間，其中我們還將安裝 CouchDB，并實現基于 CouchDB 的 REST API。
本文假設你機器上已經裝有Git，如果還沒有，請參考此文進行安裝。
安裝 node.js 和 npm
最簡單的方法是在 node.js 的官網上通過 the nodejs download section 頁面并選擇 Mac 下的安裝程序，它將在你的機器上安裝 Node.js 和 npm (node package manager).
安裝成功后你就可以使用 node 和 npm 命令了。
安裝 CouchDB
因為本文需要使用 CouchDB 來存儲對象，因此還需要安裝 CouchDB.
安裝 CouchDB 稍微麻煩一些，因為我們需要下載源碼然后編譯I，在此之前需要先安裝 Homebrew ，請執行以下命令：
git clone https://github.com/mxcl/homebrew.gitcd homebrew/binbrew install autoconf automake libtoolbrew install couchdb
重要的提示：CouchDB 之前報出一個問題可能會阻止你安裝，要修復這個問題需要手工編輯 ~/couch/homebrew/Library/Formula/couchdb.rb 文件，編輯內容如下：
請注意需要將 url 中的 source 刪除，最終修改結果如下：
如果安裝過程被掛起了，你需要 CTRL-C 終止并執行下面命令重試：
更多關于 Mac OS X 上安裝 CouchDB 的信息請閱讀 "Installing CouchDB on OSX".
一旦 CouchDB 編譯完成，我們可以手工執行 ./couchdb 來啟動它，你可以在瀏覽器中打開 http://127.0.0.1:5984/_utils 這個地址以驗證 CouchDB 安裝是否成功。
下載教程
現在所需的軟件都已經安裝完成，我們接下來繼續 Node.js 的介紹實例。
首先我們使用 Git 來獲取實例源碼
git clone https://github.com/indexzero/nodejs-intro.git
創建 CouchDB 數據庫
在開始教程之前我們需要創建一個 CouchDB 數據庫，先確保 CouchDB 已經啟動，然后使用如下命令創建數據庫：
$ curl -X PUT http://127.0.0.1:5984/pinpoint-dev10
{"ok":true}
你可以在瀏覽器中訪問 http://127.0.0.1:5984/_utils 就可以看到新創建的數據庫。
這里還有一個非常棒的 CouchDB 的指南。
開始教程
node js 實例使用模塊化的方式構建，lib 目錄包含很多模塊，而服務器腳本在 bin 目錄下。
例如，我們要啟動 CouchDB 教程，可以在 bin 目錄下執行下面命令：
./server -t 02couchdb -s
其中 -t 參數允許你指定要執行的 lib 目錄下的模塊，-s 參數用以設置我們剛建立的 pinpoint-dev 數據庫。
sys - util 變化
根據 Node.js 的版本不同，你可能會看到如下的錯誤或者是警告：
為了避免這個問題，你需要將所有調用 `require("sys")` 替換成 `require("util")`
Node v0.6.14 不會拋出錯誤信息，但會提示警告：
運行教程
當你運行某個教程時，會提示一些錯誤：
該教程包含很多依賴，我們需要使用 npm 來下載這些依賴的包。
安裝 node 包
Node packages (dependencies) 可通過 npm 命令來安裝，例如：
$ npm install optimistnpm http GET https://registry.npmjs.org/optimistnpm http 200 https://registry.npmjs.org/optimistnpm http GET https://registry.npmjs.org/optimist/-/optimist-0.2.8.tgznpm http 200 https://registry.npmjs.org/optimist/-/optimist-0.2.8.tgznpm http GET https://registry.npmjs.org/wordwrapnpm http 200 https://registry.npmjs.org/wordwrapnpm http GET https://registry.npmjs.org/wordwrap/-/wordwrap-0.0.2.tgznpm http 200 https://registry.npmjs.org/wordwrap/-/wordwrap-0.0.2.tgzoptimist@0.2.8 ../node_modules/optimist└── wordwrap@0.0.2
這些包將被安裝到 node_modules 文件夾中：
$ ls -l ../node_modules/total 0drwxr-xr-x 10 ddewaele staff 340 Apr 1 18:54 optimist
本文需要安裝如下的 node 包：
npm install winstonnpm install cradlenpm install journeynpm install optimist
運行教程
進入 bin 目錄，通過下面命令來運行教程：
$ ./server -t 02couchdb -sThe "sys" module is now called "util". It should have a similar interface.Pinpoint demo server listening for 02couchdb on http://127.0.0.1:8000
然后打開瀏覽器訪問 http://127.0.0.1:8000/bookmarks ，將會看到如下的結果：
這表示服務已經啟動并運行，為了在 CouchDB 中添加點測試數據，我們可以使用 http-console 控制臺來訪問 CouchDB 的 REST 服務。
安裝 http-console
有一個非常棒的工具可以幫助你調試服務，該工具名為 http-console ，你可使用 npm 來安裝：
sudo npm install -g http-console
然后就可以在命令行中執行該工具，不幸的是當我們執行該命令時報錯了：
$ http-console node.js:201 throw e; // process.nextTick error, or 'error' event on first tick ^Error: require.paths is removed. Use node_modules folders, or the NODE_PATH environment variable instead. at Function. (module.js:378:11) at Object. (/usr/local/lib/node_modules/http-console/bin/http-console:6:8) at Module._compile (module.js:441:26) at Object..js (module.js:459:10) at Module.load (module.js:348:31) at Function._load (module.js:308:12) at Array.0 (module.js:479:10) at EventEmitter._tickCallback (node.js:192:40)
很麻煩，我們還需要手工編輯 /usr/local/lib/node_modules/http-console/bin/http-console 文件，然后刪除下面這一行：
現在 http-console 就可以啟動了，無需任何參數，它將連接到 http://localhost:8080 ，如果你需要指定服務器和端口，把它作為第一個參數傳遞給 http-console 即可。
請注意我們這里使用了 /json 命令用來設置正確的 content-type：
$ http-console http://127.0.0.1:8000The "sys" module is now called "util". It should have a similar interface.> http-console 0.6.1> Welcome, enter .help if you're lost.> Connecting to 127.0.0.1 on port 8000. http://127.0.0.1:8000/> /jsonhttp://127.0.0.1:8000/>
在 http-console 中，要執行 GET 請求只需要輸入 GET /bookmarks 即可：
http://127.0.0.1:8000/> GET /bookmarksHTTP/1.1 200 OKDate: Sun, 01 Apr 2012 17:23:27 GMTServer: journey/0.4.0Content-Type: application/json;charset=utf-8Content-Length: 16Connection: keep-alive { bookmarks: []}
你也可以使用 JSON 的片段來執行 POST 請求：
http://127.0.0.1:8000/> POST /bookmarks... { "url": "http://nodejs.org" }HTTP/1.1 200 OKDate: Thu, 05 Apr 2012 11:45:55 GMTServer: journey/0.4.0Content-Type: application/json;charset=utf-8Content-Length: 91Connection: keep-alive { bookmark: { _id: 'WD-G-1', resource: 'Bookmark', url: 'http://nodejs.org' }}
然后再次執行 GET 請求，你就可以看到新插入的數據了：
http://127.0.0.1:8000/> GET /bookmarksHTTP/1.1 200 OKDate: Sun, 01 Apr 2012 17:23:27 GMTServer: journey/0.4.0Content-Type: application/json;charset=utf-8Content-Length: 16Connection: keep-alive { bookmarks: [ { _rev: '1-cfced13a45a068e95daa04beff562360', _id: 'WD-G-1', resource: 'Bookmark', url: 'http://nodejs.org' } ]}新聞熱點
疑難解答
