本文記錄在 Mac OS X 上把 Node.js 開發環境搭起來的完整過程,順便把 CouchDB 裝好,最後跑起一個以 CouchDB 為資料庫的 REST 書籤服務範例。整體約需半小時。
前置條件:機器上已經有 Git。若還沒有,請先安裝。範例本身取自一份很不錯的 Node.js 與 CouchDB 入門教學,示範如何用 REST 介面執行書籤的 CRUD 操作。

最省事的方式是到 Node.js 官方下載頁挑選 Mac 版安裝程式,它會同時裝好 Node 與 npm(Node Package Manager)。裝完即可在終端使用 node 與 npm 兩個指令:
node -v
npm -v
CouchDB 需要從原始碼編譯,所以先透過 Homebrew 處理相依套件:
git clone https://github.com/mxcl/homebrew.git
cd homebrew/bin
brew install autoconf automake libtool
brew install couchdb
這個步驟是安裝過程中最容易卡住的地方。常見的狀況是 formula 裡的軟體下載位址失效,需要手動編輯 ~/couch/homebrew/Library/Formula/couchdb.rb,把 url 中的 source 這一段路徑移除,讓它指向實際的 tarball 位置:
require 'formula'
class Couchdb < Formula
url 'https://www.apache.org/dyn/closer.cgi?path=couchdb/1.1.1/apache-couchdb-1.1.1.tar.gz'
homepage "https://couchdb.apache.org/"
md5 'cd126219b9cb69a4c521abd6960807a6'
end
若安裝過程看起來停住不動,按 Ctrl-C 中斷,改用詳細模式重試以觀察實際進度:
./brew install -v couchdb
編譯完成後,執行 ./couchdb 即可啟動。在瀏覽器打開 https://127.0.0.1:5984/_utils,若看到管理介面就代表安裝成功。
git clone https://github.com/indexzero/nodejs-intro.git
確認 CouchDB 已啟動,再用 curl 建立一個資料庫:
$ curl -X PUT https://127.0.0.1:5984/pinpoint-dev10
{"ok":true}
回到 _utils 介面重新整理,就能看到新的資料庫出現在清單裡。
範例寫於 Node 早期版本,新版會直接拋錯:
Error: The "sys" module is now called "util".
0.6.x 版只是警告,0.7 之後則會中斷執行。解法很直接——把所有 require("sys") 換成 require("util"),介面大致相容。
直接執行會看到找不到模組的錯誤:
Error: Cannot find module 'optimist'
範例依賴不少套件,用 npm 逐一安裝即可:
$ npm install optimist
optimist@0.2.8 ../node_modules/optimist
└── wordwrap@0.0.2
套件會被放進 node_modules 目錄。這個範例需要的四個:
npm install winston
npm install cradle
npm install journey
npm install optimist
進入 bin 目錄,用 -t 指定要執行的模組、-s 指定剛才建立的資料庫:
$ ./server -t 02couchdb -s
Pinpoint demo server listening for 02couchdb on https://127.0.0.1:8000
瀏覽器拜訪 https://127.0.0.1:8000/bookmarks,看到 {"bookmarks":[]} 就代表服務正常。
想在命令行裡直接跟 REST 服務對話,可以裝 http-console:
sudo npm install -g http-console
它在新版 Node 下同樣會遇到舊 API 問題(require.paths is removed),需要編輯 /usr/local/lib/node_modules/http-console/bin/http-console,刪除這一行:
require.paths.unshift(path.join(__dirname, '..', 'lib'));
接著啟動並切換成 JSON 模式,才能送出正確的 content-type:
$ http-console https://127.0.0.1:8000
https://127.0.0.1:8000/> json
查詢:
https://127.0.0.1:8000/> GET /bookmarks
HTTP/1.1 200 OK
Content-Type: application/json;charset=utf-8
{ bookmarks: [] }
新增一筆:
https://127.0.0.1:8000/> POST /bookmarks
... { "url": "https://nodejs.org" }
HTTP/1.1 200 OK
{ bookmark: { _id: 'WD-G-1', resource: 'Bookmark', url: 'https://nodejs.org' } }
再次 GET,就能撈到剛才寫入的資料,帶著 CouchDB 產生的 _id 與 _rev。
這份流程完整反映了那個年代的安裝風景:手動改 formula、手動刪除已移除的 API、逐一補裝相依套件。今天重現它時,這些步驟大多已被 nvm、Homebrew 的官方 formula 與現成的 CouchDB 安裝檔取代,直接照官方文件走會順利得多。不過理解這些錯誤訊息背後的原因——模組改名、API 移除、相依未安裝——在維護任何老專案時都用得上。