前後端高效協作開發的11條建議

內容來源:作者,深予之 (@senntyou),https://github.com/senntyou/blogs;來自,https://segmentfault.com/a/1190000016852780

閱讀字數:4430 | 12分鐘閱讀

摘要

最後一條最牛逼……

1. 前後端分離

前端與後端的分離,能使前端的開發脫離後端的開發模式,擁有更大的自由度,以此便可做前端工程化、組件化、單頁面應用等。

可以參考:前後端分離、web與static服務器分離(https://segmentfault.com/a/1190000015297319)。

2. 儘量避免後端模板渲染

web 應用的渲染方式分爲服務器端渲染和客戶端渲染,當下比較推薦的方式是客戶端渲染,數據使用全 ajax 的方式進行交互。

除非在一些不得不使用服務器端渲染的情況下(如門戶、電商等),應當儘量使用客戶端渲染,因爲客戶端渲染更能使前後端分離(項目分離、代碼解耦、協作分離、職責分離等),也能更好的做本地接口模擬開發,提升開發效率。

即使用服務器端渲染,在技術支持的條件下,可以使用 node 中間層(由前端人員開發),代替傳統的後端模板渲染,這樣可以使後端與前端完全解耦,後端與前端只有數據上的往來。

可以參考:細說後端模板渲染、客戶端渲染、node 中間層、服務器端渲染(ssr)(https://segmentfault.com/a/1190000016704384)。

3. 儘量避免大量的線上調試

做好本地接口模擬開發(包括後端模板渲染),避免大量的線上調試,因爲線上調試很不方便,也很費事,並且每次更新代碼,都需要重新構建,然後同步到服務器。

所以做好本地接口模擬開發,只要程序在本地運行是沒問題的,一般線上就不會有太大的問題,這樣就能大幅降低調試工作量,提升開發效率。

4. 本地接口模擬開發

本地接口模擬就是在本地模擬一個與服務器差不多的環境,能夠提供數據所需的接口,進行錯誤模擬處理等等。

本地接口模擬開發的意義就在於能夠在本地完成幾乎所有的開發與調試,儘量減少線上的調試,提高開發效率。

一些常用庫:

  • browser-sync(https://github.com/BrowserSync/browser-sync):能讓瀏覽器實時、快速響應文件更改( html、 js、css、 sass、 less 等)並自動刷新頁面,並且可以同時在PC、平板、手機等設備下進行調試。
  • webpack-dev-middleware(https://github.com/webpack/webpack-dev-middleware):A development middleware for webpack。
  • webpack-hot-middleware(https://github.com/webpack-contrib/webpack-hot-middleware):熱更新本地開發瀏覽器服務。

另外,本地接口模擬開發需要後端開發人員有規範的接口文檔。

可以參考:本地化接口模擬、前後端並行開發(https://segmentfault.com/a/1190000015297352)。

5. 規範的接口文檔

前端與後端協作提升開發效率的一個很重要的方法就是減少溝通:能夠形成紙質的文檔就不要口頭溝通、能夠把接口文檔寫清楚也不要口頭溝通(參數、數據結構、字段含義等),特別是線上協作的時候,面對面交流是很困難的。

一個良好的接口文檔應當有以下的幾點要求與信息:

  1. 格式簡潔清晰:推薦用 API Blueprint(https://apiblueprint.org/)
  2. 分組:當接口很多的時候,分組就很必要了
  3. 接口名、接口描述、接口地址
  4. http 方法、參數、headers、是否序列化
  5. http 狀態碼、響應數據

接口文檔可以用一些文檔服務(如 leanote(https://github.com/leanote/leanote))來管理文檔,也可以用 git 來管理;書寫方式可以用 markdown,也可以 YAML、 JSON 等。

推薦使用 markdown 方式寫文檔,用 git 管理文檔。

可以參考:

  • 本地化接口模擬、前後端並行開發(https://segmentfault.com/a/1190000015297352)
  • API Blueprint(https://apiblueprint.org/)

6. 去緩存

前端需要做好去客戶端緩存的功能,保證用戶始終都是使用的最新資源,不會因爲因爲緩存的問題而出現 bug。

傳統的去緩存是在靜態資源 url 上加上版本號或者時間戳,不過因爲構建工具的出現以及一些瀏覽器已經不支持這種方式了的緣故,這種方式已經是過去時了。

現在去緩存是將文件 hash 化命名,只要文件變動,文件名就會不一樣,以此才能徹底的去緩存。如果使用 webpack 進行打包,會自動將所有文件進行 hash 化命名。

可以參考:webpack output-filename(https://webpack.js.org/configuration/output/#output-filename)。

7. 做好錯誤處理

前端與後端都需要各自做好錯誤處理,以便發生錯誤能夠有友好的提示,也能在用戶反饋時快速準確定位錯誤來源和原因。

一般前端的錯誤分爲:

  • 腳本運行錯誤: js 腳本錯誤,找到堆棧信息,然後解決
  • 接口錯誤:服務器報錯、數據返回不對、沒有響應數據、超時等

而接口錯誤分爲:

  • 狀態碼錯誤(狀態碼非 2XX):服務器報錯、超時等
  • 數據錯誤:沒有響應數據、數據格式不對、數據內容不對

可以參考:HTTP狀態碼(https://baike.baidu.com/item/HTTP%E7%8A%B6%E6%80%81%E7%A0%81/5053660?fr=aladdin)。

8. 運行時捕捉 js 腳本錯誤

當用戶在用線上的程序時,怎麼知道有沒有出 bug;如果出 bug 了,報的是什麼錯;如果是 js 報錯,怎麼知道是那一行運行出了錯?

所以,在程序運行時捕捉 js 腳本錯誤,並上報到服務器,是非常有必要的。

這裏就要用到 window.onerror 了:

window.onerror = (errorMessage, scriptURI, lineNumber, columnNumber, errorObj) => {
  const data = {
    title: document.getElementsByTagName('title')[0].innerText,
    errorMessage,
    scriptURI,
    lineNumber,
    columnNumber,
    detailMessage: (errorObj && errorObj.message) || '',
    stack: (errorObj && errorObj.stack) || '',
    userAgent: window.navigator.userAgent,
    locationHref: window.location.href,
    cookie: window.document.cookie,
  };
  post('url', data); // 上報到服務器
};

線上的 js 腳本都是壓縮過的,需要用 sourcemap 文件與 source-map(https://github.com/mozilla/source-map) 查看原始的報錯堆棧信息。

可以參考:

  • webpack - devtool(https://webpack.js.org/configuration/devtool/)
  • source-map(https://github.com/mozilla/source-map)

9. 移動端遠程調試、vConsole、TBS Studio

因爲移動端的開發無法像 pc 端開發一樣使用 Chrome 的開發者調試工具,所以調試移動端需要一些額外的技巧。

移動端應用一般都運行在微信瀏覽器中、 webview 中、手機瀏覽器中。

遠程調試(Remote Debugging)

遠程調試就是通過 USB 連接、端口轉發、搭建代理等方式,將一個設備的 web頁面映射到另一個設備上,比如將手機的 webview 映射到 pc 上,達到調試的目的。

移動端 web 應用調試難題從一開始就有,不過後來瀏覽器廠商基本都推出自己的遠程調試工具來解決這個問題,包括 OperaMobile、 iOSSafari、 ChromeforAndroid、UC 瀏覽器等,另外還有一些第三方開發的遠程調試工具,比如 weinre(http://people.apache.org/~pmuellr/weinre/docs/1.x/1.5.0/) 等。

以 Android 爲例,可以將 webview、 ChromeforAndroid 中的頁面映射到 pc 端的 ChromeDevTools,然後就可以在 pc 端調試移動端的頁面了。

可以參考:移動端Web開發調試之Chrome遠程調試(Remote Debugging)(https://blog.csdn.net/freshlover/article/details/42528643/)。

vConsole

一個輕量、可拓展、針對手機網頁的前端開發者調試面板( chrome 開發者工具的便利實現)。

這個是內嵌的頁面當中的便捷調試器,基本上能夠滿足一般的需要遠程調試的頁面。

  • github:https://github.com/Tencent/vConsole
  • demo:https://wechatfe.github.io/vconsole/demo.html

TBS Studio

因爲微信瀏覽器是定製的瀏覽器,一般的遠程調試方式都不可用,需要配合特定的工具,如微信開發者工具。

TBS Studio(https://x5.tencent.com/tbs/guide.html) 是另一個可以像 Chrome 一樣調試遠程微信瀏覽器頁面的強大工具。

可以參考:

tbs studio - 騰訊瀏覽服務-調試工具(https://x5.tencent.com/tbs/guide/debug/season1.html)

TBS Studio(https://x5.tencent.com/tbs/guide.html)

10. 前端後並行開發

正常情況下,前端的開發在完成 UI 或者組件開發之後,就需要等後端給出接口文檔才能繼續進行,如果能做到前後端並行開發,也能提升開發效率。

前後端並行開發,就是說前端的開發不需要等後端給出接口文檔就可以進行開發,等後端給出接口之後,再對接好後就基本上可以上線了。

在本地化接口模擬的實現下,就可以做到前後端並行開發,只是在代碼層面需要對 ajax 進行封裝。

可以參考:本地化接口模擬、前後端並行開發(https://segmentfault.com/a/1190000015297352)。

11. 友好的溝通

不管工具多麼厲害,很多時候都免不了要當面溝通,友好、心平氣和的溝通也是很重要的哩!

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章