萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

Mac OS 上安裝 Node.js 與 CouchDB 完整教學:打造 REST API 開發環境

前言

本文將引導你在 Mac OS X 環境下,從零開始安裝 Node.js、npm 與 CouchDB,並透過一個實戰專案實作基於 CouchDB 的 RESTful API 服務。全程預計約 30 分鐘,適合想快速上手全端 JavaScript 開發的工程師。

前置需求

步驟一:安裝 Node.js 與 npm

最簡單方式是前往 Node.js 官網下載頁,下載 macOS 安裝包(.pkg)並執行安裝。安裝完成後,驗證版本:

node -v
npm -v

步驟二:安裝 Homebrew 與 CouchDB

CouchDB 需編譯安裝,建議透過 Homebrew 管理依賴:

# 安裝 Homebrew(若已安裝可跳過)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安裝編譯工具與 CouchDB
brew install autoconf automake libtool
brew install couchdb

常見安裝問題修正

若編譯失敗,可能需修正 Homebrew Formula 中的下載連結:

  1. 編輯 ~/homebrew/Library/Formula/couchdb.rb
  2. 將 url 中的 source/ 移除:
    url 'https://www.apache.org/dyn/closer.cgi?path=couchdb/1.1.1/apache-couchdb-1.1.1.tar.gz'
  3. 重新安裝:brew install -v couchdb

步驟三:啟動與驗證 CouchDB

# 啟動 CouchDB(前景模式)
couchdb

# 或背景模式
brew services start couchdb

打開瀏覽器訪問 Fauxton 管理介面,若看到儀表板即安裝成功。

步驟四:取得實戰專案原始碼

git clone https://github.com/indexzero/nodejs-intro.git
cd nodejs-intro

步驟五:建立 CouchDB 資料庫

# 確保 CouchDB 正在運行
curl -X PUT https://127.0.0.1:5984/pinpoint-dev
# 回應 {"ok":true} 表示成功

步驟六:啟動教學範例伺服器

專案採用模組化架構,lib/ 存放模組,bin/ 存放啟動腳本:

cd bin
./server -t 02couchdb -s
  • -t 02couchdb:指定載入 lib/02couchdb.js 模組
  • -s:使用剛建立的 pinpoint-dev 資料庫

常見問題排解

1. sys 模組棄用警告/錯誤

Node.js v0.6+ 將 sys 重命名為 util。若出現錯誤,請將專案中所有 require('sys') 替換為 require('util')。

2. 缺少 optimist 等依賴套件

使用 npm 安裝專案所需套件:

npm install optimist winston cradle journey

套件將安裝至專案根目錄下的 node_modules/。

驗證服務運行

啟動成功後,終端機將顯示:

Pinpoint demo server listening for 02couchdb on https://127.0.0.1:8000

打開瀏覽器訪問 https://127.0.0.1:8000,即可體驗完整的書籤 CRUD REST API 服務。

延伸學習資源

copyright © 萬盛學電腦網 all rights reserved