欧美成人午夜精品久久久,国产?V天堂一区二区三区,欧美精品va在线观看,亚洲一区二区三区免费在线观看,av无码精品一区二区久久,欧美性爱视频不卡一区三区,欧美乱人伦视频在线观看,国产一级牲交高潮

ARTICLE DETAIL

資訊詳情

深耕商務(wù)建站與企業(yè)官網(wǎng)運(yùn)營(yíng)的一線(xiàn)實(shí)戰(zhàn)洞察。

README 怎么寫(xiě):從項(xiàng)目入口到工程化維護(hù)指南

README 怎么寫(xiě):從項(xiàng)目入口到工程化維護(hù)指南 README 這三個(gè)字母幾乎每個(gè)碰過(guò)倉(cāng)庫(kù)的人都見(jiàn)過(guò)但真要把你真的知道 README 嗎這個(gè)問(wèn)題拋出來(lái)能答得漂亮的人并不多。我做過(guò)幾年內(nèi)部工具和開(kāi)源項(xiàng)目的維護(hù)見(jiàn)過(guò)太多這樣的場(chǎng)景代碼寫(xiě)得干凈利落測(cè)試覆蓋也夠結(jié)果 README 里只有孤零零一行項(xiàng)目名外加一句安裝依賴(lài)后運(yùn)行。新人接手第一天就得私聊作者七八個(gè)問(wèn)題外部用戶(hù)點(diǎn)進(jìn)來(lái)三秒鐘關(guān)掉頁(yè)面。README 不是倉(cāng)庫(kù)里的裝飾品它是這個(gè)項(xiàng)目唯一一份24 小時(shí)在線(xiàn)、面向所有陌生人的說(shuō)明書(shū)也是你未來(lái)自己的救命稻草。這篇內(nèi)容面向所有需要往倉(cāng)庫(kù)里填字的人寫(xiě)業(yè)務(wù)的、做工具的、搞算法的、維護(hù)內(nèi)部平臺(tái)的只要你的項(xiàng)目需要被別人跑起來(lái)讀下去就有收獲。我會(huì)從設(shè)計(jì)思路、逐塊寫(xiě)法、實(shí)操落地、問(wèn)題排查一路講透中間穿插我踩過(guò)的坑和可以直接抄的結(jié)構(gòu)。1. README 到底在解決什么問(wèn)題1.1 先搞清楚讀者是誰(shuí)再?zèng)Q定寫(xiě)什么很多人寫(xiě) README 時(shí)腦子里沒(méi)有具體的讀者形象于是寫(xiě)出來(lái)的東西既不像給自己的備忘也不像給別人的教程最后變成一堆零散信息的堆放場(chǎng)。我的習(xí)慣是先把讀者分成四類(lèi)寫(xiě)的時(shí)候腦子里想著他們各自的時(shí)間預(yù)算。第一類(lèi)是三分鐘后要決定要不要用這個(gè)東西的陌生人他們來(lái)自搜索、社區(qū)或者同事轉(zhuǎn)發(fā)只想知道這是什么、值不值得繼續(xù)看。第二類(lèi)是明天就要把它跑起來(lái)的使用者他們關(guān)心最短路徑、依賴(lài)版本、配置項(xiàng)。第三類(lèi)是半年后的你自己你已經(jīng)忘了當(dāng)時(shí)為什么選這個(gè)方案、那個(gè)參數(shù)為什么設(shè)成 64你需要一份能喚醒記憶的上下文。第四類(lèi)是潛在的貢獻(xiàn)者他們想知道代碼怎么組織、怎么提改動(dòng)、有哪些約定。這四類(lèi)人的需求是遞進(jìn)的不是并列的。README 的任務(wù)就是把這四種需求按優(yōu)先級(jí)排好讓第一類(lèi)人三十秒內(nèi)得到答案第二類(lèi)人五分鐘內(nèi)跑起來(lái)第三類(lèi)人隨時(shí)能查到?jīng)Q策依據(jù)第四類(lèi)人知道從哪兒下手。我見(jiàn)過(guò)反過(guò)來(lái)的寫(xiě)法開(kāi)頭先鋪兩千字的架構(gòu)演進(jìn)史把怎么用塞到文檔末尾結(jié)果外人根本撐不到那一節(jié)。這不是內(nèi)容不對(duì)是順序錯(cuò)了。還有一個(gè)容易被忽略的點(diǎn)README 的讀者里有很大一部分是搜索引擎和代碼托管平臺(tái)的推薦算法帶來(lái)的。別人搜到你的項(xiàng)目落地頁(yè)就是 README。這時(shí)候它承擔(dān)的其實(shí)是產(chǎn)品首頁(yè)的角色標(biāo)題、第一段、截圖、徽章全都在影響這個(gè)人的第一判斷。把 README 當(dāng)產(chǎn)品頁(yè)寫(xiě)很多取舍就自然清晰了。1.2 文檔分層README 只該承擔(dān)入口那一層一個(gè)健康的項(xiàng)目文檔體系其實(shí)是分層的README 只是最上面那一層入口。我把常見(jiàn)文檔按職責(zé)拆成這么幾塊你可以對(duì)照自己的倉(cāng)庫(kù)看看是不是全都塞進(jìn) README 里了。README 負(fù)責(zé)這是什么、怎么最快跑起來(lái)、去哪兒找更多docs/目錄負(fù)責(zé)深入內(nèi)容比如設(shè)計(jì)文檔、部署手冊(cè)、性能報(bào)告代碼注釋負(fù)責(zé)實(shí)現(xiàn)細(xì)節(jié)和為什么這么寫(xiě)CONTRIBUTING.md負(fù)責(zé)協(xié)作流程和提交規(guī)范CHANGELOG.md負(fù)責(zé)版本變更LICENSE負(fù)責(zé)授權(quán)條款配置示例文件負(fù)責(zé)字段說(shuō)明。分層的好處在于README 可以保持短而有力不被細(xì)節(jié)拖累。我踩過(guò)的一個(gè)典型坑是早期把完整的接口文檔、所有配置項(xiàng)、整套部署流程全都塞進(jìn) README結(jié)果它膨脹到八百多行誰(shuí)都不想讀改起來(lái)還容易漏。后來(lái)拆成 README 加docs/README 里只留一個(gè)指向文檔站的鏈接和一份最小配置示例維護(hù)成本立刻降下來(lái)。判斷某個(gè)內(nèi)容該不該放進(jìn) README我用的標(biāo)準(zhǔn)很簡(jiǎn)單如果一個(gè)剛接觸項(xiàng)目的人在決定要不要用和第一次跑通這兩個(gè)階段一定會(huì)需要就放 README如果只有深入使用或二次開(kāi)發(fā)時(shí)才需要就放進(jìn)docs/README 里留個(gè)入口。這個(gè)標(biāo)準(zhǔn)執(zhí)行下來(lái)README 的長(zhǎng)度通常能控制在兩三屏之內(nèi)信息密度反而更高。1.3 三個(gè)最常見(jiàn)的認(rèn)知誤區(qū)第一個(gè)誤區(qū)是把 README 當(dāng)成項(xiàng)目竣工后才需要補(bǔ)的作業(yè)。實(shí)際上它應(yīng)該是和代碼同步生長(zhǎng)的東西。我的習(xí)慣是倉(cāng)庫(kù)初始化第一個(gè)提交里就有 README 骨架哪怕內(nèi)容只有項(xiàng)目名和一句話(huà)定位也比空白強(qiáng)因?yàn)樗鼤?huì)持續(xù)提醒你這個(gè)項(xiàng)目現(xiàn)在對(duì)外是什么狀態(tài)。第二個(gè)誤區(qū)是寫(xiě)給自己看的備忘當(dāng)成了對(duì)外說(shuō)明。這兩者的差別非常大備忘可以寫(xiě)按上次那個(gè)方式跑就行對(duì)外說(shuō)明必須把上次那個(gè)方式完整寫(xiě)出來(lái)。我見(jiàn)過(guò)不少內(nèi)部項(xiàng)目的 README 里出現(xiàn)參考老版本配置同之前一樣新同事看了一臉茫然。任何指代都必須展開(kāi)成可以獨(dú)立理解的句子這是硬要求。第三個(gè)誤區(qū)是認(rèn)為代碼即文檔覺(jué)得 README 寫(xiě)多了會(huì)過(guò)期不如不寫(xiě)。這個(gè)邏輯只在極端情況下成立——比如一個(gè)純個(gè)人實(shí)驗(yàn)倉(cāng)庫(kù)。只要項(xiàng)目有第二個(gè)使用者README 的價(jià)值就遠(yuǎn)超它的維護(hù)成本。真正的問(wèn)題不是要不要寫(xiě)而是怎么寫(xiě)得不容易過(guò)期后面第三章我會(huì)專(zhuān)門(mén)講怎么把易變信息做成不易腐壞的形式比如用腳本代替手寫(xiě)命令、用配置示例文件代替大段字段羅列。2. README 的骨架設(shè)計(jì)與信息排序2.1 黃金三屏讀者在不同屏上要看到什么我習(xí)慣把 README 的閱讀體驗(yàn)按屏幕切成三段每一段有明確的任務(wù)。第一屏是決策屏讀者要在這里得到三個(gè)答案這是什么、給誰(shuí)用、現(xiàn)在處于什么狀態(tài)。所謂狀態(tài)指的是項(xiàng)目是活躍維護(hù)還是已歸檔是實(shí)驗(yàn)性質(zhì)還是生產(chǎn)可用這直接決定對(duì)方要不要繼續(xù)投入時(shí)間。很多人只寫(xiě)功能不寫(xiě)狀態(tài)結(jié)果用戶(hù)踩了一堆坑才發(fā)現(xiàn)這是個(gè)半成品。第二屏是上手屏要在最短距離內(nèi)讓人把東西跑起來(lái)。我通常把快速開(kāi)始放在第一屏末尾或第二屏開(kāi)頭不要讓人滾動(dòng)半天才找到。這一屏的核心指標(biāo)是命令條數(shù)我的目標(biāo)是三條命令以?xún)?nèi)跑通默認(rèn)配置克隆、安裝、啟動(dòng)。如果確實(shí)做不到那就說(shuō)明默認(rèn)配置設(shè)計(jì)得不夠友好這是代碼層面的問(wèn)題靠 README 糊是糊不過(guò)去的。第三屏是深入屏把文檔、接口說(shuō)明、常見(jiàn)問(wèn)題、貢獻(xiàn)指南這些東西按索引方式排好。注意這里是索引不是全文。第三屏之后讀者基本已經(jīng)決定留下來(lái)他們要的是我遇到問(wèn)題去哪兒查而不是你把所有內(nèi)容再貼一遍。這個(gè)三屏結(jié)構(gòu)最大的好處是讓寫(xiě)作有了取舍標(biāo)準(zhǔn)一句話(huà)放在哪一屏直接決定它該有多長(zhǎng)、多詳細(xì)。我在實(shí)際改版中試過(guò)把一份六百行的 README 按這個(gè)結(jié)構(gòu)重組內(nèi)容一條沒(méi)刪只是重新排序和分層收到的反饋是順手多了。2.2 一份可直接復(fù)用的骨架下面這個(gè)骨架我用了很多版本基本能覆蓋大部分項(xiàng)目類(lèi)型你可以直接抄下來(lái)改。順序本身就有信息量不要隨意打亂。項(xiàng)目名 一句話(huà)定位狀態(tài)徽章與關(guān)鍵鏈接文檔、示例、變更日志一段話(huà)說(shuō)明它解決什么問(wèn)題、適合誰(shuí)核心特性列表最多五條每條一行快速開(kāi)始環(huán)境要求、安裝、最小可運(yùn)行示例、預(yù)期輸出配置說(shuō)明表格 示例配置文件目錄結(jié)構(gòu)說(shuō)明常見(jiàn)問(wèn)題貢獻(xiàn)方式與授權(quán)說(shuō)明這里有幾個(gè)細(xì)節(jié)值得展開(kāi)。特性列表控制在五條以?xún)?nèi)是因?yàn)槌^(guò)五條讀者就不看了與其全列不如選最能體現(xiàn)差異化的。最小可運(yùn)行示例必須包含預(yù)期輸出這一條能省掉大量我跑完了但不知道對(duì)不對(duì)的追問(wèn)。目錄結(jié)構(gòu)說(shuō)明只講第一層和第二層深層的靠代碼注釋和文檔寫(xiě)太細(xì)必然過(guò)期。至于授權(quán)說(shuō)明哪怕你暫時(shí)不打算開(kāi)源也建議寫(xiě)清楚是否允許內(nèi)部復(fù)用是否允許二次分發(fā)這種信息晚寫(xiě)不如早寫(xiě)等到有糾紛再補(bǔ)就麻煩了。2.3 不同類(lèi)型的項(xiàng)目README 的重心完全不一樣寫(xiě) README 最忌諱套模板不看場(chǎng)景。同樣一份結(jié)構(gòu)在不同項(xiàng)目里的重心差別很大。我整理了一張對(duì)照表是我自己維護(hù)項(xiàng)目時(shí)的判斷依據(jù)。項(xiàng)目類(lèi)型第一優(yōu)先級(jí)次要內(nèi)容常見(jiàn)錯(cuò)誤庫(kù)或 SDK安裝命令、最小調(diào)用示例版本兼容矩陣、API 索引只寫(xiě)概念不寫(xiě)能跑的代碼應(yīng)用或服務(wù)依賴(lài)服務(wù)、啟動(dòng)命令、端口與訪(fǎng)問(wèn)方式配置項(xiàng)、部署說(shuō)明漏掉前置依賴(lài)導(dǎo)致啟動(dòng)失敗算法或研究代碼數(shù)據(jù)準(zhǔn)備、復(fù)現(xiàn)命令、結(jié)果對(duì)照參數(shù)含義、訓(xùn)練耗時(shí)不寫(xiě)隨機(jī)種子與硬件環(huán)境內(nèi)部工具權(quán)限申請(qǐng)、接入步驟、值班聯(lián)系人常見(jiàn)故障處理假設(shè)大家都懂內(nèi)部黑話(huà)拿算法類(lèi)項(xiàng)目舉例我見(jiàn)過(guò)最多的抱怨是論文里的數(shù)字復(fù)現(xiàn)不出來(lái)。這類(lèi) README 如果只寫(xiě)運(yùn)行 train.py基本等于沒(méi)寫(xiě)。至少要交代數(shù)據(jù)從哪兒來(lái)、預(yù)處理怎么做、用了幾張卡、訓(xùn)了多久、隨機(jī)種子設(shè)成多少最好附上一份小規(guī)模的可復(fù)現(xiàn)結(jié)果讓人能在幾分鐘內(nèi)驗(yàn)證流程是通的。內(nèi)部工具的 README 則是另一種思路它不需要解釋為什么要做這個(gè)但必須寫(xiě)清楚誰(shuí)能用、怎么申請(qǐng)、出問(wèn)題找誰(shuí)。我維護(hù)過(guò)一個(gè)內(nèi)部調(diào)度平臺(tái)最初 README 里全是架構(gòu)圖結(jié)果新同事最常問(wèn)的是權(quán)限怎么開(kāi)后來(lái)把權(quán)限申請(qǐng)流程提到最前面重復(fù)提問(wèn)直接少了一大半。3. 逐塊拆解每一節(jié)到底該怎么寫(xiě)3.1 項(xiàng)目名與一句話(huà)定位項(xiàng)目名之后緊跟的那句話(huà)是整份 README 里性?xún)r(jià)比最高的文字。它決定讀者要不要往下滾。我總結(jié)了一個(gè)簡(jiǎn)單的公式為誰(shuí)提供什么能力讓他們能做成什么事。比如面向小團(tuán)隊(duì)的本地任務(wù)隊(duì)列用一條命令就能把異步任務(wù)跑起來(lái)比一個(gè)高性能的分布式任務(wù)調(diào)度系統(tǒng)要有效得多因?yàn)楹笳叱诵稳菰~什么都沒(méi)有。寫(xiě)這句話(huà)時(shí)有兩個(gè)自我檢查。第一把形容詞全部刪掉看剩下的是不是還有信息量。高性能、輕量級(jí)、優(yōu)雅、現(xiàn)代化這些詞刪掉之后如果句子空了說(shuō)明你沒(méi)說(shuō)清楚它到底干什么。第二讓完全不懂這個(gè)領(lǐng)域的人讀一遍能不能說(shuō)出哦這是用來(lái)干嘛的。我做過(guò)一個(gè)小實(shí)驗(yàn)把定位句發(fā)給非技術(shù)崗位的同事看能復(fù)述出來(lái)才算過(guò)關(guān)。另外要克制堆特性的沖動(dòng)。我見(jiàn)過(guò)開(kāi)頭一句話(huà)里塞了七個(gè)功能點(diǎn)讀完什么印象都沒(méi)有。一句話(huà)只講一個(gè)最核心的價(jià)值主張其余的放到下面的特性列表和正文里去。3.2 徽章、截圖與演示素材的取舍徽章這塊爭(zhēng)議比較大。它的正面作用是快速傳遞狀態(tài)構(gòu)建是否通過(guò)、版本號(hào)、許可證類(lèi)型、依賴(lài)更新情況。反面作用是視覺(jué)噪音尤其是那種一行掛七八個(gè)徽章的讀者眼睛會(huì)自動(dòng)跳過(guò)整行。我的做法是只保留三類(lèi)構(gòu)建狀態(tài)、最新版本、許可證。其余全部刪掉需要詳細(xì)信息的人會(huì)去看倉(cāng)庫(kù)頁(yè)面本身。截圖和錄屏的價(jià)值遠(yuǎn)高于徽章但要注意時(shí)效性。截圖一定要標(biāo)注對(duì)應(yīng)的版本號(hào)否則三個(gè)月后界面改了新用戶(hù)按圖索驥找不到入口反而制造困惑。演示動(dòng)圖控制體積十幾秒足夠展示核心路徑不要錄三分鐘的全流程加載慢而且沒(méi)人看完。還有一個(gè)容易翻車(chē)的點(diǎn)不要放無(wú)法復(fù)現(xiàn)的演示鏈接。指向一個(gè)臨時(shí)環(huán)境的地址過(guò)兩周就失效了用戶(hù)點(diǎn)開(kāi)是 404對(duì)信任度的打擊比不放鏈接更大。如果確實(shí)需要在線(xiàn)演示就把它做成可長(zhǎng)期維護(hù)的服務(wù)并且寫(xiě)清楚它是演示環(huán)境、數(shù)據(jù)會(huì)被定期清理。3.3 快速開(kāi)始把能跑起來(lái)壓縮到最短路徑快速開(kāi)始是整份 README 里被閱讀次數(shù)最多、也最容易出問(wèn)題的一節(jié)。我的寫(xiě)法是嚴(yán)格分四步每一步都有明確的驗(yàn)證點(diǎn)。第一步環(huán)境要求寫(xiě)清楚運(yùn)行時(shí)版本、必要的系統(tǒng)工具、需要提前啟動(dòng)的外部服務(wù)。版本號(hào)要具體到主版本比如運(yùn)行時(shí) 18 及以上不要寫(xiě)最新版因?yàn)樽钚掳鏁?huì)隨時(shí)間漂移。第二步安裝命令要能直接復(fù)制粘貼執(zhí)行不要出現(xiàn)占位符混在命令里卻不說(shuō)明怎么替換。第三步最小示例用最小的輸入展示核心能力。第四步預(yù)期輸出把成功時(shí)應(yīng)該看到的內(nèi)容原樣貼出來(lái)。這四步里第四步是最容易被省略、也最能省事的用戶(hù)看到輸出和文檔一致心里就踏實(shí)了。注意快速開(kāi)始里的每條命令我都建議在一臺(tái)干凈環(huán)境或者全新容器里實(shí)測(cè)一遍而不是在自己已經(jīng)配置好的開(kāi)發(fā)機(jī)上跑通就算數(shù)。這兩者的差別往往就是新人卡住的地方。我自己的習(xí)慣是維護(hù)一個(gè)scripts/quickstart.sh把快速開(kāi)始里的命令原封不動(dòng)放進(jìn)去README 里既展示命令又提示可以一鍵執(zhí)行。這樣一來(lái)命令過(guò)期的問(wèn)題在 CI 里就能被發(fā)現(xiàn)比靠人肉記憶靠譜得多。3.4 配置項(xiàng)、目錄結(jié)構(gòu)與接口說(shuō)明怎么寫(xiě)配置項(xiàng)最容易寫(xiě)成流水賬。我的做法是統(tǒng)一用表格字段固定為名稱(chēng)、類(lèi)型、默認(rèn)值、是否必填、說(shuō)明。必填項(xiàng)要顯著標(biāo)記因?yàn)樾氯俗畛R?jiàn)的錯(cuò)誤就是漏配必填項(xiàng)導(dǎo)致啟動(dòng)失敗。說(shuō)明列寫(xiě)清楚單位比如超時(shí)時(shí)間是秒還是毫秒這種細(xì)節(jié)不寫(xiě)一定有人踩坑。字段名類(lèi)型默認(rèn)值是否必填說(shuō)明APP_PORT整數(shù)8080否服務(wù)監(jiān)聽(tīng)端口需保證未被占用DB_URL字符串無(wú)是數(shù)據(jù)庫(kù)連接串格式見(jiàn)示例配置CACHE_TTL整數(shù)60否緩存過(guò)期時(shí)間單位秒LOG_LEVEL字符串info否取值 debug、info、warn、error表格之外再配一份config.example.yaml把典型配置寫(xiě)全并加注釋。示例文件的好處是它可以被程序校驗(yàn)字段名寫(xiě)錯(cuò)會(huì)直接報(bào)錯(cuò)而 README 里的文字不會(huì)。我自己維護(hù)的項(xiàng)目里示例配置文件和配置解析代碼放在一起改代碼時(shí)順手就改了文件不容易脫節(jié)。目錄結(jié)構(gòu)說(shuō)明只寫(xiě)到第二層用注釋說(shuō)明每個(gè)目錄的職責(zé)。接口說(shuō)明則遵循最小可用示例原則一個(gè)接口給一段能直接運(yùn)行的調(diào)用代碼勝過(guò)十段接口簽名羅列。3.5 常見(jiàn)問(wèn)題與貢獻(xiàn)指南把重復(fù)回答沉淀下來(lái)常見(jiàn)問(wèn)題這一節(jié)的價(jià)值取決于你有沒(méi)有真的去回收問(wèn)題。我的做法是每周掃一遍收到的提問(wèn)和討論凡是同一類(lèi)問(wèn)題出現(xiàn)兩次以上就寫(xiě)進(jìn) README 的常見(jiàn)問(wèn)題里并附上具體操作。寫(xiě)的時(shí)候要用提問(wèn)者的原話(huà)作為標(biāo)題比如啟動(dòng)時(shí)報(bào)端口被占用怎么辦因?yàn)槿藗兪怯米约旱谋硎鋈ニ阉鞯?。貢獻(xiàn)指南如果只是復(fù)制一份通用模板其實(shí)沒(méi)什么用。真正有價(jià)值的是項(xiàng)目特有的約定分支怎么命名、提交信息什么格式、哪些目錄不要?jiǎng)印y(cè)試怎么跑、本地怎么驗(yàn)證。我見(jiàn)過(guò)一個(gè)項(xiàng)目明確寫(xiě)了修改解析邏輯必須同步更新 fixtures 下的樣例文件否則評(píng)審不會(huì)通過(guò)這一句話(huà)省掉了無(wú)數(shù)輪溝通。4. 實(shí)操?gòu)牧惆岩粋€(gè) README 打磨到可發(fā)布4.1 環(huán)境準(zhǔn)備與倉(cāng)庫(kù)初始化從零開(kāi)始的時(shí)候我建議先把骨架搭出來(lái)再補(bǔ)內(nèi)容不要一邊想結(jié)構(gòu)一邊填字。第一步是把倉(cāng)庫(kù)根目錄的基礎(chǔ)文件補(bǔ)齊包括 README、忽略規(guī)則文件、許可證、示例配置。目錄上我習(xí)慣把文檔放在docs/腳本放在scripts/示例配置放在倉(cāng)庫(kù)根目錄方便一眼看到。mkdir your-project cd your-project git init mkdir -p docs scripts touch README.md .gitignore LICENSE config.example.yaml git add . git commit -m chore: 初始化倉(cāng)庫(kù)結(jié)構(gòu)與文檔骨架這一步?jīng)]什么技術(shù)含量但它的意義在于讓文檔從第一天就參與版本管理。后面每一次改動(dòng)都能追溯誰(shuí)在什么時(shí)候把哪條命令改錯(cuò)了一查提交記錄就知道。我經(jīng)歷過(guò)一次團(tuán)隊(duì)協(xié)作因?yàn)?README 是后期補(bǔ)的沒(méi)人知道某條部署命令是誰(shuí)在什么背景下改的排查花了很久。.gitignore要提前寫(xiě)尤其是會(huì)生成緩存、日志、本地?cái)?shù)據(jù)文件的場(chǎng)景否則提交歷史里會(huì)混進(jìn)一堆無(wú)用文件刪起來(lái)很痛苦。4.2 快速開(kāi)始板塊的實(shí)測(cè)寫(xiě)法寫(xiě)快速開(kāi)始的時(shí)候我習(xí)慣先把命令在一個(gè)全新環(huán)境里跑一遍邊跑邊記錄然后把記錄整理成文檔而不是先寫(xiě)文檔再去驗(yàn)證。下面是我某次整理出來(lái)的寫(xiě)法結(jié)構(gòu)可以直接套用。# 1. 獲取代碼 git clone repo-url cd your-project # 2. 準(zhǔn)備依賴(lài)建議使用虛擬環(huán)境或版本管理工具 python -m venv .venv source .venv/bin/activate pip install -r requirements.txt # 3. 準(zhǔn)備配置 cp config.example.yaml config.yaml # 4. 啟動(dòng) python -m app.main --config config.yaml啟動(dòng)之后要給出預(yù)期輸出比如日志里應(yīng)該出現(xiàn)監(jiān)聽(tīng)端口和就緒標(biāo)志。這一步我一般這么寫(xiě)當(dāng)終端輸出server listening on 0.0.0.0:8080時(shí)表示啟動(dòng)成功此時(shí)訪(fǎng)問(wèn)http://localhost:8080/health應(yīng)返回{status:ok}。參數(shù)選擇上也有講究。端口為什么默認(rèn) 8080是因?yàn)檫@個(gè)端口在開(kāi)發(fā)環(huán)境里沖突概率相對(duì)低而且大部分人熟悉。緩存時(shí)間為什么默認(rèn) 60 秒是因?yàn)樵谶@個(gè)量級(jí)的業(yè)務(wù)里60 秒既能擋住突發(fā)重復(fù)請(qǐng)求又不會(huì)讓數(shù)據(jù)太陳舊。這些理由不一定要全寫(xiě)進(jìn) README但你心里得清楚因?yàn)橛脩?hù)改配置時(shí)問(wèn)起來(lái)答案就是文檔更新的素材。提示涉及版本號(hào)的地方盡量寫(xiě)成區(qū)間或最低版本例如運(yùn)行時(shí) 18 及以上避免寫(xiě)死一個(gè)精確版本否則下次升級(jí)就要改文檔改漏了就變成誤導(dǎo)。4.3 配置項(xiàng)與示例文件的具體寫(xiě)法示例配置文件我通常這么組織按功能分組每組之間空一行每個(gè)字段上面一行注釋說(shuō)明作用和單位。下面是一個(gè)簡(jiǎn)化版示例。# 服務(wù)配置 server: port: 8080 # 監(jiān)聽(tīng)端口 workers: 4 # 工作進(jìn)程數(shù)建議不超過(guò) CPU 核心數(shù) # 存儲(chǔ)配置 database: url: sqlite:///./data/app.db # 連接串生產(chǎn)環(huán)境請(qǐng)?zhí)鎿Q pool_size: 5 # 連接池大小 # 日志配置 log: level: info # 取值 debug、info、warn、error path: ./logs/app.log寫(xiě)完示例文件后我會(huì)做一次反向校驗(yàn)打開(kāi)配置解析代碼逐個(gè)字段對(duì)照看有沒(méi)有文檔里沒(méi)寫(xiě)、代碼里卻會(huì)讀的字段。這種隱藏配置項(xiàng)是最坑人的用戶(hù)改了半天發(fā)現(xiàn)還有個(gè)沒(méi)寫(xiě)進(jìn)文檔的必填字段。實(shí)測(cè)下來(lái)這種對(duì)照每做一次能提前消滅兩三個(gè)潛在提問(wèn)。工作進(jìn)程數(shù)這類(lèi)參數(shù)我會(huì)在注釋里給出經(jīng)驗(yàn)值比如建議不超過(guò) CPU 核心數(shù)但不會(huì)寫(xiě)死成固定數(shù)字。因?yàn)椴煌瑱C(jī)器的規(guī)格差異很大寫(xiě)死反而會(huì)誤導(dǎo)。4.4 發(fā)布前自查清單文檔寫(xiě)完到發(fā)布之間我會(huì)固定走一遍清單。這套動(dòng)作做熟了大概十分鐘能擋掉大部分低級(jí)問(wèn)題。檢查項(xiàng)判斷標(biāo)準(zhǔn)不通過(guò)的典型表現(xiàn)命令可復(fù)制逐條粘貼到終端能直接執(zhí)行命令里混著未說(shuō)明的占位符干凈環(huán)境可跑在全新環(huán)境按文檔走一遍能成功依賴(lài)本機(jī)已有配置才能跑預(yù)期輸出一致實(shí)際輸出與文檔描述一致輸出格式已改文檔未更新鏈接有效所有鏈接可訪(fǎng)問(wèn)指向已刪除的文檔或頁(yè)面版本信息準(zhǔn)確運(yùn)行時(shí)版本、依賴(lài)版本與代碼一致文檔寫(xiě) 16代碼要求 18配置字段齊全代碼讀取的字段都在文檔里存在未記錄的必填字段我最看重的是第二條和第六條。干凈環(huán)境能跑通說(shuō)明文檔是自洽的配置字段齊全說(shuō)明文檔和代碼沒(méi)有脫節(jié)。這兩條守住了其余問(wèn)題基本都是小毛病。5. 常見(jiàn)問(wèn)題與排查技巧實(shí)錄5.1 讀者跑不起來(lái)的幾類(lèi)根因復(fù)盤(pán)我處理過(guò)的照著 README 跑不通的問(wèn)題根因其實(shí)就那么幾類(lèi)而且和文檔質(zhì)量高度相關(guān)。第一類(lèi)是環(huán)境差異比如本地裝了多個(gè)運(yùn)行時(shí)版本README 沒(méi)寫(xiě)清楚要求用戶(hù)用舊版本執(zhí)行就報(bào)語(yǔ)法錯(cuò)誤。第二類(lèi)是隱式假設(shè)作者在自己機(jī)器上跑得好好的因?yàn)槟硞€(gè)目錄已經(jīng)存在、某個(gè)環(huán)境變量早就設(shè)好了文檔里完全沒(méi)提。第三類(lèi)是缺前置服務(wù)比如項(xiàng)目依賴(lài)數(shù)據(jù)庫(kù)或消息隊(duì)列文檔只說(shuō)啟動(dòng)服務(wù)沒(méi)說(shuō)這兩個(gè)得先起來(lái)。第四類(lèi)是外部資源缺失比如模型文件、樣例數(shù)據(jù)集、需要聯(lián)網(wǎng)下載的依賴(lài)文檔沒(méi)交代獲取方式。第五類(lèi)是路徑問(wèn)題命令里寫(xiě)的是相對(duì)路徑用戶(hù)換個(gè)目錄執(zhí)行就找不到文件。這五類(lèi)問(wèn)題我在自己的項(xiàng)目里都能對(duì)應(yīng)到具體的修訂記錄而且它們幾乎都能通過(guò)在干凈環(huán)境實(shí)測(cè)一遍提前發(fā)現(xiàn)。我還想強(qiáng)調(diào)一點(diǎn)用戶(hù)報(bào)跑不起來(lái)時(shí)提供的往往不是根因。他說(shuō)啟動(dòng)腳本報(bào)錯(cuò)實(shí)際可能是端口被占他說(shuō)依賴(lài)裝不上實(shí)際可能是鏡像源配置問(wèn)題。所以文檔里除了寫(xiě)正確路徑也值得寫(xiě)一句如果出現(xiàn)某類(lèi)報(bào)錯(cuò)通常是某某原因把常見(jiàn)岔路標(biāo)出來(lái)。5.2 癥狀、原因與處理速查下面這張表是我這些年攢下來(lái)的放在這里你可以直接對(duì)照排查。癥狀常見(jiàn)原因處理方式提示找不到模塊依賴(lài)未安裝或虛擬環(huán)境未激活確認(rèn)環(huán)境已激活重新安裝依賴(lài)端口被占用本機(jī)已有服務(wù)監(jiān)聽(tīng)同一端口換端口或停掉占用進(jìn)程配置文件報(bào)錯(cuò)缺少必填字段或格式錯(cuò)誤對(duì)照示例配置逐字段核對(duì)啟動(dòng)后立即退出日志級(jí)別過(guò)低看不到錯(cuò)誤調(diào)到 debug 級(jí)別重新啟動(dòng)數(shù)據(jù)為空未執(zhí)行初始化腳本按文檔執(zhí)行數(shù)據(jù)準(zhǔn)備步驟運(yùn)行結(jié)果與文檔不符版本不一致或參數(shù)不同核對(duì)版本號(hào)與參數(shù)配置這張表的用法是文檔里每個(gè)條目寫(xiě)成癥狀加處理不要展開(kāi)原理。原理可以在文檔站里單獨(dú)寫(xiě)一篇README 里保持簡(jiǎn)短讓人一眼掃到自己的情況。我自己的經(jīng)驗(yàn)是把這張表放在常見(jiàn)問(wèn)題開(kāi)頭能顯著減少重復(fù)提問(wèn)。有一次我把最常見(jiàn)的三條提到最前面兩周內(nèi)同類(lèi)提問(wèn)從十幾條降到兩三條投入產(chǎn)出比非常高。5.3 讓 README 不那么容易過(guò)期文檔過(guò)期是個(gè)必然趨勢(shì)能做的是讓它過(guò)期得慢一點(diǎn)、被發(fā)現(xiàn)得早一點(diǎn)。我用的辦法有三個(gè)。第一個(gè)是隨代碼改任何影響使用方式的改動(dòng)提交時(shí)順手改 README把這件事寫(xiě)進(jìn)評(píng)審清單里靠流程而不是靠自覺(jué)。第二個(gè)是可執(zhí)行化把文檔里的命令搬進(jìn)腳本讓 CI 去跑命令一旦失效立刻暴露不依賴(lài)人工檢查。第三個(gè)是定期實(shí)測(cè)我一般每個(gè)版本發(fā)布前用干凈環(huán)境把快速開(kāi)始走一遍把當(dāng)次發(fā)現(xiàn)的問(wèn)題一并改掉。這個(gè)動(dòng)作看起來(lái)笨但它能覆蓋很多自動(dòng)化檢查抓不到的問(wèn)題比如鏈接指向的頁(yè)面內(nèi)容已經(jīng)變了、截圖和實(shí)際界面不一致。還有一個(gè)經(jīng)驗(yàn)不要追求 README 覆蓋所有情況。它的目標(biāo)是讓絕大多數(shù)人順利開(kāi)始而不是解答所有邊緣問(wèn)題。把邊緣問(wèn)題引流到文檔站或者討論區(qū)README 才能長(zhǎng)期保持精簡(jiǎn)。我見(jiàn)過(guò)試圖把 README 寫(xiě)成百科的項(xiàng)目最后的結(jié)果是沒(méi)人維護(hù)、內(nèi)容全面過(guò)期反而傷害了信任度。6. 把 README 做得更耐讀的幾個(gè)工程化手段6.1 用輕量工具守住格式與鏈接格式和鏈接是 README 最容易出問(wèn)題的地方好在都有現(xiàn)成的小工具可以幫忙。格式檢查方面可以用 markdownlint 這類(lèi)工具在提交前跑一遍常見(jiàn)的標(biāo)題層級(jí)混亂、列表縮進(jìn)不一致、行尾多余空格都能自動(dòng)標(biāo)出來(lái)。鏈接檢查方面可以用 markdown-link-check 之類(lèi)的工具掃描所有鏈接把失效的挑出來(lái)。# 以 Node 生態(tài)為例安裝后在提交前或 CI 里執(zhí)行 npx markdownlint-cli2 **/*.md npx markdown-link-check ./README.md這兩個(gè)檢查我建議放進(jìn)提交鉤子或者持續(xù)集成流程里因?yàn)槿搜酆茈y在幾百行文檔里發(fā)現(xiàn)一個(gè)失效鏈接。鏈接失效通常不是你的錯(cuò)但對(duì)讀者來(lái)說(shuō)就是你的問(wèn)題所以定期掃一遍很有必要。目錄導(dǎo)航也可以自動(dòng)化。文檔長(zhǎng)了之后手動(dòng)維護(hù)目錄既麻煩又容易漏用工具根據(jù)標(biāo)題層級(jí)生成目錄每次改完標(biāo)題重新生成一次就行。這類(lèi)自動(dòng)化能省下的時(shí)間不算多但能避免目錄指向不存在的章節(jié)這種尷尬。6.2 把可執(zhí)行的步驟做成腳本前面提過(guò)把快速開(kāi)始的命令做成腳本這里展開(kāi)說(shuō)一下怎么組織。我的做法是在scripts/下放三個(gè)腳本環(huán)境準(zhǔn)備、數(shù)據(jù)準(zhǔn)備、啟動(dòng)。README 里既寫(xiě)出完整命令也提示可以用腳本一鍵執(zhí)行。# scripts/quickstart.sh 示意 set -euo pipefail python -m venv .venv source .venv/bin/activate pip install -r requirements.txt cp -n config.example.yaml config.yaml || true echo 環(huán)境準(zhǔn)備完成接下來(lái)執(zhí)行 scripts/run.sh 啟動(dòng)服務(wù)腳本比文檔有個(gè)天然優(yōu)勢(shì)它會(huì)真的被執(zhí)行壞掉就會(huì)報(bào)錯(cuò)。文檔不會(huì)報(bào)錯(cuò)只會(huì)安靜地誤導(dǎo)人。另外腳本里可以用set -euo pipefail讓任何一步失敗都立刻中斷用戶(hù)不用在滿(mǎn)屏日志里找哪一步出了問(wèn)題。有一點(diǎn)要注意腳本不要做太多聰明的事比如自動(dòng)修改系統(tǒng)配置、自動(dòng)安裝系統(tǒng)級(jí)依賴(lài)。這種操作在別人機(jī)器上風(fēng)險(xiǎn)很高容易引發(fā)反感。腳本的定位是把手工步驟串起來(lái)而不是替用戶(hù)做決定。6.3 多語(yǔ)言版本與文檔站的關(guān)系項(xiàng)目面向的使用者如果跨語(yǔ)言README 的多語(yǔ)言版本就值得考慮。我傾向的做法是根目錄保留主語(yǔ)言版本其余語(yǔ)言放在docs/下并在 README 頂部放切換入口。這樣既能覆蓋不同讀者又不會(huì)讓根目錄堆滿(mǎn)一堆 README 變體。需要提醒的是多語(yǔ)言版本最大的風(fēng)險(xiǎn)是不同步。主版本更新了其他語(yǔ)言版本還停在半年前讀者看到的內(nèi)容自相矛盾。我自己的處理方式是只在項(xiàng)目趨于穩(wěn)定、確實(shí)有跨語(yǔ)言需求時(shí)才引入多語(yǔ)言并且在文件頭標(biāo)注最后同步時(shí)間和對(duì)應(yīng)的主版本方便讀者判斷新鮮度。至于文檔站它和 README 并不是替代關(guān)系。README 是入口和最短路徑文檔站是深入內(nèi)容的容器。兩者之間用鏈接互相指路即可千萬(wàn)別想著把文檔站的內(nèi)容復(fù)制粘貼一份到 README 里那樣只會(huì)得到兩份都會(huì)過(guò)期的文檔。最后分享一點(diǎn)我自己的體會(huì)README 是我維護(hù)過(guò)的所有文檔里唯一一個(gè)會(huì)被反復(fù)打開(kāi)、反復(fù)引用的東西。代碼可以重構(gòu)架構(gòu)可以推翻但 README 的每一句話(huà)都可能在某個(gè)深夜被一個(gè)著急的人讀到。我在實(shí)際項(xiàng)目里養(yǎng)成的習(xí)慣是每次收到這個(gè)怎么用的提問(wèn)先不急著回答而是問(wèn)自己一句這句話(huà)應(yīng)該出現(xiàn)在 README 的哪個(gè)位置?;卮鹜赀@個(gè)問(wèn)題答案往往順手就寫(xiě)進(jìn)文檔了下次同樣的提問(wèn)也就不會(huì)再出現(xiàn)。
返回列表
PREV
查看更多資訊
NEXT
返回資訊列表
激情综合五月| 亚洲成人av中文| 中文字幕不卡+婷婷五月| 激情五月天综合网| 九九色影院| 婷婷五月花| 99九九综合久久九九| 日本99在线视频| wWW九九在线播放| 婷婷色激情五月天| 狼友超碰| 色色国产| 婷婷丁香五月激情中文字幕版| 思思久久99| 大香蕉久久伊人婷婷五月丁香| 九九av| 久久激情五月| 艳妇野外情欲放荡HD| 五月丁香婷色| 伊人综合婷婷| 中文字幕在线日亚州9| 天天做天天爱天天摸| 婷婷色在线| 欧洲激情五月天婷婷| 俺去也婷婷| 亚洲色域网| 精品九九九久| 激情婷婷丁香五月天| 一逼色综合| 精品久久久人妻| 99热这里有精品6| 丁香五月激情啪啪| 五月婷婷五月天在线| 国产日韩av片| 97在线观视频免费观看| 国产综合婷婷| www.com操| 色碰97| 婷婷五月激情网| 婷婷丁香在线| 五月色亭丁香| 亚洲色网络| 丁香五月综合在线| 五月天久久www| 激情五月婷婷五月| 丁香六月亭亭久久综合| 亚洲精品国产成人AV在线| 婷婷五月激情综合| 开心婷婷五月| 俺五月| 性爱七区| 熟女人妻一区二区三区免费看| 五月丁香无码| 视频这里只有精品| 亚州色综合| 丁香久久| 激情综合网五月天| 国产丁香五月天婷婷| 欧美碰碰| 99视频| 任你操精品免费| 俺也去在线久久精品23欧美综合视频网站,丰满人妻一区二区三区在线视频53,丰满 | 婷婷综合网| 五月天基地| 日本久久视频| 久久33视频| 亚洲九区| 狠狠的日| 新精品99| 蜜桃婷婷丁香五月天狠狠久久综合| #NAME?| 伊人久久婷婷| www.婷婷五月| 精品一区二区三区木瓜| 婷婷五月天堂网| 亚洲岛国电影| 图片区 小说区 区 亚洲五月| 亚洲无码色| 深爱激情五月天色婷婷| 九九色影视| 激情五月婷婷色色| 操大屄五月天视频| 九九热免费视频| 五月激情影院| 99成人免费热视频| 婷婷五月天激情综合网| 五月婷婷视频啪啪美女| 色色色色热热| 99热老网站| 中文字幕欧美精品久久| 亚洲激情四射色| 狠狠色婷婷| 夜夜干 夜夜操| 欧美色骚婷婷五月天| 五月丁香婷草| 激情av在线| 香蕉人妻AV久久久久天天| www色五月| 天天草天天日| 五月天亚洲最大成人| 9精品视频在线| 五月天久久色| 精品香蕉99久久久久网站| av在线免费播放| 人人爱人人摸人人澡| 五月天快乐开心激情网| 操操操www.com| 99热天堂| 日本系列_4页_777FP| 日韩人妻在线播放| 五月婷婷性爱网| 国产欧美熟妇另类久久久| 久久丁香五月婷婷| 婷婷综合激情| 综合色五月| 婷婷久久精品| 天堂久久婷婷| 亚洲AV综合网| 91色在线/日韩| 狠狠五月天| 五月婷婷伊人久久| 性生活视频98791| 成人色情五月天婷婷丁香| 亚洲啪视频| 激情久久久久久| 黄色一极大片| 丁香婷婷五月激情| 99久热这里只有精品| 婷婷五月天视频亚洲| 婷婷五月天亚洲综合网| 99er久久| 亚洲综合五月天婷婷| 中文国产五月天| 人妻久久久久久久久妻久久久久| 影音先锋人妻出差| rr天天操| 五月天丁香网站| 生活片五区| 九九99香蕉在线视频播放| 五月天激情小说欧美激情| 亚洲五月婷天天操| 伊人AV五月婷| 超碰爱爱爱| 九九热精品视频在线观看| 国产精品美女| 亚州色婷婷| 婷婷色在线观看| 99操视频| 五月婷婷久久内射| 毛片色五月| 很很干天天干| 91精品久久久久久综合五月天| 超碰激情网| 色综合色色色| 99燥99日| www.久久久久久久久久久| 停停六月 综合| 中文av在线观看| 综合色影院| 熟女激情网| 久久欧洲久久| 婷婷激情丁香六月| 亚洲最大在线| 欧美顶级少妇做爰HD| 欧美三9久九观看| 九色1区视频在线| 人人叉久| 热九九在线| 五月花成人网| 五月综合在线| 成人在线日韩| 丁香五月天亚洲综合| 九色激情网| 另类图片色五月| 5月色婷婷| 五月婷婷九| 99热这里只有精品热| 天天日日天天| 亚洲99在线| 思思热在线播放| 中国女人做爰A片| 大香蕉视频婷婷| 天天操五月天| 欧美婷婷五月激情| 射久久丁香五月| 丁香六月亚洲| 狠狠草在线观看| 99久久99九九99九九九| 91大操| 1区2区视频| 五月丁香| 五月亚洲| 亚洲最大成人综合网720P| 激情五月天福利| 激情五月天色网站| 九九精品网| 91热爆在线| 欧美三级巜人妻互换| 高清国产AV| 香蕉婷婷色五月| 五月情婷婷| www.国产色| 中文字幕成人版| 五月婷婷啪啪啪| 5月婷婷激情6月| 天天日天天插| AA片在线观看视频在线播放| 玖玖婷婷色| 蜜臀A∨在线水帘洞| 狠狠激情五月天| 91丨九色丨国产打屁股| se色综合网| 性色播| 99爱在线精品视频免费观看| 国产69久久久欧美黑人A片| 五月丁香婷婷激情四射迷人| 九九草热在线观看| 五月丁香在线观看| 超碰成人av| 婷婷丁香五月噜噜噜| 久久五月网| 色播五月| 国产精品久久久久久久久久免费| 99热啪啪| 久草性爱| 99日视频在线| 这里只有精品网站| 91.www综合| 综合另类视频| 五月天激情网站| 桃色五月婷婷| 草AV9999| 亚洲视频在线观看| 精品国产va久久久久| 99综合| 成人精品视频99在线观看免费| 丁香婷婷色五月天| 99久久五月丁香野外| 久热无码| 五月婷婷之婷婷| 九九色影院| 51精品国自产在线| 一区二区成人电影| 日韩在线五月天婷婷| www久久久久久久97| 久热久| 激情五月小说婷婷| 国产精品在线视频| 182TV亚洲| 激情五月婷婷| 97色干| 超碰九九热| W色综合| 亚洲精99| 色五月婷婷在线| 伊人婷婷综合| 六月色五月天天婷婷| 色色网91| 91呦呦呦| 538在线精品| 婷婷五月激情中文字幕| 天天擼久久擼在线| 99这里只有免费的精品| 色综合久久44| 丁香视频| 久久婷婷电影| 91爱操| 一级操逼内射在线视频| αV电影| a久久免费视频| 九九色婷| 99re热视频| ww超碰在线| 激情五月婷婷老师| 久99久在线| 久久综合九色综合88i| 狠狠色激情综合| 99在线爽| 婷婷丁香高潮了| 丁香激情网| 99色色热| 最近中文字幕2019视频1| 思思热闹这里只有精品| 国产精品久久久久久久久久| 亚洲性色XXXXX| 一本色道久久88加勒比| 五月婷婷自拍| 婷婷色中文| 激情综合网址| 婷婷五月激情热播| av高清无码| 五月激情综合五月| 亚洲色频| www久久久| 色五月天综合网| 亚洲午夜电影| 天天综合精品| 欧美婷婷五月天综合| 亚洲AV影片在线观看| 先锋男人99资源| 婷婷丁香九色| 日本颜色视频人人爱| 婷婷综合在线网| 色色射| 91在线看免费 九九九九| 激情丁香五月婷婷| 亚洲视频a| 熟女人妻一区二区三区免费看| 伊人天天色| 日本www免费九九| 免费不卡狠操美女视频网| 五月婷婷导航| 成人片在线播放| 五月婷婷网久久| JlZZJlZZ8JlZZ亚洲熟女| 色五月婷婷很很操| 永久无码色| 99国产精品白浆在线观看免费 | 亚洲综合1024| 欧美叉叉叉BBB网站| 另类激情网| 五月天操逼网| 双性美人被调教到喷水A片| 婷婷亚洲欧美丁香五月| 色色五月天激情| 成人无码精品1区2区3区免费看| 5月婷婷激情6月| www.激情五月天.com| 五月停停999| 九九热只有精品6| 琪琪色网址| 五月婷婷综合久久| 五月天成人在线| 国产操肏网站| 成人中文网| 色五月婷婷五月| 婷婷激情五月| 中文字幕无码成人电影| 欧洲色| 婷婷五月天狠狠搞干| 日韩色色视频| 五月天婷婷中文字幕在线播放| AV成人在线播放| 天天射影院| 五月丁香偷拍| 狠狠操天天日| 伊人网欧美在线男人天堂五月丁香 | 99欧州偷拍视频| 五月天婷婷久色| 9久久AV| 嫩草AV久久伊人妇女超级A | 国产干逼片| 香蕉综合在线| 婷婷五月天精品| 96人人操人人操人人| 中文字幕天天干| 五月天婷婷综合网| 激情久久五月天| www.激情五月天| 超碰99在线| 亚洲区1| 丁香五月av| 五月丁香五月综合欧美| 色情免费视频播放| 欧日韩AV| 五月婷色| 最新色色五月天| 亚州男人天堂婷婷五月| 91碰碰| 久久久99免费视频| 五月婷婷中文字幕| A久网| 五月婷婷色播视频| 免费黄色片子| 国产精品日日躁夜夜躁| 色爱综合五月| 激情五月婷婷综合| 婷婷五月激情片| 九月久久婷婷| 亚洲精品无码A片一区二区| 五月天婷婷色综合| 久久ww| 五月天久久综合婷婷| 互月天综合| 秋霞三级影视资源| 9er热在线精品视频| www.99久久久久99| 日本9区视频| 激情内射人妻1区2区3区| 综合激情站| 婷婷五月色色| WWW.99视频| 五月天国产婷婷精品视频在线| 天天干夜夜b| 久婷婷五月激情| 五月婷婷激情综合| 亚洲操人| 婷婷综合| 亚洲另类婷婷五月丁香在线播放| 色播五月婷婷| 久久这里只有精品5| 激情综合色婷婷啪啪六月天| 亚洲另类毛片| 殴美日韩成人| 14色综合婷婷| 永久免费视频| 丁香婷婷基地| 永久无码色| 99色色网| 丁香五月香蕉在线| 天天综合色丁香| 天天艹天天综合网| 五月婷婷综合热| 九九这里只有精品在线视频| 99免费视频久久| 91蜜桃婷婷狠狠久久综合9色| 婷婷五月丁香啪啪| 婷婷色婷婷亚洲成人| 婷婷六月激情| 色五月婷婷婷婷婷婷婷婷婷婷| 精品成人久久久久久久_一二三四视| 久久免费操| 97干欧美| 六月婷婷五月丁香首页| 99在线观看视频精品| 另类图片天天影视在线观看| 五月综合激情久久| 丁香五月天激情综合网| 中文乱子伦视频| 色99在线视频| 丁香六月啪啪啪| 超碰在线成人| 丁香网站| 强奸幻女毛片| 99狠狠色| 免费的日逼视频| tingting五月天亚洲| 5月丁香综合网| 五月天狠狠干| 26uuu亚洲| 99九九在线视频| av在线资源| 九九色精品| 丁香香蕉射射射| 1024在线视频| 粉嫩av懂色av蜜臀av熟妇| 天天插天天玩天天干| 亚洲综合色网站| 热99这里只有精品视频| 精品丁香五月天在线播放| 91色逼| 五月丁香婷婷综合| 激情六月婷婷啪啪| 香蕉视频91| 九九热亚洲中文在线观看免费| 天天综合天天做天天综合| 精品51XX| 婷婷五月综合社区| 另类在线| 第1影院之五月婷婷| 99噜噜| 五月天天天操天天爽夜夜操| 九月丁香五月婷婷| 九九综合| 亚洲婷婷性爱| 婷婷久久久久| 亚洲中文乱字字幕线在永久| 六月婷婷久久| 日本欧美成人片AAAA| 欧美高潮9| 中文资源在线a | 天天色情站| 丁香97综合| 日韩操人| 激情五月色播五月| 大香蕉啪啪啪| 成人毛片在线免费观看| 五月深爱婷婷| 狼人狠狠操| 大地9中文在线观看免费高清| 五月婷婷av在线| 欧美精品啪啪| 亚洲开心激情网| 亚洲综合五月天婷婷丁香| 五月婷婷大香蕉| 色站9/| 天天爽天天爽天天爽天天爽天天爽| 久久性爱视频这里只有精品| 色色性爱视频| 久操人| 99 热国产在| 五月丁香花婷婷玉莉AV| 思思热在线| 91九色成人原创视频| 狠狠色五月激情| 久久婷婷视频| 先锋影音男人的天堂AV| 操操操www.com| 99爱在线视频| 操日本99| 婷婷丁香午夜综合影视| 久久色情| 婷婷五月丁香超碰| 激情小说 五月天| 五月婷婷开心网| 色五月,婷婷大香蕉| 婷婷区日本| 青青草原亚洲天堂| 东京热免费视频网站| 视频这里只有精品16| 香蕉操亚洲| 99热草草| 先锋男人99资源| 久久草大香蕉| 九九热99视频在线| 色婷婷五月天在线观看| 狠狠色综合久久久久| 99在线观看视频精品| 日本欧美国产| 亚洲精品网址| 久久人妻伦理| 久久曰9| 天天噜天天爱| 久久曰曰| 日本精品在线噜噜噜| 99操免费视频| 久久精品噜噜噜成人A∨色欲| 26UUU精品一区二区Com| 亚洲妇女熟BBW| 色五月综合网| 另类图片天天影视在线观看| 欧美日韩中国| 亚洲九九在线| 国产免费性爱| 亚洲日韩26uuu| 婷婷综合在线| 二人电影免费版在线观看| 91九色精品女同系列| 色婷婷91| 色99热| 夜色综合网| 激情五月婷婷五月| 噜噜狠狠色综合久| 狼友超碰| 丁香五月婷婷AV| 五月综合激情| 91九色首页| 99在线播放视频| 91婷婷搞| 色婷婷AAA| 99爱99操| 综合五月婷婷| 97亚洲色 torrent magnet| 在线视频你懂得| 婷婷午夜精品久久久| 亚洲av日韩无码| 91丨九色丨熟女| 亚洲综合五月天婷婷丁香| 大香蕉人在线65| 婷婷99狠狠| 97五月久久丁香婷婷| 丁香五月激情综合| 久久久www| 婷婷性爱| 九九热这里精品| 性做久久久久久久免费看| 激情婷婷综合| 激情 久久 婷婷| 婷婷五月丁香网| 婷婷中文网站| 亚洲九九视频| 最新AV在线观看| 五月天,激情四射,婷婷频道| 性色av大香综合| 国产97色在线 | 日韩| 五月天婷婷操逼视频| 综合久| 婷婷激情伍月网| 香蕉AV福利精品导航| 婷婷天天综合| 黄色毛片精品| 久久9视频| WWW色综合| 日韩黄在免| 欧美va在线| 操操自拍| 99精品在线| 97久久超视频| 久久999久久999久久999久久| 五月丁香久久呀| 泰州成人视频| 婷婷五月天综合色| 99碰网站| 丰满少妇猛烈A片免费看观看| 亚洲激情网站| 久久精品9| 9久热| 五月丁香婷庭在线| 一本久道综合99| 91综合在线| 久久视频这里99| 99网址在线看| ..真实国产乱子伦对白在线_欧| 26UUU在线观看| ...婷婷五月综合不卡,国产在线手机| 久热99| 久久这里99| 五月开心久久| 欧美大片| 成人电影AV在线观看| 99精品在线播放| 无码人妻精品一区二区蜜桃色欲| 婷婷五月天无码| 色播五月丁香| 六月综合在线| 五月天婷五月天综合网小说首页-五月天激激婷婷大综合,婷婷亚洲综合五月天小说 | 久久多色| 五月婷婷久久网| 色狠狠综合入口| 九九热视频在线观看| 激情五月天小说|五月天开心激情网|亚洲精品国产自在现线|黄色五月天 | 久99视频在线观看| 六月丁香激情婷婷| 玖玖在线视频| 九月丁香八月婷婷久久综合久97| 可以免费观看的av| 射区导航| 婷婷五月天美女视频| 亚州色婷婷| 影音先锋日本三级资源| 色综合久久888| 色婷婷狠狠干芒果TV| 色色婷| 大香人妻| 欧美成人AAA片一区国产精品| 色在线99| 亚洲欧州色情在线观看| 丁香女人五月天| 久久丁香婷婷五月| 久久五月天激情| 丁香五月激情啪啪| 夜夜撸天天操| 日操五月婷| 黄色五月婷婷| 亚洲免费电影2| 久久er99热精品一区二区| 五月婷婷偷拍| 99热这里只有精品3| 丁香六月 人妻| 久久九区| 婷婷久久五月| 激情六月丁| 另类小说五月天综合网| 99久久婷婷国产综合精品草原| 操操操91| 超碰2021| 国产性av| 男女啪啪做爰高潮无遮挡| 中文字幕综合网| 亚洲热综合| 中文不卡一二区| 激情欧美婷五月| 这里只有精品亚洲| 99热综合网| 婷婷五月激情小说| seav天堂| 99热在线观看| 99热久久这里只有精品| 久久人妻视频| www.国产色| 色噜噜狠狠色综合网| 五月激情婷婷丁香天堂| 懂色AⅤ| 草婷婷在线| 日本色婷婷综合| 丁香六月色香蕉视频| 欧美性猛交99久久久99| 激情亭亭五月| 婷婷五月六月丁香| 超级碰91| 色婷婷五月天无码视频| 激情五月天情色| 九月停停| 极品少妇婷婷五月| 久久性爱激情| 六月婷在线| 91久久国产综合久久| 青青999| 久久九九经典| www久久久久| 亚洲色色五月| 91岛国片| 丁香久久综合| 在线成人网址| 九九色中文| 深爱激情中文五月天av| 婷丁五月| 91视屏在线观看com.wwwvv| 丁香五月婷婷久久综合激情网| 91色久| 99综合视频在线| 最近免费中文字幕大全高清大全1| www.minyis.com【JT】实力收量可预付QQ2101460746 | 亚洲视频五区| 五月丁香婷婷基地| 日本99视频| 国产又色又爽又黄又免费| 成人中文网| 色六月 婷婷| 六月丁香婷婷爱| 色婷婷五月综合色婷婷| av线电影| 色吧综合网| 夜夜躁狠狠 | 色玖玖综合| 色婷婷婷婷| 精品国产va久久久久| 狠狠另类视频| 丁香五月欧美激情| 久久99热这里只有精品| 久久婷婷综合网| 任你艹| 亚洲爆乳无码精品AAA片蜜桃| 婷婷五月花| 激情五月婷色| 影音先锋一区二区三区| 久久激情综合| 亚洲色色香蕉| 99久久婷| 国产成人精品一区二三区熟女在线| 五月激情四射网站| 美国不卡视频| 人人爽天天莫| 丁香色五月婷婷91桃色| 色99色| 成年人丁香五月| 中文字幕日本最新乱码视频| 婷婷久久婷婷| 日本a片网址| 婷婷色情小说| 99玖玖免费视频| 丁香六月综合激情| 日本综合九九| 日本久久人人| 婷婷激情六月综合| 天天爽天天摸天天爱| 9l视频自拍9l视频自拍九色学生| 亚洲色五月| 国产欧美大香蕉一区| 五月成人网站| 五月婷A V在线| 激情久久 婷婷| 色波激情五月天| 黄色AAAAA| 91丁香五月| 人妻熟人中文字幕一区二区| 99视频久久久| 人人爱天天摸摸天天爱| 日日操天天操| 99在线精品免费视频| 久久丁香婷婷五月| 97丁香花五月天激情小说| 可以免费看AV网站| 六月激情婷婷| 亚洲在线播放| 亚洲激情亚洲激情 | 六月丁花香啪啪激情欧美| 色婷婷色情| 蜜乳国产网站| 婷婷天天色| 久久久久久久,99精品视频| 99热99色| 色婷婷亚洲精品天天综| 五月婷婷五月天| 欧美日韩国产伦精品日韩人妻一| 天天天天天操| 午夜成人AV在线| chaopeng在线人人| 色综合久久五月| 无码动漫av| 综合 激情 婷婷| 色色99| 噜噜狠狠色| 亚洲字幕AV一区二区三区四区| 葵花AV在线| 久久婷出差欧美色两性综合网| 婷婷六月啪啪| 欧美午夜乱妇午夜福利| 亚州精品色情无码A片| 久久精品视频在这里有| 欧美丰满熟妇BBB久久久| 91视频精品99| 99re这里只有精品视频了| 九九综合久久| 久久婷婷色| 久久人妻乱| 色青青电影色五月| 欧美va视频不用播放器的va视频网| 九九無妻| 久久ri精品视频| WWW色五月天| 91婷婷丁香| 91九色白丝| 婷婷丁香综合网| 日韩无码专区| 午夜丁香综合婷婷| 婷婷五月激情四射手| 丁香五月天色| 99热精品在线观看| 天堂色婷婷| 欧美成人色婷婷| 丰满少妇猛烈A片免费看观看| www,8050,午夜三级| 亚洲综合视频网| 五月婷丁香久久综合| 天天干天天色天天干| 超碰v| 开心久久xxx色| 欧美日韩91| A1片久久久| 天天碰夜夜爽| 99精彩视频在线观看| 天天影视色综合网| 超碰国产在线播放| 狠狠狠狠狠狠狠狠草| 黄桃AV无码免费一区二区三区| 日本怕怕视频| 九九热视频这里只有精品| 国产激情AV| 欧洲不卡视频| 91avse| 99日本黄站| 五月婷婷天堂| 91seav| 9|无码久久久久久| 一级二级色大片| 国产精品国产| 女人天堂AV| 六月婷色| 日韩久热| 激情AV| 99热这里只有精品免费| 99久久66| 国产欧美熟妇另类久久久| 国产日日夜夜操| 久热九九| 五月综合在线婷婷图片| 日韩在线观看网址| 色五月视频,小说| 九热av| 综合久久99| 婷婷丁香五月天影院| 狠狠五月天| 伊人久久中文网| 日本色爽| 五月丁香啪啪综合网| 色吧综合网| 日日夜夜狠狠婷婷色| 亚洲视频一区| 丁香五月av在线| 五月婷婷亚洲综合在线| 色五月婷婷综合| 七七九色| 青青草成人网| 五月婷婷色在线| 夜夜做夜夜愛| 伊人玖玖综合| 久久电影4399| 99热色无码| 97碰碰碰免费公开在线视频| 日本激情五月天‘| 美腿丝袜AV天堂网| 黄网在线免费观看| 亚洲 精品 综合 精品| 五月丁香本色在线观看| 色色亚洲五月天| 久久久宗合| 丁香五月婷婷基地| 五月丁香六月情婷婷久久| 久久九九一區| 99热97| 激情四射五月天| 久久精品一区二区三区四区| 亚洲色无码| 毛片新网地| 五月婷婷六月色| 丁香六月无码| 国产精品国产| www.超碰在线| 天天干天天日日| 丁香香蕉婷婷| 色色色色色色色色网站| 婷婷丁香五月精品| 五月丁香婷婷狠狠操| 免费播放片大片| 琪琪秋霞| 色天堂操| 婷婷91| 另类激情五月天| 日本熟妇精品99| 日韩在线看AV| 日韩人妻无码精品| 色婷婷六月综合| 国产综合久久久777777| 六月婷婷五月丁香| 亭亭五月色男人| 综合色色网| 亚洲色无码A片一区二区麻豆| 伊人狼人干| 99精彩视频网站在线| 亞洲自怕| 99碰网站| 天天情天天狠天天透| 人妻操逼| 婷婷性福五月天| 超碰久热| 国产精品久久久久久亚洲毛片| 一级操逼内射在线视频| 99操| 色色草97| 狠狠色婷婷777| 婷婷五月天激情免费在线观看| 色九区| 丁香六月亚洲| 超碰99在线观看| 无码视频国内精品久久久| 欧美精品啪啪| 日韩乱玛久久| 激情网战码亚洲A| 操逼综合网| 欧美久热| 91久久九久久九久久九久久九久久| 色情丁香五月天| 五月婷啪| 91色欲综合| 精品人妻伦九区久久AAA片| 香蕉婷婷色五月| 九色色| 深情六月婷婷综合久久| 亚洲视频久久| 最近中文字幕大全免费版在线 | 自拍偷窥99热| 亚洲激情综合免费| 丁香五月婷婷呀| 日本三级日本三级99| 久热精品在看| 久热伊人91| 久久久GOGO无码啪啪艺术| 天天做天天爽| 99热这里只有精品最新地址获取| 五月天婷婷午夜丁香| www.婷婷.com| 色色热日| 超碰人妻公开在线| 久久婷婷亚洲| 丁香五月性| 99九九视频精彩在线| 色婷婷影音| peg 2区三区四区的| 激情AV在线| 色碰干| 久久丁香综合香蕉| 综合五月婷婷| 欧美色99| www热久久yy9| 国产婷婷五月色情综合| 99免费视频精品| 天天噜天天爱| 91一起操| 91婷婷搞| 丁香五月AV| 色综合色婷色基地| 97操碰免费视频| 婷婷五月天淫荡| 婷婷五月天基地| 激情综合色| 丁香婷婷色| 久久视频婷婷| 99热思思| 99热精品中文字幕| 婷婷五月情天| 欧美色色色色色色色| 99精品网站| 淫荡综合网| 久久五月婷天天干| 米奇影视资源婷婷狠狠色激情欧美五月丁香 | 久99久在线| 五月婷婷狠狠干| 成人电影AV在线观看| 婷婷午夜天| 五月天激情www| 五月天综合在线观看| 99精品视频免费观看,| 91久久久久久| 婷婷四色五月| 无码se| 深爱婷婷基地| anquye伊人| 久久亚洲色导航| 激情综合网,五月| 天干天天干天天天天天| 综合婷婷六月| 亚洲综合网激情五月天| 丁香五月天欧美成人| 激情六| 亚洲激情免费久久| 五月丁香六月婷婷中合网| 婷色成人| 国产Va视频| 婷婷舔| 色婷婷狠狠色| 97丁香五月| 色五月亚洲| 五月婷婷丁香大陆免费| 影音先锋四区| 亚洲男女激情| 狠狠穞A片一區二區三區| 内射爽无广熟女亚洲| 欧美婷婷| 色噜噜狠狠色综无码久久合欧美| 少妇伦子伦精品无吗| 久操乱| 伊大人久久| 午夜福利8055| 久久狼人天堂| aaa丁香五月天| 99在线爽| 丁香六月视频免费观看| 天天骑天天操| 精品人人操| 国产67194| 色吧婷婷五月亚洲| 色婷婷另类| 1024婷婷综合久久五月天| 五月丁香花激情综合网| 亚洲在线操| 色婷婷视频| 99热12| 五月丁香婷草| 婷婷五月在线观看| 婷婷大香焦| 最新日韩久热免费视频看看| 九九色婷婷| 六月婷五月丁香| 五月婷婷色激情| 综合久久9| h在线看免费版在线看| 九月停停| 九九操操| 五月丁香在线婷婷蜜桃| 婷婷五月天激情基地| 色五月婷婷在线| 日本人妻伦在线中文字幕| 日美三级| 久久婷婷五月综合| 天天热夜夜操| 91九色国产在线| 五月天婷婷基地| 青青草原爱爱网| 九九色色| 欧美草久久五月天91| 网色99| 久久99最新地址| 亚洲综合视频网| www.粉嫩av.com| 丁香六月激情综合啪啪| 超碰在线观看99| 激情综合网激情五月俺也去| 色情久久久| 成人AV在线网站| 婷婷激情人妻| 大香蕉久久青青| 人妻激情综合| 激情小说之五月| 91精品久久久久久77777| 综合福利网| 97精品综合久久| 深爱丁香激情| www.婷婷六月天| A片天天| 精品久热| 色婷婷视频在线| www超碰| 亚洲AV无码影院| 五月丁香好婷婷姑娘综合网| 能看的av| 国产麻豆视频| 中文字幕永久在线| 色色色色色色色色网站| 亚洲精品色| 国产成人高清| 五月婷婷中字在线| 成人免费在线电影| 日本综合99| 色婷婷九月| 亚洲热视频在线| 亚洲亚洲人成综合网络| 综合网狠狠| 婷婷五月婷婷五月天| 永久精品| 激情图片久久| 战争与艾拉电影免费观看| 99色色视频| 精品九九婷婷| 丁香5月啪啪| 五月天色不卡| 日本人人干| 99视频只有这里精品| 精品久久久久成人码免费动漫| 狠狠干综合| 色色五月天丁香| 久久综合色五月| 五月激情五月婷婷五月天在线| av国产精品| 婷婷久久五月| AV大香蕉| 女同激情久久av久久| 婷婷五月色情| 色停停影院五月天| 九九色视频| 91色久| 亚洲永久四色| 久热黄色| 青青草原伊人网| 久久人妻伦理| seuuu婷婷| 久久五月丁香综合17C| 日韩人妻无码专区| 日韩AV在线免费观看| 人人爱国产| 69天堂99| 先锋av性爱成人电影| 国产美女无遮挡裸体毛片A片| 日韩在线视频中文字幕| 99色视频| 亚洲无码性爱| 色婷婷欧美在线| www狠狠| 综合久久久| 五月天天天色| 丁香五月婷婷激情蜜桃| 婷婷丁香五月天亚洲| 99精品成人无码A片观看金桔| 亚洲国产婷婷色五月| 爱射综合| 五月开心久久| 丁香激情网| 狠狠色丁香久久婷婷综合五月| 久久一热| 黄色aa观看aaguochan| 播五月丁香六月| 91男人资源站| 99久久玖玖| 9色免费网| 狠狠插日日干撸| 久久久99精品免费观看| www.久久五月天.com| 色色热| 99热这是里只有精品| 99性爱视频| 五月激情综合激情五月| 天天射影院| 色五月婷婷视频| 久久久一级AAA| 亚洲久热无码| 亚洲成人综合网在线免费观看| 色综合综合色| 日韩久久日| 噜噜视频| 色婷婷啪啪啪啪啪啪| 超碰人人超碰| 久久天堂| 亚洲乱码在线观看| 色婷婷狠狠爱| 超碰在线国产| 开心五月丁香综合久久| 国产亚洲精品久久久久久久久动漫| 情婷婷五月天在线| 91 九色大美女| 九九久久视频| 97人人操com| 超碰网站在线观看| 国产.亚洲.欧洲视频在线| 色婷婷久久久| 色五月天天在线观看资源站| 99在线精品视频| 这里只有精9| 色婷婷六月| 亚洲精品大片| 97在线刺激| 亚洲激情久久| 婷婷色色综合激情| 五月丁香天天| 婷婷伊人综合| 婷婷色综合| 色婷婷丁香网| 99热最新国内| 婷婷人人操| 欧美va亚洲va| 亚洲天堂AV综合网| 久久婷五月婷| 丁香五月天天日| 牛牛色av| 久热这里只有精品6| 丁香六月婷婷色XXXX| 一起草aV| 久久婷婷热| 日本VA视频| 9 99免费视频| 亚洲妇女熟BBW| 99热色精品| 天天做综合| 色五月成人| 开心丁五月| 五月丁香六月婷婷综合| 天天干天天做| 婷婷丁香综合| 国产亚洲在线| 亚洲色频| 99久久网站| 天天婷婷色六月| 成人深爱丁香五月| 色综合av超碰| 另类小说色婷婷| 欧洲亚洲精品| 99热国产国产| www.9797国产| 色五月婷婷在线| 日本天天色| 日日鲁鲁夜夜爽爽| 成人欧美日韩| 《亚洲操B久久免费在线观看,亚洲操B久久在线播放》在线播放 - 高清资源 - 97 | 婷婷色五月婷婷姐妹| 色欲色香综合网| 五月综合色播播丁香婷婷| 妇激情基地| 五月天婷婷丁香成人网| 九月婷婷| 激情综合五| 开心五月婷婷激情网| 亚洲午夜电影| 国模九区| 婷婷天堂站| 综合一区二区三区| 五月天伊人日日噜影片AV| 亚洲区视频| 伊人大蕉香| 激情内射人妻1区2区3区| 99九九视频精彩在线| 天天干、天天日日| WWW,色五月| 综合99久久天天综合| 午夜无码熟熟妇丰满人妻 | 久久这里有精品在线观看| 五月婷婷大香蕉| 婷婷五月综合色中文字幕| 日日操夜夜擼| 五月丁香综合啪啪| 日韩色色视频| 日本熟女一区二区| 亚洲激情无码久久| 99riAV国产精品视频| 免费成人中文字幕| 五月精品99综合| 性一交一乱一交A片久| 色婷操逼|