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

ARTICLE DETAIL

資訊詳情

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

從零自研T3技術(shù)棧腳手架:t3code的工程化實(shí)踐與踩坑記錄

從零自研T3技術(shù)棧腳手架:t3code的工程化實(shí)踐與踩坑記錄 1. 項(xiàng)目緣起放著現(xiàn)成腳手架不用我為什么自己寫了 t3code大概半年前我開始動(dòng)手寫 t3code 這個(gè)項(xiàng)目——一個(gè)基于 T3 技術(shù)棧TypeScript、Tailwind CSS、tRPC 加 Next.js的項(xiàng)目腳手架生成工具。起因特別簡(jiǎn)單團(tuán)隊(duì)里新項(xiàng)目初始化太慢每次手動(dòng)補(bǔ)齊的內(nèi)容都一模一樣重復(fù)勞動(dòng)多了人就容易產(chǎn)生干脆寫個(gè)工具把這事自動(dòng)化的沖動(dòng)。t3code 這個(gè)名字沒花什么心思T3 棧加 code 生成器拆開念就是 t3-code順手就在 npm 上搜了一下沒有重名直接發(fā)布。1.1 從 T3 技術(shù)棧說起先給不熟悉的讀者簡(jiǎn)單交代一下背景。T3 技術(shù)棧是這幾年在 React 全棧開發(fā)里很流行的一套組合TypeScript 提供類型安全Tailwind CSS 負(fù)責(zé)樣式tRPC 讓你在不寫 REST 接口文檔的情況下實(shí)現(xiàn)前后端類型共享應(yīng)用框架用的是 Next.js。這個(gè)組合最大的好處是端到端類型安全——你改一個(gè)后端返回字段的類型前端編輯器里立刻就能報(bào)錯(cuò)不用等聯(lián)調(diào)。我第一次用 create-t3-app 拉起項(xiàng)目的時(shí)候體驗(yàn)確實(shí)很好幾分鐘就能得到一個(gè)帶完整 tRPC 鏈路和 Tailwind 樣板的工程。但用得多了問題就浮出來了。create-t3-app 是大眾的腳手架它的默認(rèn)配置面向最通用的場(chǎng)景而團(tuán)隊(duì)工程實(shí)踐一旦有自己的約定這套默認(rèn)配置就不夠用了。我們團(tuán)隊(duì)的要求包括每個(gè)新項(xiàng)目必須帶 docs 目錄、必須用 pnpm 而不是 npm、ESLint 必須開 import 排序規(guī)則、依賴要鎖定精確版本號(hào)、必須包含 .env.example 模板、CI 腳本要用統(tǒng)一的 Node 版本。這些約定說多不多說少不少每次初始化完 create-t3-app 都要手動(dòng)改一遍改完還要手動(dòng)建目錄、拷公共工具函數(shù)。一次兩次能忍十次二十次就非常煩躁了。我還見過更糟的情況有同事初始化完項(xiàng)目以后忘了補(bǔ) .env.example直接把帶真實(shí)數(shù)據(jù)庫連接串的配置提交到了倉庫雖然最后及時(shí)改了回來但這種風(fēng)險(xiǎn)不應(yīng)該靠人的記憶力去兜底。所以我的核心訴求非常清楚要把團(tuán)隊(duì)自己的工程約定固化成一個(gè)可復(fù)現(xiàn)的腳本讓新建一個(gè)符合團(tuán)隊(duì)規(guī)范的 T3 項(xiàng)目從半小時(shí)縮減到兩分鐘。t3code 就是在這個(gè)背景下誕生的。1.2 現(xiàn)成腳手架的三個(gè)痛點(diǎn)在決定自研之前我把市面上能找的腳手架都過了一遍包括 create-t3-app、create-next-app、各種社區(qū)模板倉庫。它們的痛點(diǎn)歸納起來有三個(gè)。第一模板不可定制或定制成本高。create-t3-app 雖然提供了不少配置選項(xiàng)但它不開放模板機(jī)制你想加自己的 CI 腳本、自己的工具函數(shù)目錄只能生成之后手動(dòng)改。社區(qū)模板倉庫倒是可以 fork但 fork 之后每次上游更新都要手動(dòng)合并追版本追得心累。第二團(tuán)隊(duì)約定無法沉淀。腳手架工具本質(zhì)上是工程經(jīng)驗(yàn)的載體但現(xiàn)成工具承載的是作者的工程經(jīng)驗(yàn)不是你的。團(tuán)隊(duì)里的目錄規(guī)范、代碼風(fēng)格、提交規(guī)范、環(huán)境變量管理方式這些只有自己人最清楚指望一個(gè)社區(qū)工具替你管理根本不現(xiàn)實(shí)。第三生成產(chǎn)物黑盒。很多腳手架生成完之后用戶對(duì)項(xiàng)目里每一份文件的出處一無所知。出了問題只能整個(gè)刪掉重建沒辦法針對(duì)性地修某一處模板邏輯。對(duì)于需要長期維護(hù)的團(tuán)隊(duì)工程基線來說這不是小事。1.3 我想要的工程化基線因此我給 t3code 定下的目標(biāo)很明確它不是一個(gè)通用的代碼生成器而是團(tuán)隊(duì)工程化基線的一個(gè)載體。具體要做到四件事——交互收集參數(shù)、拷貝模板文件、渲染動(dòng)態(tài)內(nèi)容、執(zhí)行收尾動(dòng)作。后面所有設(shè)計(jì)決策都是圍繞這四件事展開的。范圍定小了復(fù)雜度自然就下來了核心邏輯加起來不到一千行剩下全是模板代碼。這篇文章會(huì)把設(shè)計(jì)思路、核心實(shí)現(xiàn)和踩坑記錄完整寫出來。如果你在團(tuán)隊(duì)里做前端基建或者想給自己的團(tuán)隊(duì)落地一套內(nèi)部腳手架又或者只是好奇一個(gè) CLI 工具是怎么從零做出來的應(yīng)該都能從中找到一些可以復(fù)用的經(jīng)驗(yàn)。內(nèi)容不需要多高深Node.js 基礎(chǔ)加一點(diǎn)模板引擎知識(shí)就能看懂。2. 整體設(shè)計(jì)思路腳手架工具要解決的四個(gè)問題2.1 先想清楚t3code 不是什么比它是什么更重要?jiǎng)邮种拔易龅淖钪匾囊患率墙o自己劃界線。t3code 不是低代碼平臺(tái)不是代碼生成器更不是要替代 create-t3-app 的通用方案。它就是項(xiàng)目初始化加速器把創(chuàng)建項(xiàng)目過程中的重復(fù)勞動(dòng)壓縮成一條命令。這個(gè)定位聽起來簡(jiǎn)單但它直接影響后面每一個(gè)設(shè)計(jì)選擇范圍不擴(kuò)大復(fù)雜度就可控模板只在團(tuán)隊(duì)內(nèi)部用就不需要做復(fù)雜的遠(yuǎn)程拉取用戶都是有經(jīng)驗(yàn)的開發(fā)者就不需要做圖形化界面。明確了定位之后核心功能就清晰了。t3code 做的事包括四件第一交互收集參數(shù)包括項(xiàng)目名、包名、是否啟用 CI、是否初始化 Git、選擇哪個(gè)業(yè)務(wù)模板第二拷貝模板文件把內(nèi)置模板目錄完整復(fù)制到目標(biāo)目錄第三渲染動(dòng)態(tài)內(nèi)容把項(xiàng)目名、版本號(hào)、npm registry 地址等變量替換進(jìn)模板文件第四執(zhí)行收尾動(dòng)作自動(dòng)安裝依賴、初始化 Git、打印啟動(dòng)命令。這四件事每一件拆開都不復(fù)雜但組合起來加上各種邊緣情況的處理就是完整的工具了。我見過不少腳手架工具交互做得很花哨結(jié)果復(fù)制文件時(shí)不處理隱藏文件、不處理 .gitignore生成出來的項(xiàng)目根本不是用戶預(yù)期的樣子。所以 t3code 從第一天起就刻意保持小體積小到核心邏輯出了問題能一眼定位。2.2 技術(shù)選型為什么是 Node.js Commander而不是 Go、Rust 或 Shell選型這件事我糾結(jié)過兩天。做一個(gè)腳手架工具擺面前有幾條路。第一條是用 Go 或 Rust 寫編譯型二進(jìn)制優(yōu)點(diǎn)是沒有運(yùn)行時(shí)依賴、啟動(dòng)速度快可以做成一條命令直接放在任意機(jī)器上跑但缺點(diǎn)是模板分發(fā)麻煩模板如果打包進(jìn)二進(jìn)制那么每改一次模板就要重新編譯團(tuán)隊(duì)里非 Go 開發(fā)者想貢獻(xiàn)模板要先裝工具鏈這門檻對(duì)前端團(tuán)隊(duì)來說太高了。第二條路是寫 Shell 腳本。簡(jiǎn)單場(chǎng)景下 Shell 完全夠用比如 mkdir、cp、sed 一把梭。但只要涉及到交互式問答、跨平臺(tái)路徑處理、JSON 變量替換、錯(cuò)誤重試這些操作Shell 很快就會(huì)變成一團(tuán)亂麻。尤其是 macOS 的 zsh 和 Linux 的 bash 行為還有差異Windows 更是直接勸退。第三條路是用 Node.js 寫一個(gè) npm 包類型的 CLI這也是我最終的選擇。原因很實(shí)際團(tuán)隊(duì)里前端工程師人人都有 Node 環(huán)境npx t3code 一條命令就能跑起來模板直接打包在 npm 包里發(fā)布新模板就是發(fā)一個(gè)新版本包。模板文件對(duì)前端工程師來說是純文本改起來沒有任何額外學(xué)習(xí)成本。Node.js 生態(tài)里 Commander、Inquirer、execa、Handlebars 這些庫都是久經(jīng)考驗(yàn)的完全不用重新造輪子。最終 t3code 的依賴清單如下commander命令行參數(shù)解析。inquirer交互式問答。handlebars模板渲染。execa子進(jìn)程執(zhí)行安裝依賴、git 命令。fs-extra遞歸拷貝和文件操作。每個(gè)庫都放在自己最擅長的位置上。commander 負(fù)責(zé)參數(shù)inquirer 負(fù)責(zé)問答handlebars 負(fù)責(zé)渲染execa 負(fù)責(zé)外部命令fs-extra 負(fù)責(zé)文件系統(tǒng)操作。依賴雖然不少但沒有一個(gè)是可有可無的。2.3 模板目錄結(jié)構(gòu)約定優(yōu)于配置配置優(yōu)于代碼t3code 的模板不是簡(jiǎn)單的一堆文件它有明確的兩層結(jié)構(gòu)。第一層是項(xiàng)目級(jí)模板比如 next-trpc、next-plain、library每個(gè)模板對(duì)應(yīng)一類項(xiàng)目形態(tài)第二層是模板內(nèi)部的可選區(qū)塊比如某個(gè)模板里可以選擇是否生成 GitHub Actions 工作流、是否生成 Dockerfile。這么設(shè)計(jì)是為了讓按需生成成為可能同時(shí)不讓這種靈活性泛濫成災(zāi)。模板目錄的結(jié)構(gòu)大致是這樣的templates/ ├── next-trpc/ │ ├── base/ │ │ ├── .env.example │ │ ├── .eslintrc.cjs │ │ ├── package.json.j2 │ │ ├── tsconfig.json │ │ ├── next.config.mjs │ │ ├── src/ │ │ └── README.md.j2 │ ├── optional/ │ │ ├── ci-github/ │ │ ├── docker/ │ │ └── monorepo/ │ └── manifest.json ├── next-plain/ └── library/base 目錄下的文件是必選內(nèi)容optional 目錄下都是可選的增量文件。manifest.json 聲明了這個(gè)模板支持哪些可選區(qū)塊、哪些文件需要渲染、默認(rèn)推薦選項(xiàng)是什么。模板里以 .j2 結(jié)尾的文件表示需要經(jīng)過 Handlebars 渲染其他文件一律原樣拷貝。這個(gè)約定的好處是模板作者一眼就能看出哪些文件會(huì)被動(dòng)態(tài)處理哪些不會(huì)。模板即代碼是我在這個(gè)項(xiàng)目里最堅(jiān)持的原則。業(yè)務(wù)方想加一段自定義配置不需要改 t3code 的源碼只需要在 templates 目錄下新增一個(gè) optional 區(qū)塊然后更新 manifest.json 的描述文案。后來我們團(tuán)隊(duì)干脆把模板倉庫單獨(dú)拆了出去通過 git submodule 的方式在發(fā)版本時(shí)同步進(jìn)主倉庫模板的維護(hù)和 CLI 代碼的維護(hù)徹底解耦。這一步讓我體會(huì)到模板結(jié)構(gòu)設(shè)計(jì)得清晰很多后續(xù)的流程問題都會(huì)自動(dòng)消失。3. 核心實(shí)現(xiàn)拆解從用戶輸入到項(xiàng)目落地的完整鏈路3.1 入口命令與參數(shù)解析t3code 的命令入口是 package.json 的 bin 字段指向的 JS 文件。我用 Commander 定義了三個(gè)子命令init 是交互式創(chuàng)建項(xiàng)目list 列出所有可用模板doctor 檢查當(dāng)前環(huán)境是否滿足生成條件。三個(gè)命令各有定位init 是日常主力list 讓用戶知道有哪些選擇doctor 則是排障專用的環(huán)境有問題時(shí)先跑一下它。下面貼 init 命令的解析邏輯這是整個(gè)工具的主入口#!/usr/bin/env node const { Command } require(commander); const program new Command(); program .name(t3code) .description(T3 技術(shù)棧項(xiàng)目腳手架生成器) .version(1.4.2); program .command(init) .description(初始化一個(gè) T3 項(xiàng)目) .argument([projectName], 項(xiàng)目目錄名稱例如 my-app) .option(-t, --template name, 指定模板例如 next-trpc) .option(--no-git, 跳過 git init) .option(--no-install, 跳過依賴安裝) .option(-r, --registry url, 指定 npm registry 地址) .action((projectName, options) { runInit(projectName, options).catch((err) { console.error([t3code] 初始化失敗:, err.message); process.exit(1); }); }); program.parse(process.argv);Commander 的 argument 和 option 分離得很清晰。項(xiàng)目名是位置參數(shù)可以寫在命令后面模板、registry 等是選項(xiàng)參數(shù)用短橫線語法傳。這里我考慮過要不要加一個(gè) --yes 參數(shù)跳過所有交互直接使用默認(rèn)值后來決定不支持。原因是我見過太多腳手架默認(rèn)值藏在文檔里用戶完全不知道自己在用什么。t3code 面向的是有一定經(jīng)驗(yàn)的開發(fā)者把關(guān)鍵選項(xiàng)問清楚比快速跳過重要得多。3.2 交互式問答把決策放在用戶眼前把校驗(yàn)做在輸入之前如果用戶沒有在命令行里指定項(xiàng)目名或模板init 流程就會(huì)進(jìn)入 Inquirer 的問答環(huán)節(jié)。我把問答分成兩層第一層是項(xiàng)目基本信息第二層是根據(jù) manifest.json 動(dòng)態(tài)生成的可選區(qū)塊問題。第一層的問題非常直接但校驗(yàn)必須嚴(yán)格。比如項(xiàng)目名的校驗(yàn)const basicQuestions [ { type: input, name: projectName, message: 項(xiàng)目目錄名稱:, validate: (input) { if (!input.trim()) return 項(xiàng)目名不能為空; if (!/^[a-z0-9-]$/.test(input)) return 只能包含小寫字母、數(shù)字和中劃線; return true; }, }, { type: input, name: packageName, message: npm 包名默認(rèn)與項(xiàng)目名一致:, default: (answers) answers.projectName, validate: (input) { if (!/^[a-z0-9-]$/.test(input)) return 包名只能包含小寫字母、數(shù)字和中劃線; return true; }, }, ];這個(gè)校驗(yàn)規(guī)則是我踩坑踩出來的。第一版只做了非空校驗(yàn)結(jié)果有同事輸入了中文項(xiàng)目名后面生成的 next.config.mjs 直接被 Node.js 解析報(bào)錯(cuò)還得手動(dòng)改一堆文件名。從那之后所有用戶輸入都必須過規(guī)則校驗(yàn)。寧可在 prompt 階段多問一遍也不要在生成之后返工。正則限定得嚴(yán)一點(diǎn)沒有壞處因?yàn)轫?xiàng)目名和包名都會(huì)進(jìn)入后續(xù)的模板變量一旦出現(xiàn)非法字符問題往往不止一處。第二層問題來自模板的 manifest.json。比如模板聲明了 ci-github 這個(gè)可選區(qū)塊init 流程就會(huì)自動(dòng)生成一個(gè)確認(rèn)類型的問題是否生成 GitHub Actions 工作流。這層邏輯雖然只用了幾行代碼但它的意義在于模板能力擴(kuò)展不再需要修改代碼只要改 manifest.json交互層就是通用的。3.3 模板渲染為什么選 Handlebars而不是字符串拼接模板渲染是整個(gè)工具的技術(shù)核心。最初我想過最簡(jiǎn)單的方式在模板里寫PROJECT_NAME之類的占位符然后用字符串 replace 替換成實(shí)際值。這個(gè)方案實(shí)現(xiàn)最快但有一個(gè)致命問題——如果配置內(nèi)容需要根據(jù)用戶選項(xiàng)條件性地出現(xiàn)字符串拼接就完全無力了。舉個(gè)例子package.json 里如果用戶選擇了 Docker 區(qū)塊scripts 里就要多一個(gè) docker:build 命令如果選擇了 CI 區(qū)塊devDependencies 里就要多幾個(gè)包。用字符串拼接去組織這些條件邏輯代碼會(huì)迅速腐爛。所以我改用 Handlebars。它有三個(gè)好處語法簡(jiǎn)單模板作者不需要學(xué)一門新語言原生支持 #if 條件判斷和 #each 循環(huán)覆蓋了我 99% 的需求有完整的轉(zhuǎn)義機(jī)制不會(huì)出現(xiàn)模板變量破壞 JSON 格式的問題。下面是一個(gè)真實(shí)模板片段來自 next-trpc 模板的 package.json.j2{ name: {{packageName}}, version: 0.1.0, scripts: { dev: next dev, build: next build, start: next start, lint: next lint, {{#if withDocker}} docker:build: docker build -t {{projectName}}:latest ., {{/if}} typecheck: tsc --noEmit }, devDependencies: { typescript: ^5.4.0, tailwindcss: ^3.4.0, eslint: ^8.57.0, eslint-config-next: ^14.1.0, {{#if withCI}} changesets/cli: ^2.27.0, {{/if}} eslint-plugin-tailwindcss: ^0.5.0 } }渲染的時(shí)候把前面收集到的所有答案整理成一個(gè)大的 context 對(duì)象傳給 Handlebars 編譯之后的函數(shù)const Handlebars require(handlebars); const context { projectName: my-app, packageName: my-app, withDocker: true, withCI: false, author: your-name, registry: https://registry.npmjs.org, }; const source await fs.readFile(templateFile, utf-8); const render Handlebars.compile(source); const output render(context);這里有一個(gè)我從實(shí)際使用中總結(jié)出來的關(guān)鍵經(jīng)驗(yàn)?zāi)0逦募彩?.json 結(jié)尾的渲染完成之后必須通過 JSON.parse 校驗(yàn)才能落盤。因?yàn)?Handlebars 的 #if 塊如果縮進(jìn)或者逗號(hào)位置處理不當(dāng)很容易在 JSON 文件里多出一個(gè)逗號(hào)或者少一個(gè)閉合括號(hào)。我在 renderFile 函數(shù)里加了一個(gè)鉤子如果源文件擴(kuò)展名是 .json渲染結(jié)果必須 JSON.parse 成功否則直接報(bào)錯(cuò)并且把渲染結(jié)果連同原始模板一起打印出來。這個(gè)鉤子幫我攔下了很多模板編寫不規(guī)范的問題。3.4 文件落盤與目錄創(chuàng)建最容易翻車的環(huán)節(jié)渲染完成之后就該寫文件了。這個(gè)環(huán)節(jié)看起來最沒有技術(shù)含量實(shí)際上最容易翻車。我用 fs-extra 的 copy 方法先把模板目錄完整復(fù)制到目標(biāo)目錄然后逐文件處理渲染。注意順序很重要先復(fù)制再渲染可以保證非模板文件比如圖片、字體、二進(jìn)制文件也能被原樣帶上如果先渲染再復(fù)制二進(jìn)制文件可能會(huì)在讀寫過程中損壞。核心代碼如下const fse require(fs-extra); await fse.copy(templateBaseDir, targetDir, { filter: (src) !src.includes(node_modules), }); // 遍歷目標(biāo)目錄渲染所有 .j2 結(jié)尾的文件 const files await findAllJ2Files(targetDir); for (const file of files) { const rendered await renderTemplateFile(file, context); const outputPath file.replace(/\.j2$/, ); await fse.outputFile(outputPath, rendered); await fse.remove(file); }有幾個(gè)細(xì)節(jié)必須強(qiáng)調(diào)。第一遍歷文件時(shí)要用 fs.readdir 的 withFileTypes 參數(shù)判斷目錄類型不能用簡(jiǎn)單的字符串包含判斷否則遇到名字里帶點(diǎn)的目錄比如 .next、.github會(huì)誤判成文件。第二隱藏文件在 copy 階段是正常處理的但如果你選了某些第三方復(fù)制庫要確認(rèn)它的過濾邏輯不會(huì)把隱藏文件丟掉。第三目標(biāo)目錄如果已經(jīng)存在且非空init 命令應(yīng)該直接拒絕執(zhí)行必須加一個(gè) --force 選項(xiàng)才能覆蓋。這個(gè)保護(hù)非常重要我因?yàn)樵缙谕藢戇@個(gè)檢查曾經(jīng)把同事一個(gè)正在開發(fā)的目錄直接覆蓋了。項(xiàng)目內(nèi)容沒丟但那次經(jīng)歷絕對(duì)不想再來一次。3.5 依賴安裝與 Git 初始化外部命令的靜默陷阱文件生成完畢最后一步是安裝依賴和初始化 Git。這里我用了 execa 而不是 Node.js 自帶的 child_process.exec原因是 execa 對(duì) Windows 的支持更好還支持超時(shí)時(shí)間和 stdio 模式設(shè)置。以下是依賴安裝和 Git 初始化的代碼const execa require(execa); async function installDependencies(targetDir, { registry }) { const args [install]; if (registry) { args.push(--registry, registry); } const subprocess execa(npm, args, { cwd: targetDir, stdio: inherit, timeout: 120000, }); try { await subprocess; } catch (err) { throw new Error(依賴安裝失敗: ${err.message}); } } async function initGit(targetDir) { if (!(await fse.exists(path.join(targetDir, .git)))) { await execa(git, [init, -b, main], { cwd: targetDir }); await execa(git, [add, .], { cwd: targetDir }); await execa(git, [commit, -m, chore: init project via t3code], { cwd: targetDir, }).catch(() { // 如果用戶全局 git 配置不全缺 name/emailcommit 會(huì)失敗 // 這里不做強(qiáng)制只留下提示 console.warn([t3code] 自動(dòng) commit 失敗請(qǐng)檢查 git 用戶配置); }); } }git init 之后要不要自動(dòng) commit我猶豫過。自動(dòng) commit 的好處是用戶拿到的是一個(gè)干凈的工作區(qū)可以直接開新分支寫代碼壞處是如果用戶的全局 git 配置不全commit 失敗會(huì)中斷整個(gè)流程。后來我做了容錯(cuò)處理commit 失敗只打印警告不阻塞流程。同時(shí)用戶也可以用 --no-git 完全跳過 Git 相關(guān)操作。依賴安裝這里我特意保留了 stdio: inherit讓 npm 的安裝日志直接打到終端上。有些腳手架喜歡把安裝過程藏起來只顯示一個(gè) spinner但實(shí)際經(jīng)驗(yàn)是安裝卡住的時(shí)候用戶最需要原始進(jìn)度信息。寧可輸出丑一點(diǎn)也要讓用戶知道它到底卡在哪一步。npm install 超過兩分鐘超時(shí)之后錯(cuò)誤信息會(huì)包含具體命令的完整輸出這比安裝失敗四個(gè)字有用得多。4. 實(shí)測(cè)過程從一條命令到完整可用的 T3 項(xiàng)目4.1 完整跑一遍 t3code init我拿一臺(tái)配置干凈的新電腦做了一次完整實(shí)測(cè)確保從空目錄到項(xiàng)目跑起來沒有斷點(diǎn)。執(zhí)行命令npx t3code init my-app -t next-trpc由于指定了模板交互問答會(huì)自動(dòng)跳過模板選擇剩下的問題只有四個(gè)npm 包名、是否生成 Dockerfile、是否生成 CI 工作流、是否自動(dòng)執(zhí)行依賴安裝和 git init。這四個(gè)問題的默認(rèn)值我都做了認(rèn)真設(shè)計(jì)包名默認(rèn)等于項(xiàng)目名Dockerfile 默認(rèn)不生成CI 默認(rèn)生成安裝和 git init 默認(rèn)執(zhí)行。默認(rèn)值的選取原則是多數(shù)場(chǎng)景下不需要改而不是保守選項(xiàng)避免出錯(cuò)。選擇完成之后大概過了一分多鐘大部分時(shí)間是 npm install 在跑。等命令結(jié)束我用 tree 命令看了一眼生成的項(xiàng)目結(jié)構(gòu)my-app/ ├── .env.example ├── .eslintrc.cjs ├── .github/workflows/ci.yml ├── .gitignore ├── README.md ├── next.config.mjs ├── package.json ├── pnpm-lock.yaml ├── postcss.config.cjs ├── tailwind.config.ts ├── tsconfig.json └── src/ ├── app/ │ ├── api/trpc/[trpc]/route.ts │ ├── layout.tsx │ ├── page.tsx │ └── globals.css ├── server/api/root.ts ├── server/api/routers/post.ts ├── trpc/react.tsx └── trpc/server.ts然后執(zhí)行 npm run dev本機(jī) 3000 端口直接起了一個(gè)帶有 tRPC 完整鏈路的 Next.js 項(xiàng)目。從 React 組件到后端路由全類型安全新項(xiàng)目的第一個(gè) commit 就已經(jīng)是一個(gè)可以開發(fā)的起點(diǎn)。整個(gè)流程走完我的感受是工具的價(jià)值不在于它生成了多少文件而在于它把想清楚再動(dòng)手這件事變成了默認(rèn)行為。新項(xiàng)目一創(chuàng)建目錄規(guī)范、命名規(guī)范、環(huán)境變量管理、CI 檢查全部就位。4.2 驗(yàn)證生成內(nèi)容的核心鏈路類型和 CI 都要真的能跑光能跑起來還不算數(shù)我特意做了兩件驗(yàn)證工作。第一件是驗(yàn)證端到端類型安全是否真的成立。我在 src/trpc/react.tsx 里調(diào)用 useQuery 獲取數(shù)據(jù)然后故意把服務(wù)端 router 返回的字段類型改掉編輯器里立刻出現(xiàn)了類型錯(cuò)誤。這說明 tRPC 的端到端類型推斷在生成的樣板工程里是通的。這個(gè)驗(yàn)證很重要因?yàn)?t3code 的核心賣點(diǎn)之一就是類型安全如果模板里某個(gè)配置文件版本不匹配導(dǎo)致類型推斷斷裂整個(gè)項(xiàng)目的開發(fā)體驗(yàn)會(huì)大打折扣。第二件是驗(yàn)證 CI 腳本能真正跑通。我把生成出來的 .github/workflows/ci.yml 放進(jìn)一個(gè) GitHub 倉庫里觸發(fā)了一次流水線確認(rèn) lint、typecheck、build 三個(gè)步驟都能通過并且用的是模板里鎖定的 Node 版本。這兩項(xiàng)驗(yàn)證幫我發(fā)現(xiàn)了一個(gè)暗處的問題模板里 .env.example 的 DATABASE_URL 用的是本地 localhost 默認(rèn)值但 CI 環(huán)境里根本沒有這個(gè)數(shù)據(jù)庫所以 CI 腳本里所有依賴數(shù)據(jù)庫的步驟我都提前加上了注釋用戶需要按自己的實(shí)際情況調(diào)整。這個(gè)問題不算是 bug但它體現(xiàn)了模板作者該有的自覺——模板里必須留下足夠的注釋明確告訴使用者哪些地方必須改。4.3 參數(shù)化細(xì)節(jié)版本號(hào)為什么要統(tǒng)一管理生成出來的 package.json 里依賴版本號(hào)是精確鎖定的。這個(gè)決策當(dāng)時(shí)有同事反對(duì)覺得應(yīng)該用 latest 或者 ^ 前綴讓 npm 自動(dòng)解析到最新版。我堅(jiān)持用精確版本號(hào)原因很簡(jiǎn)單腳手架生成的項(xiàng)目是團(tuán)隊(duì)的長期基線如果每次生成都拉到最新版某天某個(gè)依賴升級(jí)引入了 breaking change所有新項(xiàng)目同時(shí)中招問題定位成本會(huì)非常高。精確鎖定版本讓升級(jí)這件事發(fā)生在可控的時(shí)間點(diǎn)比自動(dòng)最新穩(wěn)定得多。為此我在模板引擎里做了一個(gè)擴(kuò)展context 里注入一個(gè) versions 對(duì)象所有依賴版本都從一份統(tǒng)一的 versions.json 讀取。每次升級(jí)基礎(chǔ)依賴只需要改 versions.json 然后發(fā)布一個(gè)新版 t3code不用在一堆模板文件里翻找版本號(hào)。這是單一數(shù)據(jù)源原則在腳手架里的實(shí)際落地它保證了團(tuán)隊(duì)所有新項(xiàng)目用的基礎(chǔ)依賴版本完全一致不會(huì)出現(xiàn)張三的新項(xiàng)目用 React 18李四的新項(xiàng)目還在用 React 17 這種混亂情況。{ next: 14.1.0, react: 18.2.0, react-dom: 18.2.0, trpc/server: 10.45.0, trpc/client: 10.45.0, trpc/react-query: 10.45.0, trpc/next: 10.45.0, typescript: 5.4.0, tailwindcss: 3.4.1 }模板里引用版本號(hào)時(shí)寫成這樣{ dependencies: { next: {{versions.next}}, react: {{versions.react}}, trpc/server: {{versions.trpc-server}} } }versions.json 里的 key 和模板里的引用并不是靠約定來保證一致的我加了一個(gè)配套的單元測(cè)試模板文件里出現(xiàn)的所有 versions.xxx 引用必須在 versions.json 里有對(duì)應(yīng)定義否則測(cè)試直接失敗。這個(gè)測(cè)試是我踩了一次大坑之后才補(bǔ)上的。有一次我刪掉了某個(gè)不再需要的依賴版本定義但忘了模板里還在引用發(fā)布出去的版本生成的項(xiàng)目依賴直接失效排查了很久才定位到是版本錯(cuò)配。從那以后凡是模板和數(shù)據(jù)源之間的引用關(guān)系一律用自動(dòng)化測(cè)試兜底不再靠人肉記憶。5. 常見問題與排查技巧實(shí)錄5.1 模板渲染后 JSON 格式被破壞這是 t3code 用戶反饋?zhàn)疃嗟囊活悊栴}。Handlebars 的 #if 塊在 JSON 文件里非常脆弱只要縮進(jìn)或者逗號(hào)位置不對(duì)渲染結(jié)果就是非法 JSON。舉一個(gè)真實(shí)例子。某個(gè)用戶自定義模板里寫了這樣的片段{ scripts: { dev: next dev, {{#if withE2E}} e2e: playwright test, {{/if}} build: next build } }如果 withE2E 為 false渲染結(jié)果會(huì)保留一個(gè)多余的空行JSON.parse 不一定失敗但可讀性很差。真正致命的是另一種寫法——把逗號(hào)放在 #if 塊前面{ scripts: { dev: next dev, {{#if withE2E}} e2e: playwright test {{/if}} } }當(dāng) withE2E 為 false 時(shí)dev: next dev, 后面直接跟著一個(gè) }這就是非法 JSON。解決這個(gè)問題最穩(wěn)妥的方式是要求模板作者遵守一條約定任何可能被 #if 移除的條目它的前導(dǎo)逗號(hào)必須寫在 #if 塊內(nèi)部而不是寫在塊外面。我把這條約定寫進(jìn)了文檔同時(shí)保留了 JSON.parse 校驗(yàn)鉤子。雙保險(xiǎn)下來這類問題基本絕跡了。5.2 Windows 兼容性三個(gè)高頻雷區(qū)我平時(shí)的主力開發(fā)機(jī)是 macOS但團(tuán)隊(duì)里 Windows 同事不少。t3code 早期版本在 Windows 上的問題集中出現(xiàn)在三處。第一是路徑分隔符。生成出來的某些配置需要寫路徑比如 Dockerfile 里的 COPY 命令。早期代碼直接用了 path.join 拼接路徑在 Windows 上會(huì)生成反斜杠Dockerfile 解析直接失敗。后來所有寫進(jìn)模板的路徑統(tǒng)一使用正斜杠只有真正操作文件系統(tǒng)的路徑才用 path.sep。第二是換行符。模板文件在 Windows 上被 Git 檢出后變成 CRLF渲染出來的文件也是 CRLF。Linux 容器或者 shell 腳本對(duì) CRLF 非常敏感會(huì)報(bào)一些莫名其妙的錯(cuò)誤。我在工具里加了一個(gè) lineEnding 配置項(xiàng)默認(rèn)按模板文件本身的行尾處理但允許用戶統(tǒng)一轉(zhuǎn)為 lf。第三是外部命令的調(diào)用方式。在 Windows 上通過 Node.js 調(diào)用 npm.cmd 這類文件時(shí)execa 是安全的但如果直接用 child_process.exec 并且開啟了 shell 選項(xiàng)很容易被路徑里的空格或特殊字符坑到。統(tǒng)一走 execa 之后這類問題基本不再出現(xiàn)。5.3 依賴安裝超時(shí)和內(nèi)網(wǎng)源問題生成項(xiàng)目之后的第一道坎往往就是 npm install。網(wǎng)絡(luò)環(huán)境不穩(wěn)定的時(shí)候安裝一個(gè)中等規(guī)模的項(xiàng)目動(dòng)輒幾十秒超過默認(rèn)超時(shí)時(shí)間就會(huì)失敗。t3code 把超時(shí)做成了可配置項(xiàng)同時(shí)在 init 命令里提供了一個(gè) -r 參數(shù)直接指定 npm registry。這個(gè)參數(shù)很實(shí)用比如在受限網(wǎng)絡(luò)環(huán)境下用戶可以傳一個(gè)鏡像地址不用去改全局 .npmrc。還有一個(gè)容易被忽略的細(xì)節(jié)如果用戶已經(jīng)配置了 .npmrc 里的 registryexeca 啟動(dòng) npm 時(shí)會(huì)自動(dòng)讀到這個(gè)配置。這個(gè)行為有好有壞。好的方面是用戶不需要額外配置壞的方面是如果用戶配了一個(gè)錯(cuò)誤的鏡像地址安裝失敗后第一時(shí)間不會(huì)懷疑 .npmrc而會(huì)認(rèn)為是 t3code 的問題。我在安裝失敗的錯(cuò)誤信息里加了一行提示提醒用戶檢查 .npmrc 中的 registry 配置。這條提示幫我擋掉了不少重復(fù)的 issue也讓用戶排查問題的路徑短了很多。5.4 模板分發(fā)與版本錯(cuò)配的教訓(xùn)t3code 的模板存儲(chǔ)在 npm 包內(nèi)模板和 CLI 代碼共享版本號(hào)。對(duì)于小項(xiàng)目來說這個(gè)方案夠用但模板數(shù)量上來之后就會(huì)出現(xiàn)代碼沒變、模板更新也要發(fā)版本的情況。目前我的處理是遵循語義化版本規(guī)范模板改動(dòng)如果只是內(nèi)容層面的變化發(fā) minor 版本模板數(shù)據(jù)結(jié)構(gòu)變化比如 manifest.json 格式調(diào)整發(fā) major 版本。同時(shí)我做了一個(gè)雖然簡(jiǎn)單但非常有用的機(jī)制doctor 命令會(huì)檢查當(dāng)前 CLI 版本與最新版本之間的差異如果差異過大就提示用戶升級(jí)。這個(gè)檢查不是為了騷擾用戶而是因?yàn)槟0搴?CLI 強(qiáng)耦合版本不對(duì)齊會(huì)生成錯(cuò)誤的內(nèi)容。這個(gè)設(shè)計(jì)是真實(shí)事故換來的。有一次用戶用舊版 CLI 搭配新模板生成出來的 package.json 里引用了一個(gè)不存在的腳本排查了很久才發(fā)現(xiàn)是版本錯(cuò)配。現(xiàn)在 doctor 命令會(huì)在用戶跑 init 之前先做版本檢查不一致時(shí)給出明確提示。6. 后續(xù)擴(kuò)展的方向工具的生命力在于被真實(shí)使用最后聊一聊我接下來想做的事。t3code 目前的形態(tài)已經(jīng)能解決團(tuán)隊(duì)的日常問題但它距離我理想中的工程基線工具還有一段路。我自己打算按下面幾個(gè)方向慢慢推進(jìn)也寫出來給大家做個(gè)參考。6.1 插件機(jī)制當(dāng)前可選區(qū)塊是寫在 manifest.json 里的靜態(tài)聲明數(shù)據(jù)和邏輯都不夠靈活。如果支持插件讓第三方通過一個(gè)鉤子函數(shù)注入自定義渲染邏輯t3code 就能變成一個(gè)更通用的工程能力平臺(tái)。比如有人做了一套企業(yè)級(jí)日志方案寫一個(gè)插件任何人在生成項(xiàng)目時(shí)都能一鍵接入。這個(gè)方向投入不小目前優(yōu)先級(jí)不算最高但長期來看是讓工具突破單團(tuán)隊(duì)自用邊界的關(guān)鍵。6.2 模板遠(yuǎn)程化現(xiàn)在模板打包在 CLI 包里每次想加模板都要發(fā)一個(gè)版本。如果模板能放在 Git 倉庫里CLI 通過 URL 直接拉取指定 tag 的模板那么團(tuán)隊(duì)里的非前端同學(xué)也能通過維護(hù)倉庫來更新模板完全不碰 CLI 代碼。這一步能把模板即代碼的理念貫徹得更徹底也是我比較看好的方向。6.3 生成后自動(dòng)校驗(yàn)?zāi)壳?t3code 生成完項(xiàng)目后只做了依賴安裝沒有對(duì)生成產(chǎn)物做深度校驗(yàn)。我打算加一個(gè) post-init 鉤子在目標(biāo)目錄里自動(dòng)跑一遍 typecheck 和 lint如果失敗直接指出哪些模板文件有問題。這個(gè)能力的價(jià)值在于模板作者改完模板后能立刻知道模板本身引入了編譯錯(cuò)誤而不是等用戶創(chuàng)建項(xiàng)目之后才發(fā)現(xiàn)。6.4 更多項(xiàng)目模板t3code 的核心價(jià)值是 T3 技術(shù)棧的工程化基線但同樣的機(jī)制完全可以用于生成 NestJS 后端項(xiàng)目、React Native 項(xiàng)目甚至純 npm 庫的基線。底層邏輯都是一樣的交互收集參數(shù)、模板渲染、收尾動(dòng)作變的只是模板內(nèi)容。這個(gè)方向不復(fù)雜主要看團(tuán)隊(duì)實(shí)際需求什么時(shí)候出現(xiàn)。根據(jù)我個(gè)人的體會(huì)腳手架工具最怕的不是功能少而是功能沒人用。t3code 從立項(xiàng)到現(xiàn)在最大的收獲不是代碼量而是逼著我把團(tuán)隊(duì)里很多默認(rèn)大家都知道的工程約定寫成了文檔化的、可驗(yàn)證的模板。這個(gè)過程中很多原本模糊的規(guī)范變得清晰了很多原本靠口頭傳授的經(jīng)驗(yàn)變成了代碼。如果你也在維護(hù)團(tuán)隊(duì)的工程基建我真心建議試一次把自己的腳手架工具寫出來哪怕只服務(wù)三個(gè)人它帶來的規(guī)范沉淀也比任何現(xiàn)成工具都值。
返回列表
PREV
查看更多資訊
NEXT
返回資訊列表
久Se视频在线观看| 涩涩五| 色五月大香蕉婷婷| 美女被操一区二区| 一本大道嫩草AV无码专区| 97操碰视频| 99热在线成人网站| 五月丁香亚洲五月| 国产永久一二一起草| 色五月激情综合| 超碰人妻公开在线| 狠狠狠狠狠狠| 久久天天| 五月丁香六月激情欧美综合| 伊人久久大香线蕉av最新| 99久久玖玖| 五月婷婷和六月| 丁香五月天堂网| 成人色图情色成人网 www.5b5b5bcom 五月天 | 俺去啦综合网| 婷婷夜夜夜夜| 色天天久婷婷| 婷婷五月激情热播| 无码se| 182TV大香蕉| 亚洲精品九九| 色色综合网。| 欧美色必爱| 日日操天天操| 五月婷视频| 99免费在线| 波多野结衣AV无码Porn| 婷婷六月丁| 久久九九99亚洲国产久精综合| 狠狠色婷婷7| 色综合综合色| 色噜噜狠狠色综合网| 淫荡A片| 五月婷婷黄网站大全| 熟妇人妻中文字幕无码老熟妇| www色五月| 欧美大香蕉视频| 久久美女五月天| 美女美女美女三级色天天天天天| 六月丁香五月激情婷婷| 五月天激情.com| 五月丁综合在线观看| 激情五月开心五月在线视频| 精品国产va久久久久| 五月丁香六月婷| 操碰91| 亚洲色综合| 日本欧美国产| 超碰9| 涩涩五月天| 丁香六月五月天| 婷婷五点亚洲| 妻久久人久久| 亚洲国产99| 天天插插天天| 色爱亚洲| 天天综合网站| 另类精品视频在线观看| 九九碰九九爱97| 天堂久久精品| 久久九区| 操骚货在线| 五月天婷婷激情小说电影| 99re思思热这里| 99热国内| 五月天婷婷色播在线网| 狠狠狠狠狠草| 蜜桃五月天| 丁香五月欧美激情| 五月丁香六月激情在线| 超碰成人av| 婷婷婷久久久| 97干在线视频| 天天爱天天爽| 人妻体体内射精一区二区| 性色做爰片在线观看WW| 九色综合网| 天天日天天肏天天奸| 激情五月婷婷综合网| 91色性感五月婷婷丁香| 大香蕉懂9| 91精品视频男人的天堂| 丁香五月AV| 手机旧版看人妻1025| 国产激情av| 久久婷婷色色| 色婷婷手机在线| 99热18| 六月婷婷成人| 婷婷丁香激情五月| 亚州操人在线视频| 97碰碰视频| 99精品一二三四视频| 伊人狠狠丁香婷婷综合尤物| 99热这| 婷婷五月丁香六月| 98国产精品综合一区二区三区| 婷婷D区| www,99热在线观看| 99爱爱网| 久久久人妻人伦| 色婷丁香五月| www狠狠| 99亚洲日韩| 五月激情婷婷国产精品久久久久久| 丁香狠狠色婷婷久久无码视频| 色婷婷亚洲五月天| 伊人99热| 性做爰A片免费视频A片直播| 日本一区二区三区精品视频| 91ncm视频| 激情九月婷婷| 五月婷婷香蕉| 26uuu精品国产| 久久伦乱| 狠狠操狠狠| 男同91| tingtingseav| 激情视频91| 激情久久久| 五月婷婷综合网在线播放| 五月丁香六月婷婷综合网| 婷婷五月天亚洲图片| 六月合五月婷| 激情99热| 国产精品扒开腿做爽爽爽A片唱戏| 性生生活大片又黄又| 色99xx| 日熟女| 五月激情啪啪| 久久久精久人妻| 欧美五月丁香| 91操人| 办公室少妇激情呻吟A片在线观看 白人荫道BBWBBB大荫道 | 国产色99| 99九九热在线观看| 蜜桃五月天| 日本玖玖在线| 97欧美在线| 丁香五月婷婷狠狠色| 夜夜夜夜做天天天做无码视频| 亚洲天堂aaa| 生活片五区| 色综合色| 九九久久精品國產| 丁香六月色婷婷欧美| 丁香五月23111| 99综合| 天天爱天天操| 五月天堂六月丁香亚州中文字幕久久| 激情AV| 五月天色婷婷图片| 天天拍天天操| 91九色精品熟女内射| 东京热五月婷婷| 香蕉97碰碰碰超视精品| 丁香六月婷婷缴情欧美| 五月丁香另类图片| 精品色色| 操逼五月天| 色色婷婷五月天| 操逼123网| 激情五月天小说网| 99色综合| 五月丁香啪。| ...婷婷国产成人亚洲日韩| 丁香六月婷婷综合啪啪| 色色色com| 玖玖婷婷色欲| 综合激情婷婷| 涩五月色婷婷| 成人在线视频网| 激情综合文学| www.婷婷五月天,com| 99视频热| 五月天综合视频| 任你弄在线视频免费| 99日逼视频| 狠狠五月激情在线| 亚洲另类日本| 青草青草视频2免费观看| 免费成人网在线观看| 色一区高清| 色色色色色网站| 99热这里只有精品3| 五月婷婷久久网| 另类图片色五月| www.狠狠干com| 久久婷综合| 婷婷五月天天| 2015好吊操| 99久久玖玖| 日本狠狠干| 人妻操日日| XXXX岛国| 欧美久久网| 国产,欧美,学生妹,视频| www.99日本| 97久久香草精品视频| 青青草轻轻操| 色操综合| 伦乱美欧| 日本久久婷| 热99色| 99热综合| 影音先锋91资源站| 国产99久| 婷婷激情五月天综合| 五月天久久婷婷| 天天综合色| 色99色| 丁香五月激情六月综合| 思思久久99| 欧美激情久| 九九久久99| 久久婷婷五月丁香网| 激情色五月天| 夜夜操夜夜爽| 日本精品99网站| j五月香在线| 伊人婷婷五月天| 久久这里都是精品免费| 99热在线观看| 潮汕成人AV片在线| 欧美精品久久久久久视频观看| 一级二级色大片| 激情综合色婷婷啪啪五月天| www.激情.com.| 99精品热| 亚洲在线网站| 激情婷婷五月天伊人在线观看| 91碰在线| 九九www| 色色日韩无码| 丁香激情五月天| 日日操夜夜操无码免费| 婷婷久久亚洲| 黄色三级毛片中字| 六月激情久久婷婷| 伊人久久99| 青青草网武则天| 夜夜爽日日躁| 五月婷亚洲精品| 亚洲无AV在线中文字幕| 天天做天天爱天天搞| 色播播五月天| 色色色五月| www好屌操| 99热免费观看| 人妻人人操| 日本天天操| 丁香啪啪中文字幕| 久久视频九九视频| 国外亚洲成AV人片在线观看 | 丁香五月婷婷啪| 97AV人人插人人操| 在线可以看的av网址| 国产亚洲精品AAAAAAA片| 人妻22p| 婷婷五月色情| 视频久久9| 久久这里只有精品16| 久99视频| 97av在线视频| 婷婷伊人网| 色爱99| 成人丁香婷婷| 婷婷色综合中心站| 高清无码中文字幕aVDV| 无码激情AAAAA片-区区| 五月婷丁香在线视频在线| 99色在线| 99热最新精品| 天天操天天操天天操天天操天天操天天操天天操天天操天天操 | 久久这里只有精品网| 思思热在线| 超碰AV在线| 五月丁香色综合| 一区=区操屄高清大全av| 五月激情基地| 天天日天天肏天天奸| 婷婷五月天成人动漫 | 我爱婷婷五月天综合88| 熟女少妇内射日韩亚洲| 人妻系列久久久久久久久久久| 五月丁香六月婷婷网| 九九RE视频在线精品| 99久在线观看| 色综合中文| 无码动漫av| 五月婷免费视频| 激情色色色| 五月婷久久综合| 思思久热| 久久久噜噜噜操操操| 天天操夜夜爽| 狠狠色综合久久久久| 这里只有精品视频一区| 亚洲成人丁香花| www久热com| 激情综合色婷婷啪啪五月天| 亚洲免费99| 亚洲婷婷性爱| 综合网五月天123| 亚洲六月综合激情久久下卡| 天天干com| 大香蕉视频婷婷| 五月天黄色激情小说| 婷婷综合中文| 丁香五月婷婷手机| 超碰人人插| 色天天综合| 日本三级第一页| 久久机热这里只有精品| www.婷婷五月天,com| 久久这里只| 美女被肏网站在线看| 26uuu另类亚洲欧美日本一| 日本成人内射| 婷婷五月综合网| 色色色色色五月| 婷婷性福五月天| 色吊丝永久访问网址| 日本99在线| 婷婷丁香九月| 久久a热| 人人色婷婷五月天| 欧美69久成人做爰视频| 婷婷香五月| 日本韩国视频在线观看社区免费的9| 天天日日爽| 激情玖玖综合网| 亚洲欧美国产高清vA在线播放| 综合精品啪啪| 狠狠操天天干| 國語久久婷| 中文字幕黄色片| 色狠狠五月天| www99热| 五月熟妇婷婷久久| 七月婷婷色香综合网| 婷婷精品性性性性性性性| 人妻激情网| 丁香久久五月婷综合| 久久九色| 欧美交换配乱吟粗大25P| 五月社区婷婷激情| 热婷婷av| 五月天婷婷綜合院| 超碰人人艹| 另类小说五月天| 久久亚洲色导航| 欧美情色一区| 五月婷婷69| 香蕉视频91| 91蜜桃婷婷狠狠久久综合9色| 亚洲五月丁香综合网| 97婷婷色| 伍月婷丁香花全集| 91色在线| 久久女婷| 亚洲 六月 综合| 婷婷五月天大香蕉| 天天干天天操天天拍| 五月天无码视屏播放| 5月丁香美女影院| 五月亭亭性| 人伦30P| 色综合色色| 婷婷五月婷婷五月| 欧美日韩国产一区| 欧美精品999| 亚洲精品性色| 五月天婷婷色色网| 婷婷在线视频| 色综合色综合色综合| 亚洲国产另类av| 中文字幕丰满人妻无码专区| 美女va| 激情综合网激情五月婷婷| 人妻久久久久久久| 亚洲区,视频区,视频区免费| 激情操逼婷婷| 成人网在线视频| 五月天激情播播网| 影音先锋男士资源网一区| 99视频在线观看网址| 亚洲精品国产setv| www,奇米影视| 人人爱摸视频| a色色色色色| 中文字幕丰满孑伦无码专区| 人人爱人人草| WWW.夜夜操.com| 99色人| 九九热re99re6在线精品| 国产精品久久久99视频| 亚洲中文字幕在线电影| 九九RE视频在线精品| 婷婷丁香午夜综合影视| 日韩成人综合| 大香蕉五月天婷婷| 伊人久久丁香婷婷六月五月综合| www.色五月.com| 99性爱| 亚洲成人噜噜| 综合亚洲六月婷婷在线| 九九中文色色| 美女五月天| 99色爱| AV网站免费在线| 伊人激情AV一区二区三区| 欧美成人网99网| 91超碰九色| 婷婷操久久| 99热这里只有精品98| 操逼综合激情网| 性一交一乱一交A片久久四色| 久久这里只有精品视频26| 色色婷婷丁香五月天| 五月丁香| 婷婷伊人网| 99热免费网站| 色色五月天com| 丁香五月婷婷色| 婷婷五月天视频亚洲| 五月天五月色婷婷综合| 久草丁香婷婷五月天婷| 亚洲精品久久久无码| 天天影视天天爽天天草| 日韩激情婷婷五月天| 国产综合81p| 丁香婷婷综合激情五月色| 色婷婷激情| 综合五月丁香久久| 狠狠爱婷婷丁香| 大陆极品少妇内射AAAAAA| 五月99久久| 九九爱看亚洲| 五月丁香综合激情网| 东京热五月婷婷| 91精品久久久久久| 亚洲欧美一区二区三区四区爱爱动图| 丁香丁香激情网| 97精品综合久久内射| 公的粗大挺进了我的密道| 色色婷婷丁香五月天| yazhouzonghesese| 97色婷婷成人综合在线观看| 9999综合99综合人| 中文字幕日产A片在线看| 99视频在线播放大全| 久久精彩视频99| 亚韩在线视频| 婷婷五月欧美| 丰满少妇乱A片无码| 丁香婷婷激情| 夜夜撸天天日| 小视频aaa久久久| 久久九九中文字幕| 婷婷9月天| 色婷婷在线视频| 五月天天天天天天天天天天天婷婷婷| 婷婷丁香激情| 少妇丁香婷婷 | 91成人视频| 婷婷婷久久| 开心五月激情网| 丁香伊人网| 欧美成人五月天| 丁香婷婷免费| 99自拍视频在线| 欧美久久久久久久久中文字幕| 国产精品一区在线观看你懂的| 五月丁香激情婷婷| 五月丁香中文字幕| 婷婷五月开心中文字幕在线| 狠狠舔| 欧美天天搞| 久久加勤综合| 亚洲va综合va国产va中文| 久久东京热婷婷五月| 无码人妻一区| VA婷婷亚洲| 6月丁香婷婷| 99亚洲精美视频在线观看| 日韩av在线播放综合网| 国产精品久久久久9999小说| 激情影院丁香五月| 久久婷婷色色| 噜一噜在线| 五月天婷婷深深爱| 天天更新天天亚洲| 国产99美少妇| 婷婷综合激情| 丁香五月区| 91精品丝袜久久久久久久久粉嫩| 久久婷婷原创视频| 日本强伦片中文字幕免费看| 激情小说五月天| 天天看A片| 五月婷激情影院| 色色色9| 人人做人人看人人摸| 袁子仪视频观看| 九色自拍| 超碰97久久| 五月色激情综合网| 玖玖婷婷五月天毛片| 亚洲色无码A片一区二区麻豆| 久久一热| 成人婷99最新| 色色狼人综合| 五月激情综合网| 丁香五月天AV| 丁香五月成人在线| 色高清无码视频| 26uuu.| 深爱五月月天| 综合婷婷| 久草大| 啪啪 综合网| 国产AV不卡福利| 日本少妇AA一级特黄大片| 亚洲av电影网站| 中文字幕日本最新乱码视频| 国产欧美精品AAAAAA片| 亚洲精品字幕在线观看| 在线日韩视频| 婷婷99| 天天爽天天| 丁香五月Av| 色综合婷婷| 玖玖无码中文| 久久久激情视频| 天天做天天爱天天爽| 色五月婷婷激情| 久久久久久久久久人妻| 五月综合六月婷婷| 天天干夜夜欢| 色婷婷在线视频综合| 天堂婷婷丁香六月网| 26uuu亚洲欧美另类| 日韩五月天婷婷| 五月综合激情图片 | 五月丁香婷婷三级| 互月天综合| 婷婷婷五月天最新综合你懂的| 天天肏天天插| α久久| 婷婷五月天激情在线观看| 99激| 天天射综合网天天插| 婷婷玉月丁香五月在线视频| 丁香婷婷六月激情综合| 激情综合亚洲色婷婷五月| 五月丁香婷婷伊人| 99re视频精品| 亚洲天天| 强伦轩人妻一区二区电影| 天天日天天草| 五月久久婷婷天堂视频| 久久久久久激情| 久99久视频| 99视频在线精品免费观看2| 在线播放成人网站| 日韩成人网址| 综合大香蕉| 日韩黄黄| 人人干av| 色狠狠色噜噜AV天堂五区| 丰满少妇猛烈A片免费看观看 | 日韩亚洲视频| 99久热| 熟女人妻一区二区三区免费看| 强辱丰满人妻HD中文字幕| 超碰免费人| 中文字幕视频色婷婷| 日韩熟女啪啪视频| 激情综合网站| 影视av久久久噜噜噜噜噜三级| 六月婷婷激情图片| 人人澡天天色天天做| www。88热在线视频免费观看| 97涩涩丁香五月天| 丁香六月成人网| 九九热精品6| 五月天婷婷久久视频| 人人干99| 九九热在线精品视频| 色色色综合| 激情五月婷婷综合秋霞| 午夜在线成人网站免费观看| 99热99| 99久久久久久| 色五月天天在线观看资源站| 亚洲综合网激情五月天| 丁香五月av在线| 五月婷婷色激情| 亚洲激情综合| 天天狠天天叉| 五月激情综合网| 激情色五月天| 亚洲婷婷五月| 无码se| 五月天成人在线视频丁香| 26uuu亚洲欧美| 五月色亚洲| 91操网| 亚洲操操| 久草婷妨| 天天色丁香| 婷婷五月天伊人在线| 97久久香草精品视频| 五月婷婷开心综合| 久久婷婷色色| 极品少妇XXXX精品少妇偷拍| 5Www色5夜| 中文字幕婷婷在线| 97综合在线| 这里只有精品,日韩视频| 另类视频丁香五月| 五月丁香婷婷深深爱| 久热9| 日本乱子人伦在线视频| 欲色人妻| 大香蕉五月天婷婷丁香91| 三级黄网站| 色婷激情网| 五月久久婷婷成人网| 久热大香蕉| 中文字幕免费高清电视剧| 99久久天堂婷婷| 97香蕉久久超级碰碰高清版| 天天综合插插| 日本高清综合网五月丁香| 9+1视频网址| 狠狠干综合| 色约约视频一区二区三区四区五区 | 亚洲婷婷激情综合激情999精品| 色婷婷六月| 成人久碰| 99精品久久久久| 九九热这里有精品23| 婷婷六月久久综合导航| 综合久久影院| 亚洲精品又粗又大又爽A片 | 91chinese 在线| 婷婷丁香五月天色播网站| 婷婷五月激情在线视频| 亚洲色婷婷| 色色色色色色综合网| 五月丁香激| 好好日激情五月天| 丁香在线视频| 成人看片网站| 婷婷五月天毛片| 婷婷激情五月天网站| 五月花在线观看视频| 亚洲色五月天| 9精品一区| 色色网站免费在线视频| 噜噜色婷婷| 夜夜操狠狠操| 亚洲AV永久无码影院黑人| 国产伦理精品高清在线观看网站一区二区| 激情六月婷| 久久婷婷伊人| 99热xx| 99在线观看| 日韩操| 99热国产这里只有精品| 91 久热| se99高清无码| 五月丁香综合在线| 国产乱子轮XXX农村| 五月停停色| 日韩av干| 五月丁香六月婷| 97色五月丁香婷婷| 亚洲人成网亚洲欧洲无码久久| 亚洲99精品欧美一区| 日日干夜夜干| 日本三级毛片| 亚洲看av的网站| 色婷婷六月天| 五月九九综合| 五月丁香网av| 日韩在线一级| 九九爱激情| 99热免费精品| 五月天激情视频网站| 99色色视频| 91九色无码内射| 五月婷婷久久激情| 成人电影在线免费试看| 国产jd1024基地手机看国产| 色丁香五月婷婷婷| 综合色影院| 性爱激情五月| 夜夜爽天天| 99国产精品久久久久久久久久久| 国产麻豆视频| www.xtbsty.cn.com蜜乳AV| 日日操夜夜爽| 婷婷六月天国产综合| 欧美天天草人人草| 99无码精品| 久久六月婷婷| 激情综合网络插| 91丨九色|PRNY熟妇| 久久婷婷视频| www.夜夜操| 日韩 中文 欧美| dingxiangtingtingliuyue| 99在线免费视频| 久久久久激情网| AV在线不卡播放| 五月天婷婷色| 婷婷五月影院| 五月丁香婷久久| 人人色性网| 激情视频网址| 成人在线视频一区| 9久热这里只有精品| 综合婷婷| 人妻人人操| 色色色色色网| 99亚洲精品综合在线| 婷婷五月蜜桃成人桃色丁香| 色五月综合在线| 婷婷中文网站| 亚洲丁香五月在线观看| 婷婷五月天色| 久久色区| 天天干天天拍| 色综合久久8| 婷婷丁香五月天小说| 久综合网| 丁香五月性| 久久久久网站| 99超碰在线免费| 淫水导航| 免费无码毛片一区二区A片 | 婷婷97碰碰| 《丁香激情综合久久伊人久久》影视在线观看 -高清预告手机免费播放 -三妹影院 | 99热这里只有精品69| www久久99| 国产 亚洲 在线| 欧美成人日韩| 婷婷五月a| 久久久久久丁香五月| 亚洲欧洲中文日韩久久AV乱码| 婷婷五月天最新综合你懂的| 亚洲AV成人片无码网站| 五月婷婷综合社区| 久久九九热视频| 超碰cap| 2025中文在线视频字幕免费观看| 五月天播播| 色情五月丁香| 男人天堂99| 99re热在线视频观看| 免费观看的婷婷五月视频在线| 97碰碰叉| 丁香激激情网| 欧美成人在线观看| 亚洲婷婷开心五月| 婷婷色婷婷| 亚洲色9| 大香蕉啪啪啪| 日韩无码成人电影| 激情综合九月| 99热99美国在线观看| 日本色综合| 99热一本久道| 天天久| 精品国产a| 丁香色综合| 97超级碰| 激情五月天色婷婷综合| 综合 激情 婷婷| 亚洲狠狠狠色婷婷综合激情久久久| 色九月婷婷| 高清无码.com| 99精品视频在线观看| 大香蕉九九| 久操操| 丁香五月日韩| 日本综合色色| 五月婷婷影院| 亚洲色综合| 99热最新网址| 婷婷深爱五月| 播五月婷婷开心| 五月婷婷久久综合| 夜夜骑日日操| 99色综合| 天天粽合合合合| 亚洲乱码日产精品BD| 五月天伊人日日噜影片AV| 一二线视频 另类| 米奇影视资源婷婷狠狠色激情欧美五月丁香 | 91女人18毛片水多国产| 涩婷婷五月天| 欧美日本97| 噜噜狠狠色| 99久久久久久www| 丁香激情五月| 大香蕉99| 99ri视频| 五月天婷婷一起草| 狠狠五月天| 亚洲综合网激情小说| 成人美女网| 亭亭五月激情亚洲在线| 婷婷五月天亚洲综合网| 五月天婷婷在线AN| 激情五月婷黄版| 五月丁香自拍| 在线色色| 久久九九国产精品怡红院| 综合婷婷六月| 少妇水多A片太爽了| 99热精品9| 久久综合最新网址| 日本成人噜噜噜| 久热69| 综合色99| 色五月天天在线观看资源站| 色婷婷影院| 99热这里只有精品96| 精品热青草| 激情五月婷婷网| 六月婷婷网| 粉嫩av蜜桃av蜜臀av| 人妻AV在线| 97五月天| 丁香六月天婷婷开心综合| 99玖玖视频| www.婷婷.com| 99久.| 综合色99| www,婷婷五月天777me,com| 五月天色软件| 五月婷婷成人| 日韩不卡DvD| 99碰碰| 婷婷五月天激情小说网站| 亚洲精品另类| 久久性刺激| 五月天婷婷色在线视频免费观看| 专区无日本视频高清8| 伊人婷婷色激情丁香| 婷婷丁香大香蕉| 五月婷婷综合网| 综合色播| 亚洲爆乳无码精品AAA片蜜桃| 久久99久久99精品免观看软件| 九九精品碰| 天堂网啪啪| 欧美激情丁香五月| 日韩黄在免| 五月丁香六月情| 国产欧美第五十五页| 99视频精品| 色综合综合色| 正宗黄色毛片| WWW.婷婷| 色婷婷丁香AV综合| 日日噜噜久久婷婷五月天| 国产成人AV在线播放| 性韩日色婷婷五月天激情啪啪XXX| 色噜噜狠狠色综无码久久合欧美| 另类五月激情| 日本啪啪天堂| 中文字幕丰满孑伦无码专区| 五月天婷婷在线AN| 超碰成人在线观看| 一本大道嫩草AV无码专区| jiqingliuyuetian| 日韩久久视频| 人妻丰满精品一区二区A片| 能直接看的av网站| 亚洲无码另类| 91男女视频在线观看| 狠狠操天天干| 六月丁香基地| 久9热插入| 久操热| 婷婷丁香亚洲五月天| 色婷婷国产精品综合在线观看| 久草五月| 五月婷婷激情综合网| 99热九九这里只有精品| 欧美色激情四射| 天天搞天天色综合| 精品久色| 婷婷丁香久久网| 国产成人av在线播放| 五月丁香综合伦理片| 色婷婷色| 色色婷婷五月天| 桔色成人在线| 高清不卡一区| 狠狠五月婷婷| 在线网黄| 深爱五月中文字幕| 六月婷色| 久久99国产综合精品免费| 另类激情中文| 91精品电影18T| 99久久色| 免费视频无码| 天天激情站| 丁香九月婷婷| 婷婷丁香色五月天| 婷婷色九月| 国产一级婬片毛片| 九九热10| 五月婷A V在线| 国产9色在线/日韩| 丁香六月成人网| AV操逼网| www.色多多婷| 99久久久久| 亚洲永久免费| 深夜婷婷 丁香| 婷婷情色五月天| 丁香五月婷婷激情123| 69久久99精品久久久久婷婷| 极品人妻VIDEOSSS人妻| 久久伊人9| 丁香婷五月天| 五月婷婷偷拍| 日本操B视频| 日韩另类| 九九热精品6| 九九热视频精品2| 丁香社92视频| 天天爽天天| 另类小说五月天| 欧美va| 69热在线| 99碰碰中文| 欧美三级巜人妻互换| 影音先锋一区二区三区| 欧美久久婷婷| 激情美女五月天| 十区AV| 久久大香蕉丁香| 思思热精品在线视频| 天天爽,夜夜爽| 清色五月天| 色三级色三级| AV网在线观看| 欧美黑人巨大性生话| 996热re视频精品视频| 天天色激情| 久久久久久草黄色片AV在线观看| 欧美啪啪9| 婷婷九月丁香中文| 五月婷视频| 9色在线视频| 成人丁香婷婷| 久久av电影| www.狠狠| 久久超级碰视频| 牛牛澡牛牛爽| 色色COm| 《战争与艾拉》完整版| 婷婷在线综合| 精品导航在线x不卡| 免费观看全黄做爰的视频| 97色碰| 99爱视频在线观看| 婷婷伊人五月| 亚洲人人96@| 亚洲啪啪视频| 五月丁香婷婷啪啪网| 9视频在线成人网站| 综合色图区| 操久久网| 人妻久久人妻久久第一区| 狠狠五月天婷婷激情网。| 这里只有精品视频在线观看免费| 涩综合网| 久久狠婷婷| 久久综合五月情| 色五月激情五月| 涩涩涩五月天| 丁香五月天资源网| 婷婷五月天日本无码| 六月丁香婷婷网| 九九热这里只有精品23| 九九色大香蕉| Aα在线免费观看| 九久久婷婷| 精品人妻伦九区久久AAA片| 超碰狠狠操| 伊人色综合网| 亚洲五月天婷婷在线| 亚洲色情免费网| 国产超碰在线| 99热国内精品| 91亚洲天堂| 97色一二三| 久久激丁香| 国外亚洲成AV人片在线观看| 99视频在线精品| 婷婷精品在线| 丁香五月天亚洲视频| 婷婷丁香五月高清| 思思99re这里只有| 91热er| 激情综合青草| 97久久超碰| 99久久精品色老| 2016日日夜夜操| 久操大屁股女人av| 开心五月婷婷伊人| 久久您您综合网| 99re6在线视频精品免费| 这里只有精品视频| 99爱视频免费| 99日韩| 九九热中文| www.jiujiujiu| 51国精产品自偷自偷综合| 色婷婷综合视频| 天天撸天天干天天插| 色婷婷五月亚洲| 草婷婷在线| 丁香五月婷婷色五月| 国产中文亚洲欧美日韩性交| 色色激情| 五月激情综合网| 97碰超级人人看| AV在线免费网站| 激情六月天婷婷| 久久久久久久久久91| 九九十99视频| 大香蕉九九操| 欧美婷婷精品激| 狠狠色网| 色九九丁香九月色九九色| 婷婷性爱综合| 色月丁| 国产婷婷五月| 天堂久久大香蕉| 久久精品五月| 五月婷婷色白丝| 欧美一线视频| 亚洲成人av在线播放| 开心五月婷婷综合在线精品素人| 丁香五月 无码| 91亚洲免费片| 亚洲黄色av网站| 免费看片操逼| 五月婷婷日| 六月丁香狠狠爱| 激情久久久久久久久久| 丁香 久久| WWW.久久久久久久| 亚洲在线操| 久久婷婷色| 操一区| 国产精品久久99| 五月婷婷深深爱爱| 亚洲色五月天在线| 亚洲综合干| 天天插天天干天天舔| 色五月激情基地| 不卡影院午夜理论片| WWW,婷婷,COM| www激情婷婷com| 五月婷婷啪啪| 国产免费一区二区三区三州老师F1F1.CC| 婷婷婷久久久| 精品成人久久久久久久_一二三四视| 国产在线中文字幕| 99无码黄色视频| 五月天社区| 日本人妻伦在线中文字幕| 久久综合婷婷激情| 五月丁香 狠狠爱| 五月丁香婷婷99| 欧美精品A片一区在线观看| 亚洲天堂啪啪| 五月天婷婷基地| 思思视频久久| 丁香婷五月天| 久久aaaa片一区二区| 色色网站| 激情视频综合| 色五月综合网| 久久婷五月| 成人午夜天| 亚洲丁香婷婷| 99在线视频女女视频| 91丨九色丨熟女丰满| 日本99视频| 久色成人| 丁香五月网在线观看| 激情五月天小说| 日本女人久久| 可以看的AV| 国外亚洲成AV人片在线观看| 色婷婷五月综合激情中文字幕| 强奸幻女毛片| 99热欧美偷拍| 91丨九色丨熟女高潮| 在线五月色播| 俺去也在线www色官网| 婷婷丁香五月色| 色色色婷婷五月天| 九九精品热| 国自产拍偷拍精品啪啪一区二区| 婷婷五月丁香成人网| 五月天另类图片区99| 97资源碰碰| 99久久国产成人精品| 激情五月婷婷在线| 五月天四色房丁香亭亭| 99热人人| 五月丁香综合| 激情五月四色| 91九色中文| 99热在线播放| 91啪级电影| 亚洲另类噜噜| 最新久久网址| av九九| 碰99在线| 天天se在线视频| 九九九这里只有精品| 色久婷婷网| 久久视频这里99| 亚洲乱码在线观看| 操91| 九月丁香婷婷网| 久久久久网站| 色综合色婷婷色伊人| 亚洲第一视频 久久| 婷婷五月色激情欧美激情| 99精品性爱| 亚洲日韩久久婷婷伊人| 9热久久| 国产韩日亚洲美州欧亚综合在线| 五月婷婷在线网站| 影音先锋777xfplay色资源网站| 亚洲操逼片| 亚洲亚洲人成综合网络| 久久久精品99| 9色在线| site:ornaments52.com| 国产精品国产| 狠狠色综合网| 91 久热| 婷婷的久久网站| 亚洲综合视频一下| 久久机热/这里只有精品| 色激情五月| 五月婷婷电影院| 99热综合在线| 成人久久天天x资源站| 一级黄色尤物综合视频手机在线观看| 久久丁香五月天| 26uuuavcom| 亚洲中文乱字字幕线在永久| 久久亚洲无码| 九九色婷婷| AⅤ在线播放网| 亚洲区,视频区,视频区免费| 狠狠狠狠操| 91人人操人人爱| 亚洲成av人影院| 丁香六月激情毛片| 五月天色色激情综合| 色婷婷五月天小说| 五月天久久久| 久热伊人91| 国产精品社区| 五月婷婷精品视频| 激情综合网址| 1024亚洲无码| 综合久久高清| 这里只有精品99www| 九九人人精品| 免费无码毛片一区二区A片| 丁香六月婷婷色播| 一區四區歐美日韓| 欧美色频| 日本精品人妻无码77777| 99热全是精品| 久久婷婷五月草视频在线播放| 欧美狠狠色| 亚洲国产精品SUV| www.99热这里精品| 国产va在线视频| 97丁香五月| 久久久亚洲精品一区二区三区浴池 | 婷婷五月天在线观看第二页| 狠狠插狠狠操| 琪琪色五月婷婷老师| 九九aV| 亚洲最大五月天成人网| 天天色视频| 奇米影视777在线_在线观看午夜_h小视频在线观看_岛国大片 | 丁香六月狠狠干| 久久大香蕉丁香| 五月丁香综合啪啪| 天天色,天天日,天天做| 综合色播| www.色色com| 色播五月天天| 九九99九九99九九99视频网| 男人的天堂婷婷色五月| 九九久久综合| 色色色9| 五月婷婷无码| 五月婷婷色啪| 狠狠色五月| 亚洲色久| 色色丁香五月天社区| 日韩抽插操逼| 婷婷射综合| 一级片无码| 色之综合网| 五月天婷婷影院| 天天日天天肏天天奸| wwwss在线观看| 五月丁香六月婷婷色日| 日韩无码AV电影网站| 九九久久99| 五月丁香六月婷婷激情视频在线观看免费| 五月丁香六月激情| 久久久性爱视频| 激情五月深爱婷婷| 婷婷六月天| 国产精品操| 九九在线这里只有精品视频 | 婷婷狠狠爱| 婷婷色五月亚洲| 大香蕉五月天婷婷| 国产第99页| 热的国产,热的综合,热的有码| 91无码视频| 色色色色色色色色色色色色色色,网站| 五月婷婷六月丁香综合视频在线| 丁香激情网| 9色天堂| 激情婷婷五月黑人| 婷婷五月成人| 久久影视婷婷五月| 三十路磁力链接| 婷婷五月天视频| 五月天婷婷香蕉狠狠超碰综合| 激情五月,激情综合网| 五月开心播播网| 99热在线观看免费中文|