上篇博客，介紹了性能測試從零開始實施如何制定流程。開始本篇博客之前，讓我們先回想下在你的工作經歷中，是否遇到過下面的一些問題：

1、要做接口測試，找開發要接口文檔，開發告訴你沒有接口文檔，要麽自己去看代碼，要麽抓包；

2、來了新同事，領導要求你帶帶新人，由於歷史原因，沒有最新的PRD、沒有流程規範等各種文檔記錄，你只能口頭去告訴新人你們的流程規範、遇到什麽問題該找誰；

3、線上出問題了，可能是開發的某個配置出錯了，可能代碼合並時沒有提交最新的代碼，可能測試用例沒覆蓋到漏測，可能需求描述不清導致實際的功能和預期有偏差；

4、產品說這裏改改，就加一個按鈕，不影響功能，開發同學改了，測試同學不知道就上線發布了，結果出問題了，事後追溯下來，發現就是新增的按鈕導致；

5、其他。。。。。。

如果上述的問題你都遇到過，那麽恭喜你，你已經脫離萌新階段；如果還沒遇到過，那你就該打起精神註意了，上述的問題會給你的工作造成很大困擾，無論現在還是將來。

首先聲明，這裏的文檔建設，不僅僅是傳統意義上的Word、excel、PPT，還包括看板、在線wiki等方式，文檔建設的核心是“約定大於配置！”

約定大於配置，就是盡量按照既定的、大家默認遵循的原則規範來執行，而不是口頭約定，互相點頭就行。

當然，這裏的約定，不是說嚴格遵循不能逾越，它可以根據具體的情況進行的調整，但要及時通知相關人員新的約定。

這篇博客，我們就來聊聊，性能測試從零開始實施，該如何開展文檔建設的相關工作。。。

一、文檔建設目的

1、制定工作開展的流程、各崗位職責以及執行參照準則；

2、降低工作交接、溝通的成本，提高效率；

3、便於事前、事中、事後快速回溯追蹤；

4、降低“口頭說明”帶來的風險；

5、有工作產出，為了“KPI”；

二、文檔範圍

性能測試方面，按照重要性和快速落地原則來排序，主要的文檔包括如下幾種：

三、文檔說明

1、流程規範

①、性能測試流程：沒有規矩不成方圓。流程規範的重要性在上篇博客：性能測試從零開始實施指南-流程篇已經詳細介紹了，這裏不再贅述。

②、發布上線流程：性能測試工作完成後，發布上線的流程一般都是遵循技術部門自定的流程，但有一點需要註意的時，由於性能測試優化有時會涉及到一些配置參數或者策略的變更，

在上線發布時，一定要驗證是否按照優化後的配置策略進行上線發布，如果遺漏可能會造成很嚴重的後果（本人之前遇到過好幾次，導致某些核心流程由於線上流量較大服務重啟）。

③、問題處理流程：在性能測試過程中，會遇到很多問題，比如數據失效、主要職責人沒空或請假、線上性能問題等，要針對性的出具應對策略，防止性能測試工作推進block。

2、方案報告

①、性能測試方案：測試方案的重要性不言而喻，需要多方達成一致，才能執行；當然，在測試流程規範中，就應該體現出這點。性能測試方案主要包含如下信息：

②、輪次小節：這一點其實很重要，每個小階段執行完畢，建議將本輪的測試結果告知相關人員，便於工作進展溝通。

③、性能測試報告：作為性能測試完成的標誌和重要產出物，性能測試報告需要對系統線上容量規劃提供重要的參考數據。性能測試報告主要包含如下信息：

3、技術規範

①、環境管理規範：性能測試的執行環境，按照真實可靠性來排序，生產環境＞獨立性能測試環境＞測試環境（即UAT/SIT），但綜合考慮風險、成本、有效性來說，

獨立的性能測試環境是最平衡的選擇，為了測試結果的準確性和快速部署監控，環境的有效管理就顯得很有必要。

②、腳本編寫規範：性能測試工具各有各的優缺點，但不合理的使用方式，往往使得測試結果和實際差距太大，而且會遇到很多莫名其妙的錯誤。

當然對於高級資深的性能測試人員，這種犯錯幾率較低，但還是建議針對性的出具一份工具使用說明，對常見的組件使用方法進行規範。

4、細則說明

①、測試策略說明：性能測試有很多測試策略，不同的策略測試結果都有區別，比如基準和容量測試，穩定性和高可用測試，針對不同的測試目的，采用不同的合理的

測試策略是很重要的，這也很考驗測試人員的經驗和技術。當然，還有一部分原因是向其他相關成員說明不同測試策略的方式及原因，降低溝通障礙。

②、測試數據準備說明：性能測試過程中，測試數據的準備工作往往能占據10-20%的時間，而且數據的準確性有效性很重要，否則會導致測試結果南轅北轍。

建議出具一份測試數據準備說明，主要包括埋點數據、熱點數據、參數化數據以及數據準備方式，比如生產數據拖庫過敏、腳本批量插入等。

5、培訓文檔

①、性能測試宣講：我們不能保證性能測試的各個參與人員（開發、運維、項目經理、產品）對性能測試的認知保持一致（當然實際情況是有時候甚至不了解）。

因此建議在性能測試開展推進的初始階段，大概1-2個月時候，進行幾次性能測試常見術語、測試策略、職責的宣講，盡早達成一致性認知，降低後期的溝通成本。

②、測試平臺使用說明：隨著公司業務面臨的流量越發增長，初期的只利用壓測工具進行性能測試執行已經無法滿足工作需要，性能測試平臺這時候就該亮相了。

當平臺開發投入使用後，建議編寫一份使用手冊，便於平臺使用人員快速上手（測試平臺這個太遠，這裏只是提及一下，別放在心上233）。

6、新人手冊

①、新人手冊：當團隊漸漸人員不斷變多時，如何讓新人快速熟悉工作，就是需要考慮的問題。這個時候，建議編寫個新人手冊，主要介紹下如下幾點：

相關賬號開通、權限申請、各系統地址、負責人等信息，然後將上述的文檔給他，有疑問及時解答，這樣一方面新人有事可做，另一方面，你也不必為了在口頭教和自己的職責工作之間頭疼。

四、建設方式

除了常規的office三件套，現在還有很多在線wiki（比如Confluence），協同辦公軟件可以來幫助你進行文檔建設工作。

附：Confluence搭建詳解

五、文檔擴展

上面主要介紹的都是性能測試相關的文檔建設內容，如果上升到整個技術部門呢，我們應該做哪些文檔建設工作？下面是一些常見的文檔規範類型：

1、工作計劃

本月、本季度、本年工作規劃

2、各項流程

研發流程、測試流程、發布流程、問題處理流程、緊急事件應對流程

3、技術規範

java代碼規範、mysql規範、接口文檔規範、環境管理規範、Git使用規範、運維規範

4、相關文檔

組織結構、業務架構、系統架構、需求文檔、設計文檔、排期計劃、問題統計、培訓手冊

以上，為性能測試從零開始實施指南——文檔建設的一些個人總結和看法，內容僅供參考。。。

性能測試從零開始實施指南——文檔建設篇