本文分享一個使用 Node.js 開發微博應用的完整實例。由於原書基於舊版 Express,代碼在新版本下大量失效,作者邊學邊改,把升級過程中遇到的坑一併記錄下來,推薦給同樣在學習 Node.js 的朋友。
作為一名前端開發者,看到能用 JavaScript 寫後台自然很激動。但後台畢竟不同於前端,學習途中難免遇到各種問題。作者先看了《深入淺出 Node.js》,又轉戰《Node.js 開發指南》,直接上手第五章的微博實例,卻發現因為 Express 版本升級,書中代碼很多已不能用。

新版 Express 的 -t 參數已失效,默認模板引擎改為 jade。若要繼續使用 ejs,需改寫命令:
express -e ejs microblog
此外,直接運行 supervisor app.js 後訪問 3000 端口並看不到效果,需要在 app.js 的 app.use('/', routes); 後添加 app.listen(3000);。
新版 Express 不再支持 ejs 的 partials 方法,需額外安裝:
npm install express-partials
並在 app.js 中加入 var partials = require('express-partials'); app.use(partials());。注意這行要放在 app.set('view engine', 'ejs'); 之後,否則會出現 CSS 引用失敗。

首先需要安裝 MongoDB。新版 Express 下,settings.js 照書即可,但 models/db.js 需要改動。書中寫法會報錯,需改成:
module.exports = new Db(settings.db, new Server(settings.host, Connection.DEFAULT_PORT, {}), {safe: true});

引用 settings 模塊時,新版需寫成 var settings = require('./settings');(去掉路徑中的點)。

Express 4 需自行安裝 session 包:var session = require('express-session');,並把 connect-mongo 改為 require('connect-mongo')(session)。原來的 app.use(express.session({...})) 需改寫成 app.use(session({...}))。
視圖交互方面,原來的 app.dynamicHelpers 需改寫為 app.use(function(req, res, next){ res.locals.user = req.session.user; ... next(); })。此外 flash 也不再內置,需 npm install connect-flash 後引入 app.use(flash());。

完成以上改動後,跟著書本繼續,基本就不會再出問題,最終能得到預期的微博效果。

跟著書寫這個小應用的過程就是一路踩坑、一路 google 的過程。希望這篇記錄能幫你少走彎路,遇到問題也歡迎一起交流。