[{"data":1,"prerenderedAt":3226},["ShallowReactive",2],{"all-posts":3,"post:\u002Fithome-2025-day-07":1210},[4,23,35,46,57,68,80,91,102,114,126,138,149,160,171,182,193,204,215,226,237,248,258,268,278,288,298,308,319,330,341,354,368,380,390,400,411,421,431,441,451,461,471,481,491,501,511,521,531,541,551,561,571,581,591,601,611,621,631,641,651,661,675,691,704,719,731,742,752,762,772,782,792,802,812,822,832,842,852,862,871,881,891,901,911,921,931,941,951,961,971,980,990,1000,1010,1020,1036,1050,1062,1073,1083,1095,1107,1121,1134,1145,1156,1167,1180,1191,1201],{"path":5,"title":6,"description":7,"date":8,"updated":9,"tags":10,"categories":14,"draft":15,"wordCount":16,"readingTime":17,"canonical":18,"series":19},"\u002Fithome-2026-day-30","Day 30：Angular Router Providers 與生命週期管理，路由離開後 Service 會銷毀嗎？","平常在 Angular 中，我們可以透過 providers 決定 Service 的注入範圍。例如註冊在 Root，讓整個 Application 共用同一個實例；或註冊在 Component，讓 Service 隨著…","2026-10-14T14:46:39+08:00",null,[11,12,13],"iThome 鐵人賽","2026 鐵人賽","Angular",[11,13],false,7227,7,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10424222",{"name":20,"url":21,"day":22},"2026 iThome 鐵人賽：Angular 22 Signal 進化論","https:\u002F\u002Fithelp.ithome.com.tw\u002Fusers\u002F20116554\u002Fironman\u002F9939",30,{"path":24,"title":25,"description":26,"date":27,"updated":9,"tags":28,"categories":29,"draft":15,"wordCount":30,"readingTime":31,"canonical":32,"series":33},"\u002Fithome-2026-day-29","Day 29：Angular 也有 VueUse？使用 Signality 整合常見 Browser API","在 Vue 生態系中，VueUse 提供許多 Composables，讓我們可以快速使用瀏覽器功能，例如監聽網路狀態、保存使用者設定，或偵測元素是否進入可視範圍。","2026-10-13T23:14:18+08:00",[11,12,13],[11,13],6387,6,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10424070",{"name":20,"url":21,"day":34},29,{"path":36,"title":37,"description":38,"date":39,"updated":9,"tags":40,"categories":41,"draft":15,"wordCount":42,"readingTime":31,"canonical":43,"series":44},"\u002Fithome-2026-day-28","Day 28：Angular 動態建立 Component，NgComponentOutlet 與 ViewContainerRef","平常在 Angular 中使用 Component，通常會直接在 Template 裡面宣告：","2026-10-12T17:27:41+08:00",[11,12,13],[11,13],6565,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10423641",{"name":20,"url":21,"day":45},28,{"path":47,"title":48,"description":49,"date":50,"updated":9,"tags":51,"categories":52,"draft":15,"wordCount":53,"readingTime":17,"canonical":54,"series":55},"\u002Fithome-2026-day-27","Day 27：NgRx Store vs SignalStore，從 Action、Reducer 到直接更新 State","前幾天我們使用 NgRx SignalStore 實作購物車，透過 withState() 管理商品資料、withComputed() 計算總金額，再利用 withMethods() 與 patchState() 更新 …","2026-10-11T20:06:41+08:00",[11,12,13],[11,13],7308,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10423362",{"name":20,"url":21,"day":56},27,{"path":58,"title":59,"description":60,"date":61,"updated":9,"tags":62,"categories":63,"draft":15,"wordCount":64,"readingTime":17,"canonical":65,"series":66},"\u002Fithome-2026-day-26","Day 26：SignalStore 與 Strategy Pattern，透過 DI 動態切換業務邏輯","昨天我們使用 Angular 原生 Signal 與 NgRx SignalStore 實作購物車，透過 State 管理商品資料，再利用 Computed 計算商品數量與總金額。","2026-10-10T22:01:59+08:00",[11,12,13],[11,13],7347,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10423116",{"name":20,"url":21,"day":67},26,{"path":69,"title":70,"description":71,"date":72,"updated":9,"tags":73,"categories":74,"draft":15,"wordCount":75,"readingTime":76,"canonical":77,"series":78},"\u002Fithome-2026-day-25","Day 25：Angular SignalStore，原生 Signal 不夠用嗎？","在 Angular 開發中，如果資料只會被單一 Component 使用，通常可以直接透過 signal() 管理。但當多個 Component 需要共用同一份資料時，就得考慮狀態應該放在哪裡。","2026-10-09T21:28:45+08:00",[11,12,13],[11,13],9117,9,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10422784",{"name":20,"url":21,"day":79},25,{"path":81,"title":82,"description":83,"date":84,"updated":9,"tags":85,"categories":86,"draft":15,"wordCount":87,"readingTime":31,"canonical":88,"series":89},"\u002Fithome-2026-day-24","Day 24：SPA Router 為什麼不再只靠 History API？","平常使用 Angular Router 時，可以透過 routerLink 或 router.navigate() 切換不同頁面。","2026-10-08T14:30:47+08:00",[11,12,13],[11,13],6330,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10422348",{"name":20,"url":21,"day":90},24,{"path":92,"title":93,"description":94,"date":95,"updated":9,"tags":96,"categories":97,"draft":15,"wordCount":98,"readingTime":17,"canonical":99,"series":100},"\u002Fithome-2026-day-23","Day 23：RouteReuseStrategy，切換路由一定要銷毀 Component 嗎？","在後台系統中，很常會看到頁籤式介面，例如：","2026-10-07T15:58:32+08:00",[11,12,13],[11,13],7361,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10422016",{"name":20,"url":21,"day":101},23,{"path":103,"title":104,"description":105,"date":106,"updated":9,"tags":107,"categories":108,"draft":15,"wordCount":109,"readingTime":110,"canonical":111,"series":112},"\u002Fithome-2026-day-22","Day 22：Angular Render Lifecycle，從 afterNextRender 到 DestroyRef","過去在 Angular 中，只要遇到初始化、View 建立或資源清理，通常會先想到 Lifecycle Hooks：","2026-10-06T23:36:23+08:00",[11,12,13],[11,13],8111,8,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10421810",{"name":20,"url":21,"day":113},22,{"path":115,"title":116,"description":117,"date":118,"updated":9,"tags":119,"categories":120,"draft":15,"wordCount":121,"readingTime":122,"canonical":123,"series":124},"\u002Fithome-2026-day-21","Day 21：Angular Template 還適合呼叫 Method 嗎？從 Pipe、RxJS 到 computed","過去在寫 Angular 時，因為 Template 可以直接呼叫 Method，很容易在專案裡看到大量這樣的寫法。","2026-10-05T23:30:32+08:00",[11,12,13],[11,13],5431,5,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10421425",{"name":20,"url":21,"day":125},21,{"path":127,"title":128,"description":129,"date":130,"updated":9,"tags":131,"categories":132,"draft":15,"wordCount":133,"readingTime":134,"canonical":135,"series":136},"\u002Fithome-2026-day-20","Day 20：Signal Forms 非同步驗證，validateHttp 與 validateAsync","前兩篇介紹了 Signal Forms 的基本驗證，以及需要參考其他欄位的 Cross-field Validation。","2026-10-04T20:56:17+08:00",[11,12,13],[11,13],4278,4,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10420910",{"name":20,"url":21,"day":137},20,{"path":139,"title":140,"description":141,"date":142,"updated":9,"tags":143,"categories":144,"draft":15,"wordCount":145,"readingTime":134,"canonical":146,"series":147},"\u002Fithome-2026-day-19","Day 19：Signal Forms Cross-field Validation 與欄位更新時機","上一篇介紹 Signal Forms 時，已經看到可以透過 Schema 定義欄位驗證，例如 required()、email()、minLength()。","2026-10-03T23:18:26+08:00",[11,12,13],[11,13],3783,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10420631",{"name":20,"url":21,"day":148},19,{"path":150,"title":151,"description":152,"date":153,"updated":9,"tags":154,"categories":155,"draft":15,"wordCount":156,"readingTime":31,"canonical":157,"series":158},"\u002Fithome-2026-day-18","Day 18：Angular Signal Forms 穩定了，跟我們用了這麼久的 Reactive Forms 到底差在哪？","在 Angular 中處理表單，很多專案使用的都是 Reactive Forms。","2026-10-02T23:28:36+08:00",[11,12,13],[11,13],5886,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10420249",{"name":20,"url":21,"day":159},18,{"path":161,"title":162,"description":163,"date":164,"updated":9,"tags":165,"categories":166,"draft":15,"wordCount":167,"readingTime":31,"canonical":168,"series":169},"\u002Fithome-2026-day-17","Day 17：effect() 不是拿來同步 Signal 的，Angular 的 Side Effect 該怎麼寫？","effect() 是 Angular signal 裡很容易被誤用的一個 API。因為寫法直覺，只要讀取 signal，就能在值改變時執行一些事情，所以很常被拿來同步狀態、打 API，甚至再去修改其他 signal。","2026-10-01T21:22:13+08:00",[11,12,13],[11,13],6473,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10419779",{"name":20,"url":21,"day":170},17,{"path":172,"title":173,"description":174,"date":175,"updated":9,"tags":176,"categories":177,"draft":15,"wordCount":178,"readingTime":31,"canonical":179,"series":180},"\u002Fithome-2026-day-16","Day 16：即將登場的 Route Resources，Angular Router 為什麼需要新的資料載入方式？","過去在 Angular Router 中，如果希望進入 Component 前先完成資料載入，可以透過 Resolver，讓資料取得流程在 Component 初始化之前執行。","2026-09-30T23:12:05+08:00",[11,12,13],[11,13],6534,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10419409",{"name":20,"url":21,"day":181},16,{"path":183,"title":184,"description":185,"date":186,"updated":9,"tags":187,"categories":188,"draft":15,"wordCount":189,"readingTime":17,"canonical":190,"series":191},"\u002Fithome-2026-day-15","Day 15：搞懂 Injection Context，從 inject()、runInInjectionContext() 到 injectAsync()","前面提到 Injection Context 時，可能會讓人聯想到先前介紹過的 Reactive Context。我一開始也有點搞混，因此花了一些時間重新理解 Angular 裡這些不同的執行環境。","2026-09-29T13:44:28+08:00",[11,12,13],[11,13],6986,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10418752",{"name":20,"url":21,"day":192},15,{"path":194,"title":195,"description":196,"date":197,"updated":9,"tags":198,"categories":199,"draft":15,"wordCount":200,"readingTime":17,"canonical":201,"series":202},"\u002Fithome-2026-day-14","Day 14：Lazy Loading 不只一種，從 Router Preloading、@defer 到 injectAsync()","當 Client Side Rendering 的應用越來越大時，我們通常會開始思考，能不能把原本一次載入的內容拆得更小，等到真正需要時再下載，避免初始載入過多 JavaScript，拉長畫面呈現的時間。","2026-09-28T22:44:46+08:00",[11,12,13],[11,13],7674,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10418485",{"name":20,"url":21,"day":203},14,{"path":205,"title":206,"description":207,"date":208,"updated":9,"tags":209,"categories":210,"draft":15,"wordCount":211,"readingTime":110,"canonical":212,"series":213},"\u002Fithome-2026-day-13","Day 13：從 Router Event 到 Signal","路由狀態管理在前端開發中比較少被單獨拿出來討論，但在 Angular 裡，一次路由導航其實會經過不少階段，也會在過程中發出不同的 Router Event，例如 NavigationStart、NavigationEnd…","2026-09-27T20:37:55+08:00",[11,12,13],[11,13],7777,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10417948",{"name":20,"url":21,"day":214},13,{"path":216,"title":217,"description":218,"date":219,"updated":9,"tags":220,"categories":221,"draft":15,"wordCount":222,"readingTime":122,"canonical":223,"series":224},"\u002Fithome-2026-day-12","Day 12：從 httpResource 到 TanStack Query，認識 Server State","前面我們花了不少時間討論，為什麼「請求本身的狀態」和「元件的顯示狀態」應該分開處理。","2026-09-26T23:35:12+08:00",[11,12,13],[11,13],5119,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10417614",{"name":20,"url":21,"day":225},12,{"path":227,"title":228,"description":229,"date":230,"updated":9,"tags":231,"categories":232,"draft":15,"wordCount":233,"readingTime":122,"canonical":234,"series":235},"\u002Fithome-2026-day-11","Day 11：用 rxResource 串起 Observable 與 Resource","前面介紹了不少 Resource 到 httpResource() 的應用。不過在 Angular 開發中，Observable 與 RxJS 仍然是很常見的非同步資料處理方式，像是 switchMap、map、debo…","2026-09-25T22:42:04+08:00",[11,12,13],[11,13],4908,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10417143",{"name":20,"url":21,"day":236},11,{"path":238,"title":239,"description":240,"date":241,"updated":9,"tags":242,"categories":243,"draft":15,"wordCount":244,"readingTime":31,"canonical":245,"series":246},"\u002Fithome-2026-day-10","Day 10：linkedSignal 讓相依狀態也能被修改","昨天我們透過 httpResource() 搭配 chain() 處理兩個非同步資料之間的依賴。下游 Request 需要使用上游資料時，會等上游完成後再繼續；當 Request 的來源改變，Resource 的狀態也會…","2026-09-24T23:49:49+08:00",[11,12,13],[11,13],5623,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10416746",{"name":20,"url":21,"day":247},10,{"path":249,"title":250,"description":251,"date":252,"updated":9,"tags":253,"categories":254,"draft":15,"wordCount":255,"readingTime":134,"canonical":256,"series":257},"\u002Fithome-2026-day-09","Day 9：httpResource 實務篇，統一回覆格式與 chain 相依請求","昨天我們透過 Orval 串起 API Contract，了解如何根據 OpenAPI 規格產生前端需要的型別與 API 呼叫方式。","2026-09-23T23:42:40+08:00",[11,12,13],[11,13],4358,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10416227",{"name":20,"url":21,"day":76},{"path":259,"title":260,"description":261,"date":262,"updated":9,"tags":263,"categories":264,"draft":15,"wordCount":265,"readingTime":122,"canonical":266,"series":267},"\u002Fithome-2026-day-08","Day 8：用 Orval 串起 Angular API Contract，同時產生 HttpClient、httpResource 與 Zod","前後端在對接 API 時，常見的問題之一，就是雙方對資料格式的定義逐漸不一致。","2026-09-22T23:48:12+08:00",[11,12,13],[11,13],4451,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10415694",{"name":20,"url":21,"day":110},{"path":269,"title":270,"description":271,"date":272,"updated":9,"tags":273,"categories":274,"draft":15,"wordCount":275,"readingTime":17,"canonical":276,"series":277},"\u002Fithome-2026-day-07","Day 7：從 Resource 到 httpResource，用 Signal 管理 HTTP 資料請求","昨天我們提到，Resource API 本身是一套通用的非同步資料模型，比較適合用在「讀取資料」這類情境，而不是新增、修改或刪除資料這種 Mutation 操作。","2026-09-21T22:13:18+08:00",[11,12,13],[11,13],6735,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10415038",{"name":20,"url":21,"day":17},{"path":279,"title":280,"description":281,"date":282,"updated":9,"tags":283,"categories":284,"draft":15,"wordCount":285,"readingTime":122,"canonical":286,"series":287},"\u002Fithome-2026-day-06","Day 6：Resource API，把非同步資料帶進 Signal","今天來看 Angular Signal 裡一個很重要的非同步資料 API：Resource API。","2026-09-20T19:25:37+08:00",[11,12,13],[11,13],5054,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10414377",{"name":20,"url":21,"day":31},{"path":289,"title":290,"description":291,"date":292,"updated":9,"tags":293,"categories":294,"draft":15,"wordCount":295,"readingTime":134,"canonical":296,"series":297},"\u002Fithome-2026-day-05","Day 5：從 Reactive Graph 到 View Tree，看 Angular 如何找到真正需要更新的畫面","前面我們已經知道，當 Signal 的值發生變化後，Angular 會透過 Reactive Graph 找到受到影響的 Consumer。","2026-09-19T20:19:47+08:00",[11,12,13],[11,13],4364,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10413852",{"name":20,"url":21,"day":122},{"path":299,"title":300,"description":301,"date":302,"updated":9,"tags":303,"categories":304,"draft":15,"wordCount":305,"readingTime":122,"canonical":306,"series":307},"\u002Fithome-2026-day-04","Day 4：Angular 怎麼知道誰正在讀 Signal？從 Reactive Context 理解依賴追蹤","前面我們看過，當 Template 讀取 Signal 時，Angular 會記住「誰依賴了誰」；當 Signal 發生變化後，也會透過 Reactive Graph 通知相關的 Consumer。","2026-09-18T21:58:16+08:00",[11,12,13],[11,13],4894,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10413313",{"name":20,"url":21,"day":134},{"path":309,"title":310,"description":311,"date":312,"updated":9,"tags":313,"categories":314,"draft":15,"wordCount":315,"readingTime":122,"canonical":316,"series":317},"\u002Fithome-2026-day-03","Day 3：從 set()、update() 看懂 Angular Signal 的基本使用與更新機制","昨天我們先試著理解，在 Template 中使用 Signal() 時，Angular 是如何建立依賴關係，並在 Signal 發生變化後，知道哪些 View 可能受到影響。","2026-09-17T23:08:58+08:00",[11,12,13],[11,13],5451,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10412826",{"name":20,"url":21,"day":318},3,{"path":320,"title":321,"description":322,"date":323,"updated":9,"tags":324,"categories":325,"draft":15,"wordCount":326,"readingTime":134,"canonical":327,"series":328},"\u002Fithome-2026-day-02","Day 2：Angular Signal 是什麼？從 Change Detection 理解它的運作原理","傳統 Angular 在監測資料變化時，通常會搭配 zone.js。像是 DOM 事件、Promise、Timer、HTTP 請求這些非同步操作發生時，zone.js 會幫忙攔截。","2026-09-16T20:19:12+08:00",[11,12,13],[11,13],4276,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10411944",{"name":20,"url":21,"day":329},2,{"path":331,"title":332,"description":333,"date":334,"updated":9,"tags":335,"categories":336,"draft":15,"wordCount":337,"readingTime":329,"canonical":338,"series":339},"\u002Fithome-2026-day-01","Day 1：為什麼想聊 Angular Signal？","相信講到前端框架，大家第一時間想到的通常會是 Vue、React，甚至也有人會推薦 Svelte 這類近年討論度很高的框架。但一講到 Angular，很多人的第一印象可能就像看到一座大城堡一樣：東西很多、規則很多，一時之…","2026-09-15T23:56:26+08:00",[11,12,13],[11,13],1478,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10411425",{"name":20,"url":21,"day":340},1,{"path":342,"title":343,"description":344,"date":345,"updated":9,"tags":346,"categories":351,"draft":15,"wordCount":353,"readingTime":134,"canonical":9,"series":9},"\u002FTS-Excess-Property-Checks","TypeScript 踩坑筆記：物件字面量的多餘屬性檢查機制","深入探討 TypeScript 的多餘屬性檢查（Excess Property Checks）機制，解析物件字面量與變數賦值的型別檢查差異，並提供實務開發中避免型別陷阱的最佳實踐方法。","2026-01-31T16:29:23+08:00",[347,348,349,350],"Excess Property Checks","Structural Typing","Type Safety","NestJS",[352],"TypeScript",3551,{"path":355,"title":356,"description":357,"date":358,"updated":9,"tags":359,"categories":361,"draft":15,"wordCount":363,"readingTime":329,"canonical":364,"series":365},"\u002Fithome-2025-day-30","Day 30：開發之旅完結 - 感謝與展望","終於來到鐵人賽的最後一天！這是我第二次參加鐵人賽，今年的主題是 LINE Bot 開發。這個主題源自於我參加的十二週讀書會分享，當時我發現大家對 LINE Bot 很感興趣，而我自己也一直很喜歡這個主題，於是早在六月就定…","2025-10-13T20:11:12+08:00",[11,360],"2025 鐵人賽",[11,362],"Line Bot",1751,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10396850",{"name":366,"url":367,"day":22},"2025 iThome 鐵人賽：Line Bot × NestJS：30 天開發日記","https:\u002F\u002Fithelp.ithome.com.tw\u002Fusers\u002F20116554\u002Fironman\u002F8779",{"path":369,"title":370,"description":371,"date":372,"updated":9,"tags":373,"categories":376,"draft":15,"wordCount":377,"readingTime":31,"canonical":378,"series":379},"\u002Fithome-2025-day-29","Day 29：LIFF 會員註冊 - 信箱驗證與 Swagger 文件整合","延續 Day 28 會員註冊的流程，在實際的會員註冊場景中，電子信箱驗證是確保用戶身份真實性的重要環節。本篇將基於昨天的註冊流程，新增兩個核心 API：發送驗證信與驗證驗證碼，讓會員註冊功能更加完整且安全。","2025-10-12T23:15:00+08:00",[11,360,362,374,350,375],"LIFF","Swagger",[11,362],6089,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10396512",{"name":366,"url":367,"day":34},{"path":381,"title":382,"description":383,"date":384,"updated":9,"tags":385,"categories":386,"draft":15,"wordCount":387,"readingTime":122,"canonical":388,"series":389},"\u002Fithome-2025-day-28","Day 28：LIFF 會員註冊 - ID Token 驗證與資料庫整合","今天的開發重點是建立會員卡系統，將 LIFF 前端與 NestJS 後端完整串接。","2025-10-11T22:57:29+08:00",[11,360,362,374,350],[11,362],5254,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10396146",{"name":366,"url":367,"day":45},{"path":391,"title":392,"description":393,"date":394,"updated":9,"tags":395,"categories":396,"draft":15,"wordCount":397,"readingTime":318,"canonical":398,"series":399},"\u002Fithome-2025-day-27","Day 27：群組事件與檔案訊息接收","今天主要補充 LINE Bot 在群組中的專屬特性，包括群組限定的 Webhook 事件，以及前面提到但尚未說明的第 7 種訊息類型 file 檔案訊息。","2025-10-10T21:01:52+08:00",[11,360,362,350],[11,362],2888,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10395785",{"name":366,"url":367,"day":56},{"path":401,"title":402,"description":403,"date":404,"updated":9,"tags":405,"categories":407,"draft":15,"wordCount":408,"readingTime":122,"canonical":409,"series":410},"\u002Fithome-2025-day-26","Day 26：LINE Pay 線上付款","LINE Pay 提供兩種付款方式：線上付款與實體付款。實體付款主要採用店家出示條碼的模式，顧客掃描後即可輸入金額完成付款。這兩種付款方式都支援在沙盒(Sandbox)環境中進行測試。本文將著重說明線上付款的整合流程。","2025-10-09T23:39:32+08:00",[11,360,406],"Line Pay",[11,362],4876,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10395481",{"name":366,"url":367,"day":67},{"path":412,"title":413,"description":414,"date":415,"updated":9,"tags":416,"categories":417,"draft":15,"wordCount":418,"readingTime":318,"canonical":419,"series":420},"\u002Fithome-2025-day-25","Day 25：優惠券設定與 Coupon Message 實作","LINE Official Account 的「優惠券」是提升顧客互動與忠誠度的重要功能。透過獎勵機制，不僅能吸引新客，更能有效促進回購。","2025-10-08T23:49:32+08:00",[11,360,362,350],[11,362],3207,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10395076",{"name":366,"url":367,"day":79},{"path":422,"title":423,"description":424,"date":425,"updated":9,"tags":426,"categories":427,"draft":15,"wordCount":428,"readingTime":134,"canonical":429,"series":430},"\u002Fithome-2025-day-24","Day 24：LIFF 刮刮樂實戰體驗","在了解 LIFF 的基礎設計流程後，本文將透過「刮刮樂」案例示範 LIFF API 的實際應用。從啟動時檢查權限與執行環境、確認用戶分享功能權限，到刮刮樂結束後發送訊息並關閉 LIFF，完整呈現 LIFF 在互動應用中的…","2025-10-07T22:36:58+08:00",[11,360,362,374],[11,362],4200,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10394618",{"name":366,"url":367,"day":90},{"path":432,"title":433,"description":434,"date":435,"updated":9,"tags":436,"categories":437,"draft":15,"wordCount":438,"readingTime":134,"canonical":439,"series":440},"\u002Fithome-2025-day-23","Day 23：LIFF 網頁應用開發入門","在鐵人賽前半段，我們深入探討了 LINE Bot 的兩大核心功能：Richmenu(選單設置)與各種 Reply Message(回覆訊息)的訊息類型。然而在實務應用中，若要提供更豐富的互動體驗，Line 往往需要搭配 …","2025-10-06T23:06:57+08:00",[11,360,362,374],[11,362],4400,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10394035",{"name":366,"url":367,"day":101},{"path":442,"title":443,"description":444,"date":445,"updated":9,"tags":446,"categories":447,"draft":15,"wordCount":448,"readingTime":329,"canonical":449,"series":450},"\u002Fithome-2025-day-22","Day 22：Render 雲端平台部署 Nest 後端伺服器","今天的目標是將系統正式上線。經過這段時間的開發，我們已完成 Line Message API 的核心功能與日誌處理機制。","2025-10-05T22:52:11+08:00",[11,360,362,350],[11,362],1895,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10393809",{"name":366,"url":367,"day":113},{"path":452,"title":453,"description":454,"date":455,"updated":9,"tags":456,"categories":457,"draft":15,"wordCount":458,"readingTime":318,"canonical":459,"series":460},"\u002Fithome-2025-day-21","Day 21：Nest Pino 整合 Grafana Loki 日誌","Loki 環境變數可參考 Day 20 文章的 Grafana Data Source settings 設定","2025-10-04T17:24:26+08:00",[11,360,362,350],[11,362],2740,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10393305",{"name":366,"url":367,"day":125},{"path":462,"title":463,"description":464,"date":465,"updated":9,"tags":466,"categories":467,"draft":15,"wordCount":468,"readingTime":318,"canonical":469,"series":470},"\u002Fithome-2025-day-20","Day 20：Grafana Loki 日誌服務 - 從申請到 API 串接測試","目前已經理解了 LINE Messaging API 的核心功能，包括如何接收訊息、串接第三方服務，以及發送多種類型的訊息。接下來，我們將把原本架設在 ngrok 的後端伺服器，透過 GitHub 自動化部署到 Rend…","2025-10-03T23:16:16+08:00",[11,360,362,350],[11,362],2461,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10392910",{"name":366,"url":367,"day":137},{"path":472,"title":473,"description":474,"date":475,"updated":9,"tags":476,"categories":477,"draft":15,"wordCount":478,"readingTime":318,"canonical":479,"series":480},"\u002Fithome-2025-day-19","Day 19：Flex Message Carousel 食譜分享","Flex Message 可以分成 bubble(單張卡片) 跟 carousel(多張卡片輪播) 兩種方式，昨天示範了 bubble 格式的電子個人名片後，今天主要展示 carousel 的應用，兩者的基本結構大致相同…","2025-10-02T16:06:17+08:00",[11,360,362,350],[11,362],2267,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10392256",{"name":366,"url":367,"day":148},{"path":482,"title":483,"description":484,"date":485,"updated":9,"tags":486,"categories":487,"draft":15,"wordCount":488,"readingTime":122,"canonical":489,"series":490},"\u002Fithome-2025-day-18","Day 18：Flex Message 設計個人名片","從基礎的文字互動開始，我們逐步探索了六大核心訊息類型的發送機制、Template Message 的結構化設計，以及 ImageMap Message 的互動式體驗。今天，我們將進入 LINE Bot 最具彈性的訊息格式…","2025-10-01T17:57:47+08:00",[11,360,362,350],[11,362],4468,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10391723",{"name":366,"url":367,"day":159},{"path":492,"title":493,"description":494,"date":495,"updated":9,"tags":496,"categories":497,"draft":15,"wordCount":498,"readingTime":122,"canonical":499,"series":500},"\u002Fithome-2025-day-17","Day 17：ImageMap Message  從互動海報到影片嵌入","在 Day 16 文章中，我們使用 Cloudflare Workers 實作了圖片代理功能。到目前為止，我們已經完成以下準備工作:","2025-09-30T11:58:32+08:00",[11,360,362,350],[11,362],4807,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10391164",{"name":366,"url":367,"day":170},{"path":502,"title":503,"description":504,"date":505,"updated":9,"tags":506,"categories":507,"draft":15,"wordCount":508,"readingTime":134,"canonical":509,"series":510},"\u002Fithome-2025-day-16","Day 16：Cloudflare Workers 圖片代理實作","在 Day 15 文章中，我們處理了 ImageMap Message 的背景圖，接著我們遇到了圖片不能出現副檔名及動態路徑支援不同解析度的問題。今天主要會透過 Cloudflare Workers 來解決這兩個問題，讓…","2025-09-29T16:15:41+08:00",[11,360,362,350],[11,362],3412,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10390567",{"name":366,"url":367,"day":181},{"path":512,"title":513,"description":514,"date":515,"updated":9,"tags":516,"categories":517,"draft":15,"wordCount":518,"readingTime":134,"canonical":519,"series":520},"\u002Fithome-2025-day-15","Day 15：共通屬性處理優化及 Imagemap  圖片製作","針對 Day 14 的程式碼架構進行優化。由於 Sender 和 Quick Reply 功能在所有回覆訊息類型中都能使用，我們應該將這些共用屬性抽取為獨立函數進行統一處理。","2025-09-28T21:03:38+08:00",[11,360,362,350],[11,362],4033,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10389697",{"name":366,"url":367,"day":192},{"path":522,"title":523,"description":524,"date":525,"updated":9,"tags":526,"categories":527,"draft":15,"wordCount":528,"readingTime":31,"canonical":529,"series":530},"\u002Fithome-2025-day-14","Day 14：LINE Bot Template Message 訊息回覆","經過前幾天的學習，我們已經成功掌握了 LINE Bot 六大基礎訊息類型的發送技巧，為訊息互動奠定了穩固的基礎。今天，我們將踏入更具挑戰性的進階應用領域！","2025-09-27T15:54:06+08:00",[11,360,362,350],[11,362],6372,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10388976",{"name":366,"url":367,"day":203},{"path":532,"title":533,"description":534,"date":535,"updated":9,"tags":536,"categories":537,"draft":15,"wordCount":538,"readingTime":122,"canonical":539,"series":540},"\u002Fithome-2025-day-13","Day 13：LINE Bot 客製化 Sender 與 Quick Reply 功能實作","LINE Bot 所有回覆訊息類型都具備「共用屬性」功能，這些屬性帶來兩項重要的互動體驗提升：","2025-09-26T11:41:34+08:00",[11,360,362,350],[11,362],4426,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10388037",{"name":366,"url":367,"day":214},{"path":542,"title":543,"description":544,"date":545,"updated":9,"tags":546,"categories":547,"draft":15,"wordCount":548,"readingTime":318,"canonical":549,"series":550},"\u002Fithome-2025-day-12","Day 12：LINE Bot Image、Video、Audio、Location 訊息回覆","Day 11 文章中，我們針對 LINE Bot 可以回覆的Text及Sticker基礎型別進行了封裝，不僅新增了 line-message.ts模組，還讓開發者可以用最少的參數產生 LINE Message 所需要的格…","2025-09-25T18:08:09+08:00",[11,360,362,350],[11,362],2977,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10387598",{"name":366,"url":367,"day":225},{"path":552,"title":553,"description":554,"date":555,"updated":9,"tags":556,"categories":557,"draft":15,"wordCount":558,"readingTime":31,"canonical":559,"series":560},"\u002Fithome-2025-day-11","Day 11：LINE Bot Text Emoji 與 Sticker 訊息回覆","目前我們的 LINE Bot 主要使用 Text 方式回覆訊息。今天將探討 Text 類型的 Emoji 應用，以及 Sticker 回覆方式，基於 Day 8 版本進行改寫。","2025-09-24T23:21:11+08:00",[11,360,350,362],[11,362],5659,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10386993",{"name":366,"url":367,"day":236},{"path":562,"title":563,"description":564,"date":565,"updated":9,"tags":566,"categories":567,"draft":15,"wordCount":568,"readingTime":318,"canonical":569,"series":570},"\u002Fithome-2025-day-10","Day 10：LINE Rich Menu Switch Action 提升使用者體驗","在 Day 9 文章中，我們結合 LINE 平台的功能，將天氣服務與圖片上傳服務整合，打造出第一張 LINE 圖文選單，透過 URI action 的方式觸發平台提供的互動效果。接著，我們使用客製化選單製作出 9 格的客…","2025-09-23T15:02:57+08:00",[11,360,362,350],[11,362],2906,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10386165",{"name":366,"url":367,"day":247},{"path":572,"title":573,"description":574,"date":575,"updated":9,"tags":576,"categories":577,"draft":15,"wordCount":578,"readingTime":318,"canonical":579,"series":580},"\u002Fithome-2025-day-09","Day  9：打造 LINE Rich Menu - 後台設計 vs API 客製化","在 Day8 文章中，我們透過整合雲端服務 Cloudinary，學習如何處理使用者上傳的圖片檔案，並將其儲存至雲端。然而，LINE Bot 除了讓使用者輸入文字回覆的方式之外，更常見的是透過圖文選單(Rich Menu…","2025-09-22T21:54:25+08:00",[11,360,362,350],[11,362],3285,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10385658",{"name":366,"url":367,"day":76},{"path":582,"title":583,"description":584,"date":585,"updated":9,"tags":586,"categories":587,"draft":15,"wordCount":588,"readingTime":17,"canonical":589,"series":590},"\u002Fithome-2025-day-08","Day 8：Cloudinary 雲端圖片儲存整合","在 Day 6 中，我們透過整合 OpenWeatherMap API 與座標位置訊息學習了如何結合第三方服務。今天將探索 Cloudinary 雲端服務，解決 LINE 圖片資源會過期的問題，學習如何透過 LINE M…","2025-09-21T23:13:19+08:00",[11,360,362,350],[11,362],7215,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10384968",{"name":366,"url":367,"day":110},{"path":592,"title":593,"description":594,"date":595,"updated":9,"tags":596,"categories":597,"draft":15,"wordCount":598,"readingTime":122,"canonical":599,"series":600},"\u002Fithome-2025-day-07","Day 7：Joi 環境變數統一驗證，重構 LINE Bot 天氣服務模組","在 Day 6 開發 LINE Bot 結合 OpenWeatherMap API 的過程中，我們採用私有方法將 API 請求處理與資料格式化整合在一起。今天將對 Day 6 的實作進行架構重構，主要目標是建立更完善的環…","2025-09-20T23:07:08+08:00",[11,360,362,350],[11,362],5157,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10384302",{"name":366,"url":367,"day":17},{"path":602,"title":603,"description":604,"date":605,"updated":9,"tags":606,"categories":607,"draft":15,"wordCount":608,"readingTime":134,"canonical":609,"series":610},"\u002Fithome-2025-day-06","Day 6：整合第三方 API 天氣查詢服務","Day 5 帶大家了解 LINE Bot 能接收使用者傳遞的「6+1」種訊息類型。之所以這樣強調，是因為 File 類型僅能在群組聊天中使用，這個限制我自己也經常忘記，所以習慣用「6+1」來提醒自己。","2025-09-19T21:07:47+08:00",[11,360,362,350],[11,362],3892,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10383636",{"name":366,"url":367,"day":31},{"path":612,"title":613,"description":614,"date":615,"updated":9,"tags":616,"categories":617,"draft":15,"wordCount":618,"readingTime":122,"canonical":619,"series":620},"\u002Fithome-2025-day-05","Day 5：整合 Pino Logger 提升 LINE Bot 專案的可維護性","看著專案逐漸成型，現在該開始重視日誌記錄的規劃了。在實際部署時，我們通常會區分 develop(開發環境)和 production(正式環境)兩種不同的執行環境，針對不同環境採用相應的日誌策略。","2025-09-18T23:30:00+08:00",[11,360,362,350],[11,362],4746,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10382298",{"name":366,"url":367,"day":122},{"path":622,"title":623,"description":624,"date":625,"updated":9,"tags":626,"categories":627,"draft":15,"wordCount":628,"readingTime":31,"canonical":629,"series":630},"\u002Fithome-2025-day-04","Day 4：掌握 LINE Bot 七種訊息類型與 NestJS 架構優化","目前我們都只使用 LINE Message Event 中的純文字(text)格式進行回覆，但除了純文字之外，LINE Bot 後端伺服器其實可以接收多種不同類型的訊息。今天就讓我們一起來深入了解這些訊息類型吧！","2025-09-17T22:53:37+08:00",[11,360,362,350],[11,362],5828,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10381651",{"name":366,"url":367,"day":134},{"path":632,"title":633,"description":634,"date":635,"updated":9,"tags":636,"categories":637,"draft":15,"wordCount":638,"readingTime":122,"canonical":639,"series":640},"\u002Fithome-2025-day-03","Day 3：Webhook 簽章驗證與訊息回覆策略(Push & Reply)","上一篇帶大家透過「Webhook 模式」成功架設了專屬的 LINE Bot 代理人。相信大家在體驗基礎功能後，對於 LINE Bot Webhook 還能監聽哪些事件、支援哪些類型的訊息回覆，以及如何確保後端收到的訊息確…","2025-09-16T21:53:39+08:00",[11,360,362,350],[11,362],5360,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10381303",{"name":366,"url":367,"day":318},{"path":642,"title":643,"description":644,"date":645,"updated":9,"tags":646,"categories":647,"draft":15,"wordCount":648,"readingTime":31,"canonical":649,"series":650},"\u002Fithome-2025-day-02","Day 2：從 Webhook 到後端，打造你的專屬機器人","上一篇，帶大家透過「Chat 模式」，讓自身變成客服機器人的方式。這篇會從「Webhook 模式」切入，並以 NestJS 作為後端框架，教你如何在休息時間，也能讓後端伺服器當你的替身幫你解惑使用者的問題。","2025-09-15T21:20:49+08:00",[11,360,362,350],[11,362],6590,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10380524",{"name":366,"url":367,"day":329},{"path":652,"title":653,"description":654,"date":655,"updated":9,"tags":656,"categories":657,"draft":15,"wordCount":658,"readingTime":318,"canonical":659,"series":660},"\u002Fithome-2025-day-01","Day 1：Hello World LINE Bot","每個程式語言的開始通常都會以練習 Hello World！作為一個簡單的起手式，LINE Bot 也不意外。這一系列會著重在 LINE Bot 的相關應用，帶大家用輕鬆的方式一起建立屬於自己的 Line Bot 聊天機器…","2025-09-14T22:48:33+08:00",[11,360,362,350],[11,362],2723,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10379895",{"name":366,"url":367,"day":340},{"path":662,"title":663,"description":664,"date":665,"updated":9,"tags":666,"categories":671,"draft":15,"wordCount":674,"readingTime":134,"canonical":9,"series":9},"\u002Fdbdiagram-tool","關聯式資料庫設計必備 - dbdiagram.io ERD 繪圖工具","還在煩惱如何設計關聯式資料表實體關聯圖嗎？ 使用 dbdiagram.io 加快你與同事之間的距離","2024-11-05T20:18:24+08:00",[667,668,669,670],"ERD","dbdiagram.io","DBML","資料庫設計",[672,673],"Database","開發工具",3982,{"path":676,"title":677,"description":678,"date":679,"updated":9,"tags":680,"categories":687,"draft":15,"wordCount":690,"readingTime":122,"canonical":9,"series":9},"\u002FPostgreSQL-1","前端勇士大闖六角後端體驗營 - 初探 PostgreSQL DML 語法","初步踏入後端的世界，了解何謂後端以及資料庫常見語法 DDL、DML。","2024-10-30T22:43:49+08:00",[681,682,683,684,685,686],"PostgreSQL","SQL","DML","DDL","資料庫","六角學院",[672,688,689],"後端實戰","學習心得",5220,{"path":692,"title":693,"description":694,"date":695,"updated":9,"tags":696,"categories":700,"draft":15,"wordCount":703,"readingTime":329,"canonical":9,"series":9},"\u002Fcss-flex-1","CSS flex 軸線對齊技巧 - 預設屬性","CSS flex 排版技巧你都了解了嗎？回歸學習初心的認識 flex 預設屬性","2024-10-24T20:29:08+08:00",[697,698,699],"Flexbox","前端排版","切版技巧",[701,702],"CSS","前端開發",1856,{"path":705,"title":706,"description":707,"date":708,"updated":9,"tags":709,"categories":712,"draft":15,"wordCount":714,"readingTime":329,"canonical":715,"series":716},"\u002Fithome-2024-day-30","Vue 3 用實作帶你看過核心概念 - Day 30：新手村的鐵人證書 - 完賽心得","花了整整半年左右的時間，每天下班都很用心的準備範例或是看書，這一段旅程對我來說真的很重要。擔心、害怕跟不安的心情一直充斥自己心中，擔心寫錯或是寫不好，想讓自己再多準備久一點再開始，所以拖到中秋連假才開始，想下定決心讓自己…","2024-10-13T12:42:25+08:00",[11,710,711],"2024 鐵人賽","Vue 3",[11,713],"Vue",1381,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10367206",{"name":717,"url":718,"day":22},"2024 iThome 鐵人賽：Vue 3 初學者：用實作帶你看過核心概念","https:\u002F\u002Fithelp.ithome.com.tw\u002Fusers\u002F20116554\u002Fironman\u002F7800",{"path":720,"title":721,"description":722,"date":723,"updated":9,"tags":724,"categories":727,"draft":15,"wordCount":728,"readingTime":134,"canonical":729,"series":730},"\u002Fithome-2024-day-29","Vue 3 用實作帶你看過核心概念 - Day 29：Composables(組合式函數)","Composables是 Vue 3 中的一個重要概念，它是利用 Vue 的 Composition API 來創建和管理可重用的有狀態邏輯的函數。Composables 允許我們將組件邏輯抽象成可重用的函數，使得代碼更…","2024-10-12T15:07:55+08:00",[11,710,711,725,726],"Options API","Composition API",[11,713],4233,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10366865",{"name":717,"url":718,"day":34},{"path":732,"title":733,"description":734,"date":735,"updated":9,"tags":736,"categories":738,"draft":15,"wordCount":739,"readingTime":134,"canonical":740,"series":741},"\u002Fithome-2024-day-28","Vue 3 用實作帶你看過核心概念 - Day 28：官方 Vue Router 的應用與技巧","路由設定方式，一般可以分成兩種：","2024-10-11T17:14:44+08:00",[11,710,711,725,737],"Vue Router",[11,713],4095,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10366520",{"name":717,"url":718,"day":45},{"path":743,"title":744,"description":745,"date":746,"updated":9,"tags":747,"categories":748,"draft":15,"wordCount":749,"readingTime":122,"canonical":750,"series":751},"\u002Fithome-2024-day-27","Vue 3 用實作帶你看過核心概念 - Day 27：VeeValidate 表單驗證工具","在開發 Vue 應用程式時，表單驗證至關重要，它能確保使用者輸入的資料符合預期的格式和要求。今天來介紹一款專門用於 Vue 的表單驗證工具—VeeValidate v4。這個工具不僅能幫助開發者輕鬆實現表單驗證，還提供了…","2024-10-10T21:02:16+08:00",[11,710,711,725],[11,713],4461,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10366165",{"name":717,"url":718,"day":56},{"path":753,"title":754,"description":755,"date":756,"updated":9,"tags":757,"categories":758,"draft":15,"wordCount":759,"readingTime":318,"canonical":760,"series":761},"\u002Fithome-2024-day-26","Vue 3 用實作帶你看過核心概念 - Day 26：KeepAlive 與 Teleport 內置組件","預設情況下，切換組件會導致組件的創建及銷毀，無法保持組件內部的狀態。","2024-10-09T18:50:53+08:00",[11,710,711,725],[11,713],3158,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10365724",{"name":717,"url":718,"day":67},{"path":763,"title":764,"description":765,"date":766,"updated":9,"tags":767,"categories":768,"draft":15,"wordCount":769,"readingTime":318,"canonical":770,"series":771},"\u002Fithome-2024-day-25","Vue 3 用實作帶你看過核心概念 - Day 25：自定義指令(Custom Directives)","Vue不僅提供了豐富的內置指令用於操作DOM元素，還允許開發者創建自定義指令。透過自定義指令，我們可以對DOM元素進行更細緻的控制，並在指令的不同生命週期階段執行特定的邏輯，從而實現更靈活的功能擴展。","2024-10-08T22:05:32+08:00",[11,710,711,725],[11,713],3116,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10365355",{"name":717,"url":718,"day":79},{"path":773,"title":774,"description":775,"date":776,"updated":9,"tags":777,"categories":778,"draft":15,"wordCount":779,"readingTime":329,"canonical":780,"series":781},"\u002Fithome-2024-day-24","Vue 3 用實作帶你看過核心概念 - Day 24：異步加載(Lazy loading)","在大型項目中，我們通常需要將應用拆分為更小的代碼模塊，並僅在需要時才從服務器加載相關組件，以減少初次加載的資源量。Vue 提供了 defineAsyncComponent 方法來實現組件的異步加載，這樣可以有效提高應用的…","2024-10-07T20:28:27+08:00",[11,710,711,725],[11,713],2171,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10364861",{"name":717,"url":718,"day":90},{"path":783,"title":784,"description":785,"date":786,"updated":9,"tags":787,"categories":788,"draft":15,"wordCount":789,"readingTime":318,"canonical":790,"series":791},"\u002Fithome-2024-day-23","Vue 3 用實作帶你看過核心概念 - Day 23：依賴注入( Provide-Inject )","在Dayxx中提到過，父子組件之間的數據傳遞可以通過props來實現。然而，當祖孫層組件需要進行數據傳遞時，中間層級的組件可能並不需要這個props，但卻不得不為了使子組件獲取數據而被迫傳遞。","2024-10-06T15:14:51+08:00",[11,710,711,725],[11,713],3183,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10364252",{"name":717,"url":718,"day":101},{"path":793,"title":794,"description":795,"date":796,"updated":9,"tags":797,"categories":798,"draft":15,"wordCount":799,"readingTime":134,"canonical":800,"series":801},"\u002Fithome-2024-day-22","Vue 3 用實作帶你看過核心概念 - Day 22：v-slot 插槽使用","先前Day 18中提到父組件可以通過props將參數資料傳遞給子組件進行渲染，這樣可以有效地將資料處理與畫面渲染的工作分開。然而，當我們需要更加客製化的呈現內容，由父組件來控制子組件的部分顯示時，可以使用v-slot 指…","2024-10-05T12:32:51+08:00",[11,710,711,725],[11,713],4292,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10363713",{"name":717,"url":718,"day":113},{"path":803,"title":804,"description":805,"date":806,"updated":9,"tags":807,"categories":808,"draft":15,"wordCount":809,"readingTime":329,"canonical":810,"series":811},"\u002Fithome-2024-day-21","Vue 3 用實作帶你看過核心概念 - Day 21： 組件透傳屬性(Attributes)的應用","當父組件向子組件傳遞屬性或監聽器，而這些屬性未在子組件中定義為props或emits時，它們會自動繼承並附加到子組件的根元素上，常見的屬性包括class、style、id等。這些屬性可以透過$attrs屬性訪問並進行操作…","2024-10-04T22:42:54+08:00",[11,710,711,725],[11,713],2146,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10363469",{"name":717,"url":718,"day":125},{"path":813,"title":814,"description":815,"date":816,"updated":9,"tags":817,"categories":818,"draft":15,"wordCount":819,"readingTime":122,"canonical":820,"series":821},"\u002Fithome-2024-day-20","Vue 3 用實作帶你看過核心概念 - Day 20：組件使用 v-model 雙向綁定","在Day 13中，我們介紹了表單元素（例如輸入框）如何處理數據雙向綁定。當需要將表單元素與一個響應式變數綁定時，v-model提供雙向綁定功能。這代表當畫面上表單元素的變動會即時影響Vue數據，同時當Vue數據的值改變時…","2024-10-03T23:40:48+08:00",[11,710,711,725],[11,713],5191,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10362957",{"name":717,"url":718,"day":137},{"path":823,"title":824,"description":825,"date":826,"updated":9,"tags":827,"categories":828,"draft":15,"wordCount":829,"readingTime":318,"canonical":830,"series":831},"\u002Fithome-2024-day-19","Vue 3 用實作帶你看過核心概念 - Day 19：子組件向父組件發射事件 - emits","組件可以通過$emit(functionName, params)自定義事件名稱並傳遞參數。自定義事件名稱建議使用kebab-case來命名自定義事件名稱，以確保命名風格與HTML 屬性一致性。此外，自定義事件還支持事件…","2024-10-02T15:51:16+08:00",[11,710,711,725],[11,713],2877,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10362144",{"name":717,"url":718,"day":148},{"path":833,"title":834,"description":835,"date":836,"updated":9,"tags":837,"categories":838,"draft":15,"wordCount":839,"readingTime":31,"canonical":840,"series":841},"\u002Fithome-2024-day-18","Vue 3 用實作帶你看過核心概念 - Day 18：父組件向子組件傳值 - props","組件之間的傳值必須透過聲明 props 的方式，這樣可以避免與HTML的屬性(attribute)混淆。父組件傳遞參數給子組件的方式有以下兩種方式：","2024-10-01T22:28:48+08:00",[11,710,711,725],[11,713],5782,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10361721",{"name":717,"url":718,"day":159},{"path":843,"title":844,"description":845,"date":846,"updated":9,"tags":847,"categories":848,"draft":15,"wordCount":849,"readingTime":318,"canonical":850,"series":851},"\u002Fithome-2024-day-17","Vue 3 用實作帶你看過核心概念 - Day 17：組件基礎 - 全局註冊與區域註冊","在 Day 5 我們提到可以將應用拆分為根組件和多個組件實例，並將功能模塊化。","2024-09-30T23:30:10+08:00",[11,710,711,725],[11,713],2954,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10361253",{"name":717,"url":718,"day":170},{"path":853,"title":854,"description":855,"date":856,"updated":9,"tags":857,"categories":858,"draft":15,"wordCount":859,"readingTime":122,"canonical":860,"series":861},"\u002Fithome-2024-day-16","Vue 3 用實作帶你看過核心概念 - Day 16：使用 ref 屬性引用模板元素","雖然 Vue 透過模板幫助我們處理了大部分的DOM 操作，但在某些情況下，仍然需要手動操作 DOM。例如，在使用第三方套件（如 Bootstrap 的 Modal）時，或者需要調用像video.play()和video.…","2024-09-29T16:25:45+08:00",[11,710,711,725],[11,713],4608,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10360419",{"name":717,"url":718,"day":181},{"path":863,"title":864,"description":865,"date":866,"updated":9,"tags":867,"categories":868,"draft":15,"wordCount":488,"readingTime":122,"canonical":869,"series":870},"\u002Fithome-2024-day-15","Vue 3 用實作帶你看過核心概念 - Day 15：監聽器(Watchers)","在響應式狀態變化時執行特定操作，需要使用watch 監聽器。這些操作可能包含副作用 (side effects)，如發送請求、調用 API，或更新 DOM 以外的系統狀態，亦或是處理自定義的邏輯。","2024-09-28T18:30:31+08:00",[11,710,711,725],[11,713],"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10359958",{"name":717,"url":718,"day":192},{"path":872,"title":873,"description":874,"date":875,"updated":9,"tags":876,"categories":877,"draft":15,"wordCount":878,"readingTime":134,"canonical":879,"series":880},"\u002Fithome-2024-day-14","Vue 3 用實作帶你看過核心概念 - Day 14：生命週期鉤子(Lifecycle Hooks)","在 Vue 中，當一個組件創建時，它會經歷一系列的流程，這些流程決定了組件從初始化到渲染，再到最終銷毀的過程。","2024-09-27T21:57:32+08:00",[11,710,711,725],[11,713],3780,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10359419",{"name":717,"url":718,"day":203},{"path":882,"title":883,"description":884,"date":885,"updated":9,"tags":886,"categories":887,"draft":15,"wordCount":888,"readingTime":318,"canonical":889,"series":890},"\u002Fithome-2024-day-13","Vue 3 用實作帶你看過核心概念 - Day 13：v-model 雙向綁定控制 - 常用於表單輸入","表單輸入是開發中非常常見的需求，原始方式通常需要手動使用v-bind綁定表單元素的值 (value)，並透過v-on綁定input事件來監聽輸入變化。","2024-09-26T21:49:25+08:00",[11,710,711,725],[11,713],3153,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10358850",{"name":717,"url":718,"day":214},{"path":892,"title":893,"description":894,"date":895,"updated":9,"tags":896,"categories":897,"draft":15,"wordCount":898,"readingTime":134,"canonical":899,"series":900},"\u002Fithome-2024-day-12","Vue 3 用實作帶你看過核心概念 - Day 12：v-on 指令 - 事件處理","在 Vue 中，監聽 HTML DOM 元素的事件變化，可以使用v-on 指令將 JavaScript 事件處理器綁定到對應的DOM 事件上。這個指令的縮寫符號為@，例如：v-on:click，其縮寫方式為@click。","2024-09-25T21:42:59+08:00",[11,710,711,725],[11,713],3808,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10358241",{"name":717,"url":718,"day":225},{"path":902,"title":903,"description":904,"date":905,"updated":9,"tags":906,"categories":907,"draft":15,"wordCount":908,"readingTime":134,"canonical":909,"series":910},"\u002Fithome-2024-day-11","Vue 3 用實作帶你看過核心概念 - Day 11：v-for 指令的基本與進階應用","當數據類型是陣列或物件時，我們不會希望將重複的選項或元素直接硬編碼在模板中。這樣的寫法會導致代碼冗長且不具可維護性。","2024-09-24T23:11:25+08:00",[11,710,711,725],[11,713],4381,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10357705",{"name":717,"url":718,"day":236},{"path":912,"title":913,"description":914,"date":915,"updated":9,"tags":916,"categories":917,"draft":15,"wordCount":918,"readingTime":318,"canonical":919,"series":920},"\u002Fithome-2024-day-10","Vue 3 用實作帶你看過核心概念 - Day 10：條件渲染 - v-if 與 v-show 的區別與應用","開發中遇到需要處理【如果是...就要...】的情境時，Vue 提供了 v-if 指令來幫助我們根據條件進行元素的渲染。這樣可以在特定條件滿足時動態地顯示或隱藏某些元素。","2024-09-23T23:39:24+08:00",[11,710,711,725],[11,713],2827,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10357160",{"name":717,"url":718,"day":247},{"path":922,"title":923,"description":924,"date":925,"updated":9,"tags":926,"categories":927,"draft":15,"wordCount":928,"readingTime":122,"canonical":929,"series":930},"\u002Fithome-2024-day-09","Vue 3 用實作帶你看過核心概念 - Day 9：Class 與 Style 的樣式綁定","v-bind 指令通常用於綁定 HTML 屬性，但在實際開發中，最常見的應用場景之一還是綁定class和 style這兩個 HTML 屬性。","2024-09-22T15:05:53+08:00",[11,710,711,725],[11,713],4630,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10356119",{"name":717,"url":718,"day":76},{"path":932,"title":933,"description":934,"date":935,"updated":9,"tags":936,"categories":937,"draft":15,"wordCount":938,"readingTime":134,"canonical":939,"series":940},"\u002Fithome-2024-day-08","Vue 3 用實作帶你看過核心概念 - Day 8：計算屬性應用與實踐","在 Day 6 在使用 Vue 的Mustache語法時，可以用來放置表達式。不過，這邊建議避免在 Mustache 中撰寫過於複雜的邏輯。這樣的建議主要有兩個原因：","2024-09-21T21:33:29+08:00",[11,710,711,725],[11,713],4060,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10355474",{"name":717,"url":718,"day":110},{"path":942,"title":943,"description":944,"date":945,"updated":9,"tags":946,"categories":947,"draft":15,"wordCount":948,"readingTime":122,"canonical":949,"series":950},"\u002Fithome-2024-day-07","Vue 3 用實作帶你看過核心概念 - Day 7： 響應式基礎 - Options API","前面提到了模板搭配指令及 Mustache 的用法。今天則是要介紹所謂透過getter跟setter取值跟賦值的方式在 JavaScript 是怎麼做到的，這部分會跟 Vue 本身的響應式基礎有很大相關。此外，我也會帶著…","2024-09-20T23:41:42+08:00",[11,710,711],[11,713],4407,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10354781",{"name":717,"url":718,"day":17},{"path":952,"title":953,"description":954,"date":955,"updated":9,"tags":956,"categories":957,"draft":15,"wordCount":958,"readingTime":134,"canonical":959,"series":960},"\u002Fithome-2024-day-06","Vue 3 用實作帶你看過核心概念 - Day 6：數據綁定和模板(Template)","Vue 使用基於 HTML 的模板語法（Template Syntax），將 Vue 實例中的數據綁定到模板中進行顯示。根據綁定的類型不同，數據可以影響元素的內容、屬性或樣式。","2024-09-19T20:39:46+08:00",[11,710,711,725],[11,713],3402,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10354231",{"name":717,"url":718,"day":31},{"path":962,"title":963,"description":964,"date":965,"updated":9,"tags":966,"categories":967,"draft":15,"wordCount":968,"readingTime":318,"canonical":969,"series":970},"\u002Fithome-2024-day-05","Vue 3 用實作帶你看過核心概念 - Day 5：Options API vs Composition API","前面已經詳細說明了 Vue 的環境建置方式，接下來將逐步介紹 Vue 應用說明，並比較Options API與Composition API的撰寫風格。","2024-09-18T22:10:36+08:00",[11,710,711,725,726],[11,713],2902,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10353717",{"name":717,"url":718,"day":122},{"path":972,"title":973,"description":974,"date":975,"updated":9,"tags":976,"categories":977,"draft":15,"wordCount":658,"readingTime":318,"canonical":978,"series":979},"\u002Fithome-2024-day-04","Vue 3 用實作帶你看過核心概念 - Day 4：基於 Vite 建構工具的 Vue 專案結構解析","在 Day 3 的教學中，學習了如何使用 Vue 鷹架工具(Vue project scaffolding tool)來生成一個基於 Vite 環境的專案。今天，我將更進一步地解析這個專案的資料夾結構，幫助大家更好地理解…","2024-09-17T23:27:07+08:00",[11,710,711,725],[11,713],"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10352470",{"name":717,"url":718,"day":134},{"path":981,"title":982,"description":983,"date":984,"updated":9,"tags":985,"categories":986,"draft":15,"wordCount":987,"readingTime":329,"canonical":988,"series":989},"\u002Fithome-2024-day-03","Vue 3 用實作帶你看過核心概念 - Day 3：使用 Vite 建構工具搭建 Vue 專案","⭐ 需要特別注意，需要事先安裝Nodejs。若不確定是否已安裝 Nodejs 也可以開啟終端機，執行以下指令確認版本。","2024-09-16T23:29:45+08:00",[11,710,711,725],[11,713],2100,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10351398",{"name":717,"url":718,"day":318},{"path":991,"title":992,"description":993,"date":994,"updated":9,"tags":995,"categories":996,"draft":15,"wordCount":997,"readingTime":329,"canonical":998,"series":999},"\u002Fithome-2024-day-02","Vue 3 用實作帶你看過核心概念 - Day 2：命令式編程 vs 聲明式編程","還記得我們在使用純 HTML 和 JavaScript 時，如何實現按下按鈕來變更文字顏色嗎？讓我們一起回想一下什麼是命令式宣告。","2024-09-15T22:52:27+08:00",[11,710,711,725,726],[11,713],1881,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10350459",{"name":717,"url":718,"day":329},{"path":1001,"title":1002,"description":1003,"date":1004,"updated":9,"tags":1005,"categories":1006,"draft":15,"wordCount":1007,"readingTime":340,"canonical":1008,"series":1009},"\u002Fithome-2024-day-01","Vue 3 用實作帶你看過核心概念 - Day 1：前言介紹","大家好，我是 Antonio(安東尼奧)，目前是一名 Angular 的新手工程師，同時，也是一名熱愛寫程式的工程師。去年參加六角學院的 Vue 直播班，在那時候就深深著迷著 Vue 的語言，自此這半年多的時間裡，我白天…","2024-09-14T17:32:19+08:00",[11,710,711],[11,713],988,"https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10350457",{"name":717,"url":718,"day":340},{"path":1011,"title":1012,"description":1013,"date":1014,"updated":9,"tags":1015,"categories":1017,"draft":15,"wordCount":1019,"readingTime":329,"canonical":9,"series":9},"\u002Fhexschool-experience","六角學院 - 軟體工程師體驗營","這麼多線上課程? 你不想知道什麼是最吸引我的線上學習課程嗎?","2024-05-31T21:40:05+08:00",[686,1016],"軟體工程師體驗營",[689,1018],"前端成長記",1109,{"path":1021,"title":1022,"description":1023,"date":1024,"updated":9,"tags":1025,"categories":1033,"draft":15,"wordCount":1035,"readingTime":318,"canonical":9,"series":9},"\u002FJS-10","JavaScript：var、let、const之間的差異解析","var、let及const是JavaScript中宣告變數的關鍵字，它們在作用域、對於for迴圈的影響、提升 (Hoisting) 的差異及重複宣告的處理上有所不同。","2023-12-10T23:53:30+08:00",[1026,1027,1028,1029,1030,1031,1032],"ES6","var","let","const","Hoisting","Scope","TDZ",[1034,702],"JavaScript",2873,{"path":1037,"title":1038,"description":1039,"date":1040,"updated":9,"tags":1041,"categories":1048,"draft":15,"wordCount":1049,"readingTime":122,"canonical":9,"series":9},"\u002FJS-9","JavaScript：陣列的常見操作方法","掌握 JavaScript 陣列操作！從forEach、map、filter、findIndex、reduce、sort，深入了解這些方法，使你的程式碼更具靈活性和效率！","2023-12-01T15:01:06+08:00",[1042,1043,1044,1045,1046,1047],"forEach","map","filter","reduce","sort","findIndex",[1034,702],4846,{"path":1051,"title":1052,"description":1053,"date":1054,"updated":9,"tags":1055,"categories":1060,"draft":15,"wordCount":1061,"readingTime":318,"canonical":9,"series":9},"\u002FJS-8","JavaScript：ES module 匯入與匯出","使用\u003C script >標籤讓瀏覽器中的網頁能夠使用 ES 模組功能時，你了解不同的匯入及匯出方法了嗎？","2023-11-30T15:28:23+08:00",[1026,1056,1057,1058,1059],"ES Module","CommonJS","Node.js","模組化開發",[1034,702],2913,{"path":1063,"title":1064,"description":1065,"date":1066,"updated":9,"tags":1067,"categories":1070,"draft":15,"wordCount":1072,"readingTime":134,"canonical":9,"series":9},"\u002FReact-2","React：JSX 是什麼？為何在 React 中使用 JSX？","透過 JSX 語法糖，你能夠在一次 JavaScript 撰寫中包含 HTML 與 CSS 的內容","2023-11-29T16:03:40+08:00",[1068,1034,1069],"JSX","Babel",[1071,702],"React",3595,{"path":1074,"title":1075,"description":1076,"date":1077,"updated":9,"tags":1078,"categories":1081,"draft":15,"wordCount":1082,"readingTime":329,"canonical":9,"series":9},"\u002FReact-1","React：Pure Function 的概念及其在 React 中的應用","探索 Pure Function 概念及其與 React 的相互關係。","2023-11-29T15:50:17+08:00",[1034,1079,1080],"Pure Function","Functional Programming",[1071],1368,{"path":1084,"title":1085,"description":1086,"date":1087,"updated":9,"tags":1088,"categories":1093,"draft":15,"wordCount":1094,"readingTime":122,"canonical":9,"series":9},"\u002FJS-6","JavaScript：深入理解Promise的原理及實際應用","透過Promise，我們能夠有效解決JavaScript中的異步事件，使得程式碼更為清晰和可讀。","2023-11-29T14:49:18+08:00",[1089,1090,1091,1092],"Promise","AsyncAwait","Asynchronous Programming","異步處理",[1034,702],5479,{"path":1096,"title":1097,"description":1098,"date":1099,"updated":9,"tags":1100,"categories":1105,"draft":15,"wordCount":1106,"readingTime":122,"canonical":9,"series":9},"\u002FJS-5","JavaScript：物件傳參考特性(Pass by Reference)","淺拷貝(shallow copy)與深拷貝(deep copy)在JavaScript中的應用與理解","2023-11-29T09:55:50+08:00",[1101,1102,1103,1104],"Pass by Reference","Shallow Copy","Deep Copy","傳值與傳參考",[1034,702],4544,{"path":1108,"title":1109,"description":1110,"date":1111,"updated":9,"tags":1112,"categories":1118,"draft":15,"wordCount":1120,"readingTime":329,"canonical":9,"series":9},"\u002FJS-4","JavaScript：注重關注點的分離","透過關注點分離的設計方式，可顯著提高系統整體的可維護性。","2023-11-29T09:44:29+08:00",[1113,1114,1115,1116,1117],"SoC","MVC","Design Patterns","Clean Code","Refactoring",[1034,1119],"Software Engineering",1977,{"path":1122,"title":1123,"description":1124,"date":1125,"updated":9,"tags":1126,"categories":1132,"draft":15,"wordCount":1133,"readingTime":329,"canonical":9,"series":9},"\u002FJS-3","JavaScript：掌握箭頭函式，優雅簡約的程式寫作","深入解析ES6箭頭函數：揭開與傳統函式的差異。","2023-11-29T01:02:36+08:00",[1127,1128,1129,1130,1131],"Arrow Function","this","Lexical Scoping","Syntactic Sugar","Callback Function",[1034,702],2142,{"path":1135,"title":1136,"description":1137,"date":1138,"updated":9,"tags":1139,"categories":1143,"draft":15,"wordCount":1144,"readingTime":329,"canonical":9,"series":9},"\u002FJS-2","JavaScript：深入了解This的指向與應用","探索JavaScript This 的指向：深入剖析判斷的技巧。","2023-11-28T22:22:45+08:00",[1128,1140,1131,1141,1142],"Execution Context","Binding","Fundamentals",[1034,702],1963,{"path":1146,"title":1147,"description":1148,"date":1149,"updated":9,"tags":1150,"categories":1154,"draft":15,"wordCount":1155,"readingTime":340,"canonical":9,"series":9},"\u002FJS-1","JavaScript：淺談ES6常見縮寫","JavaScript ES6縮寫技巧：輕鬆簡化程式碼，提升效率！。","2023-11-28T13:38:14+08:00",[1026,1151,1152,1153],"Shorthand","Spread Operator","Object",[1034,702],818,{"path":1157,"title":1158,"description":1159,"date":1160,"updated":9,"tags":1161,"categories":1165,"draft":15,"wordCount":1166,"readingTime":340,"canonical":9,"series":9},"\u002FEmmet-1","前端開發神器：使用Emmet提升網頁開發效率","本文將介紹如何利用Emmet來大幅提高前端開發效率，讓你的編碼速度如專家般飛快。","2023-10-31T14:40:54+08:00",[1162,1163,1164],"Emmet","VSCode","HTML",[702,673],865,{"path":1168,"title":1169,"description":1170,"date":1171,"updated":9,"tags":1172,"categories":1177,"draft":15,"wordCount":1179,"readingTime":340,"canonical":9,"series":9},"\u002Fhexo-github-4","建立自己的部落格：了解Hexo指令，更換next部落格主題","今天的你跟我都是Hexo指令指揮官，讓我們將部落格造型大改造一下吧!!!","2023-10-20T14:33:38+08:00",[1173,1174,1175,1176],"Hexo","NexT","git clone","Hexo指令",[1178],"Blog",979,{"path":1181,"title":1182,"description":1183,"date":1184,"updated":9,"tags":1185,"categories":1189,"draft":15,"wordCount":1190,"readingTime":329,"canonical":9,"series":9},"\u002Fhexo-github-3","建立自己的部落格：修改Hexo設定檔中Site，查看其變化","今天的你跟我都是部落格工程師，我們一起來將網頁做一些小小的改變，有一天匯集在一起就會讓你的部落格變的與眾不同。","2023-10-18T20:50:31+08:00",[1173,1163,1186,1187,1188],"Sublime Text","YAML","SEO",[1178],1798,{"path":1192,"title":1193,"description":1194,"date":1195,"updated":9,"tags":1196,"categories":1199,"draft":15,"wordCount":1200,"readingTime":340,"canonical":9,"series":9},"\u002Fhexo-github-2","建立自己的部落格：創建Hexo Blog初始的模板","踏出那關鍵的第一步，從白紙到完整的部落格，一同見證你的部落格誕生的奇妙時刻。","2023-10-17T15:59:37+08:00",[1173,1197,1198],"Hexo-cli","hexo init",[1178],941,{"path":1202,"title":1203,"description":1204,"date":1205,"updated":9,"tags":1206,"categories":1208,"draft":15,"wordCount":1209,"readingTime":340,"canonical":9,"series":9},"\u002Fhexo-github-1","建立自己的部落格：認識Hexo及所其需工具(Nodejs & Git)","打造屬於自己風格的部落格其實不難，讓我們一步步手把手教你如何實現這個目標。","2023-10-16T08:30:27+08:00",[1173,1058,1207],"Git",[1178],790,{"id":1211,"title":593,"body":1212,"canonical":599,"categories":3210,"date":595,"description":594,"draft":15,"extension":3211,"meta":3212,"navigation":1365,"ogImage":9,"path":592,"rawbody":3213,"readingTime":122,"robots":9,"schemaOrg":9,"seo":3214,"series":3215,"sitemap":3216,"slug":3222,"stem":3223,"tags":3224,"updated":9,"wordCount":598,"__hash__":3225},"posts\u002F2025-09-20-ithome-2025-day-07.md",{"type":1213,"value":1214,"toc":3190},"minimark",[1215,1223,1227,1241,1252,1255,1260,1268,1273,1279,1538,1542,1545,1553,1557,1560,1564,1755,1759,1778,1783,1877,1881,1892,1895,1898,1959,1964,1977,1983,1996,2002,2006,2015,2018,2024,2027,2038,2042,2048,2052,2085,2090,2187,2191,2196,2201,2671,2675,2683,2688,2756,2760,2765,3170,3176,3179,3186],[1216,1217,1218],"p",{},[1219,1220],"img",{"alt":1221,"src":1222},"2025 鐵人賽背景圖","https:\u002F\u002Fres.cloudinary.com\u002Fdseg0uwc9\u002Fimage\u002Fupload\u002Fv1758378837\u002F2025%20IT%20%E9%90%B5%E4%BA%BA%E8%B3%BD\u002FDay%207%EF%BC%9AJoi%20%E7%92%B0%E5%A2%83%E8%AE%8A%E6%95%B8%E7%B5%B1%E4%B8%80%E9%A9%97%E8%AD%89%EF%BC%8C%E9%87%8D%E6%A7%8B%20LINE%20Bot%20%E5%A4%A9%E6%B0%A3%E6%9C%8D%E5%8B%99%E6%A8%A1%E7%B5%84\u002FJoi_%E7%92%B0%E5%A2%83%E8%AE%8A%E6%95%B8%E7%B5%B1%E4%B8%80%E9%A9%97%E8%AD%89_%E9%87%8D%E6%A7%8B_LINE_Bot_%E5%A4%A9%E6%B0%A3%E6%9C%8D%E5%8B%99%E6%A8%A1%E7%B5%84_ixnlre.png",[1224,1225,1226],"h2",{"id":1226},"前言",[1216,1228,1229,1230,1236,1237,1240],{},"在 ",[1231,1232,1235],"a",{"href":609,"rel":1233},[1234],"nofollow","Day 6"," 開發 LINE Bot 結合 OpenWeatherMap API 的過程中，我們採用私有方法將 API 請求處理與資料格式化整合在一起。今天將對 ",[1231,1238,1235],{"href":609,"rel":1239},[1234]," 的實作進行架構重構，主要目標是建立更完善的環境變數管理機制，同時優化服務模組的職責分離。",[1242,1243,1244],"blockquote",{},[1216,1245,1246,1247],{},"本日程式碼的",[1231,1248,1251],{"href":1249,"rel":1250},"https:\u002F\u002Fgithub.com\u002FLING-JUN-HAO\u002Fnestjs-linebot-ironman\u002Ftree\u002Fday6",[1234],"範例連結",[1253,1254],"hr",{},[1256,1257,1259],"h3",{"id":1258},"env-透過設定檔統一驗證管理","env 透過設定檔統一驗證管理",[1216,1261,1262,1263,1267],{},"傳統的 ",[1264,1265,1266],"code",{},".env 環境變數","讀取方式雖然簡單直接，但缺乏結構化的存取模式、無法進行設定值的型別驗證，以及難以確保必要環境變數的完整性，這些限制可能導致執行時期的配置錯誤。為了解決這些問題，我們可以建立一套統一的環境變數驗證管理機制。",[1269,1270,1272],"h4",{"id":1271},"step-1新增-configconfigurationts","Step 1：新增 config\u002Fconfiguration.ts",[1216,1274,1275],{},[1276,1277,1278],"strong",{},"config\u002Fconfiguration.ts：",[1280,1281,1286],"pre",{"className":1282,"code":1283,"language":1284,"meta":1285,"style":1285},"language-ts shiki shiki-themes github-light github-dark-dimmed","export default () => {\n  const config = {\n    \u002F\u002F Line Bot 相關設定\n    line: {\n      channelAccessToken: process.env.LINE_CHANNEL_ACCESS_TOKEN,\n      channelSecret: process.env.LINE_CHANNEL_SECRET,\n    },\n\n    \u002F\u002F OpenWeatherMap 相關設定\n    weather: {\n      baseUrl: process.env.WEATHER_BASE_URL,\n      apiKey: process.env.WEATHER_API_KEY,\n    },\n\n    \u002F\u002F 伺服器基本設定\n    port: process.env.PORT,\n  };\n\n  const { error, value } = configSchema.validate(config, {\n    abortEarly: false, \u002F\u002F 顯示所有錯誤，而不是第一個錯誤就停止檢查\n  });\n\n  if (error) throw new Error(`環境變數驗證錯誤: ${error.message}`);\n\n  return value;\n};\n","ts","",[1264,1287,1288,1310,1324,1330,1335,1346,1356,1361,1367,1372,1377,1387,1397,1401,1405,1410,1420,1425,1429,1461,1474,1479,1483,1521,1525,1533],{"__ignoreMap":1285},[1289,1290,1292,1296,1299,1303,1306],"span",{"class":1291,"line":340},"line",[1289,1293,1295],{"class":1294},"s7YZ4","export",[1289,1297,1298],{"class":1294}," default",[1289,1300,1302],{"class":1301},"s6WnN"," () ",[1289,1304,1305],{"class":1294},"=>",[1289,1307,1309],{"class":1308},"sYgZi"," {\n",[1289,1311,1312,1315,1319,1322],{"class":1291,"line":329},[1289,1313,1314],{"class":1294},"  const",[1289,1316,1318],{"class":1317},"sviXB"," config",[1289,1320,1321],{"class":1294}," =",[1289,1323,1309],{"class":1308},[1289,1325,1326],{"class":1291,"line":318},[1289,1327,1329],{"class":1328},"sDN9O","    \u002F\u002F Line Bot 相關設定\n",[1289,1331,1332],{"class":1291,"line":134},[1289,1333,1334],{"class":1308},"    line: {\n",[1289,1336,1337,1340,1343],{"class":1291,"line":122},[1289,1338,1339],{"class":1308},"      channelAccessToken: process.env.",[1289,1341,1342],{"class":1317},"LINE_CHANNEL_ACCESS_TOKEN",[1289,1344,1345],{"class":1308},",\n",[1289,1347,1348,1351,1354],{"class":1291,"line":31},[1289,1349,1350],{"class":1308},"      channelSecret: process.env.",[1289,1352,1353],{"class":1317},"LINE_CHANNEL_SECRET",[1289,1355,1345],{"class":1308},[1289,1357,1358],{"class":1291,"line":17},[1289,1359,1360],{"class":1308},"    },\n",[1289,1362,1363],{"class":1291,"line":110},[1289,1364,1366],{"emptyLinePlaceholder":1365},true,"\n",[1289,1368,1369],{"class":1291,"line":76},[1289,1370,1371],{"class":1328},"    \u002F\u002F OpenWeatherMap 相關設定\n",[1289,1373,1374],{"class":1291,"line":247},[1289,1375,1376],{"class":1308},"    weather: {\n",[1289,1378,1379,1382,1385],{"class":1291,"line":236},[1289,1380,1381],{"class":1308},"      baseUrl: process.env.",[1289,1383,1384],{"class":1317},"WEATHER_BASE_URL",[1289,1386,1345],{"class":1308},[1289,1388,1389,1392,1395],{"class":1291,"line":225},[1289,1390,1391],{"class":1308},"      apiKey: process.env.",[1289,1393,1394],{"class":1317},"WEATHER_API_KEY",[1289,1396,1345],{"class":1308},[1289,1398,1399],{"class":1291,"line":214},[1289,1400,1360],{"class":1308},[1289,1402,1403],{"class":1291,"line":203},[1289,1404,1366],{"emptyLinePlaceholder":1365},[1289,1406,1407],{"class":1291,"line":192},[1289,1408,1409],{"class":1328},"    \u002F\u002F 伺服器基本設定\n",[1289,1411,1412,1415,1418],{"class":1291,"line":181},[1289,1413,1414],{"class":1308},"    port: process.env.",[1289,1416,1417],{"class":1317},"PORT",[1289,1419,1345],{"class":1308},[1289,1421,1422],{"class":1291,"line":170},[1289,1423,1424],{"class":1308},"  };\n",[1289,1426,1427],{"class":1291,"line":159},[1289,1428,1366],{"emptyLinePlaceholder":1365},[1289,1430,1431,1433,1436,1439,1442,1445,1448,1451,1454,1458],{"class":1291,"line":148},[1289,1432,1314],{"class":1294},[1289,1434,1435],{"class":1308}," { ",[1289,1437,1438],{"class":1317},"error",[1289,1440,1441],{"class":1308},", ",[1289,1443,1444],{"class":1317},"value",[1289,1446,1447],{"class":1308}," } ",[1289,1449,1450],{"class":1294},"=",[1289,1452,1453],{"class":1308}," configSchema.",[1289,1455,1457],{"class":1456},"sPO5f","validate",[1289,1459,1460],{"class":1308},"(config, {\n",[1289,1462,1463,1466,1469,1471],{"class":1291,"line":137},[1289,1464,1465],{"class":1308},"    abortEarly: ",[1289,1467,1468],{"class":1317},"false",[1289,1470,1441],{"class":1308},[1289,1472,1473],{"class":1328},"\u002F\u002F 顯示所有錯誤，而不是第一個錯誤就停止檢查\n",[1289,1475,1476],{"class":1291,"line":125},[1289,1477,1478],{"class":1308},"  });\n",[1289,1480,1481],{"class":1291,"line":113},[1289,1482,1366],{"emptyLinePlaceholder":1365},[1289,1484,1485,1488,1491,1494,1497,1500,1503,1507,1509,1512,1515,1518],{"class":1291,"line":101},[1289,1486,1487],{"class":1294},"  if",[1289,1489,1490],{"class":1308}," (error) ",[1289,1492,1493],{"class":1294},"throw",[1289,1495,1496],{"class":1294}," new",[1289,1498,1499],{"class":1456}," Error",[1289,1501,1502],{"class":1308},"(",[1289,1504,1506],{"class":1505},"s-HuK","`環境變數驗證錯誤: ${",[1289,1508,1438],{"class":1308},[1289,1510,1511],{"class":1505},".",[1289,1513,1514],{"class":1308},"message",[1289,1516,1517],{"class":1505},"}`",[1289,1519,1520],{"class":1308},");\n",[1289,1522,1523],{"class":1291,"line":90},[1289,1524,1366],{"emptyLinePlaceholder":1365},[1289,1526,1527,1530],{"class":1291,"line":79},[1289,1528,1529],{"class":1294},"  return",[1289,1531,1532],{"class":1308}," value;\n",[1289,1534,1535],{"class":1291,"line":67},[1289,1536,1537],{"class":1308},"};\n",[1269,1539,1541],{"id":1540},"step-2安裝-joi-套件","Step 2：安裝 joi 套件",[1216,1543,1544],{},"Joi 是一個的 JavaScript 資料驗證函式庫，用來定義和驗證物件的結構規則。透過宣告 Schema 定義，可以確保資料符合預期的格式和約束條件，適合用於環境變數驗證、API 輸入檢查等場景。",[1280,1546,1551],{"className":1547,"code":1549,"language":1550},[1548],"language-text","pnpm install --save joi\n","text",[1264,1552,1549],{"__ignoreMap":1285},[1269,1554,1556],{"id":1555},"step-3定義-joi-schema-驗證環境變數","Step 3：定義 joi schema 驗證環境變數",[1216,1558,1559],{},"透過服務分組架構，將環境變數依所屬服務進行物件化管理。這種結構化配置能精確控制參數的必填與選填屬性，並在啟動時完成型別檢查與格式驗證，確保在服務運行前發現並修正配置問題，避免執行時才發現環境變數設定錯誤。",[1216,1561,1562],{},[1276,1563,1278],{},[1280,1565,1567],{"className":1282,"code":1566,"language":1284,"meta":1285,"style":1285},"const configSchema = Joi.object({\n  \u002F\u002F Line Bot 相關設定\n  line: Joi.object({\n    channelAccessToken: Joi.string().required(), \u002F\u002F 字串且必填\n    channelSecret: Joi.string().required(), \u002F\u002F 字串且必填\n  }).required(), \u002F\u002F 必填\n\n  \u002F\u002F OpenWeatherMap 相關設定\n  weather: Joi.object({\n    baseUrl: Joi.string().uri().required(), \u002F\u002F uri 格式且必填\n    apiKey: Joi.string().required(), \u002F\u002F 字串且必填\n  }).required(), \u002F\u002F 必填\n\n  \u002F\u002F 伺服器基本設定\n  port: Joi.number().port().default(3000), \u002F\u002F 數字且是有效的端口號，預設值是 3000\n});\n",[1264,1568,1569,1587,1592,1601,1621,1636,1648,1652,1657,1666,1687,1702,1712,1716,1721,1750],{"__ignoreMap":1285},[1289,1570,1571,1573,1576,1578,1581,1584],{"class":1291,"line":340},[1289,1572,1029],{"class":1294},[1289,1574,1575],{"class":1317}," configSchema",[1289,1577,1321],{"class":1294},[1289,1579,1580],{"class":1308}," Joi.",[1289,1582,1583],{"class":1456},"object",[1289,1585,1586],{"class":1308},"({\n",[1289,1588,1589],{"class":1291,"line":329},[1289,1590,1591],{"class":1328},"  \u002F\u002F Line Bot 相關設定\n",[1289,1593,1594,1597,1599],{"class":1291,"line":318},[1289,1595,1596],{"class":1308},"  line: Joi.",[1289,1598,1583],{"class":1456},[1289,1600,1586],{"class":1308},[1289,1602,1603,1606,1609,1612,1615,1618],{"class":1291,"line":134},[1289,1604,1605],{"class":1308},"    channelAccessToken: Joi.",[1289,1607,1608],{"class":1456},"string",[1289,1610,1611],{"class":1308},"().",[1289,1613,1614],{"class":1456},"required",[1289,1616,1617],{"class":1308},"(), ",[1289,1619,1620],{"class":1328},"\u002F\u002F 字串且必填\n",[1289,1622,1623,1626,1628,1630,1632,1634],{"class":1291,"line":122},[1289,1624,1625],{"class":1308},"    channelSecret: Joi.",[1289,1627,1608],{"class":1456},[1289,1629,1611],{"class":1308},[1289,1631,1614],{"class":1456},[1289,1633,1617],{"class":1308},[1289,1635,1620],{"class":1328},[1289,1637,1638,1641,1643,1645],{"class":1291,"line":31},[1289,1639,1640],{"class":1308},"  }).",[1289,1642,1614],{"class":1456},[1289,1644,1617],{"class":1308},[1289,1646,1647],{"class":1328},"\u002F\u002F 必填\n",[1289,1649,1650],{"class":1291,"line":17},[1289,1651,1366],{"emptyLinePlaceholder":1365},[1289,1653,1654],{"class":1291,"line":110},[1289,1655,1656],{"class":1328},"  \u002F\u002F OpenWeatherMap 相關設定\n",[1289,1658,1659,1662,1664],{"class":1291,"line":76},[1289,1660,1661],{"class":1308},"  weather: Joi.",[1289,1663,1583],{"class":1456},[1289,1665,1586],{"class":1308},[1289,1667,1668,1671,1673,1675,1678,1680,1682,1684],{"class":1291,"line":247},[1289,1669,1670],{"class":1308},"    baseUrl: Joi.",[1289,1672,1608],{"class":1456},[1289,1674,1611],{"class":1308},[1289,1676,1677],{"class":1456},"uri",[1289,1679,1611],{"class":1308},[1289,1681,1614],{"class":1456},[1289,1683,1617],{"class":1308},[1289,1685,1686],{"class":1328},"\u002F\u002F uri 格式且必填\n",[1289,1688,1689,1692,1694,1696,1698,1700],{"class":1291,"line":236},[1289,1690,1691],{"class":1308},"    apiKey: Joi.",[1289,1693,1608],{"class":1456},[1289,1695,1611],{"class":1308},[1289,1697,1614],{"class":1456},[1289,1699,1617],{"class":1308},[1289,1701,1620],{"class":1328},[1289,1703,1704,1706,1708,1710],{"class":1291,"line":225},[1289,1705,1640],{"class":1308},[1289,1707,1614],{"class":1456},[1289,1709,1617],{"class":1308},[1289,1711,1647],{"class":1328},[1289,1713,1714],{"class":1291,"line":214},[1289,1715,1366],{"emptyLinePlaceholder":1365},[1289,1717,1718],{"class":1291,"line":203},[1289,1719,1720],{"class":1328},"  \u002F\u002F 伺服器基本設定\n",[1289,1722,1723,1726,1729,1731,1734,1736,1739,1741,1744,1747],{"class":1291,"line":192},[1289,1724,1725],{"class":1308},"  port: Joi.",[1289,1727,1728],{"class":1456},"number",[1289,1730,1611],{"class":1308},[1289,1732,1733],{"class":1456},"port",[1289,1735,1611],{"class":1308},[1289,1737,1738],{"class":1456},"default",[1289,1740,1502],{"class":1308},[1289,1742,1743],{"class":1317},"3000",[1289,1745,1746],{"class":1308},"), ",[1289,1748,1749],{"class":1328},"\u002F\u002F 數字且是有效的端口號，預設值是 3000\n",[1289,1751,1752],{"class":1291,"line":181},[1289,1753,1754],{"class":1308},"});\n",[1269,1756,1758],{"id":1757},"step-4調整-configservice-環境變數讀取方式","Step 4：調整 ConfigService 環境變數讀取方式",[1216,1760,1761,1762,1765,1766,1769,1770,1773,1774,1777],{},"將原先採用",[1264,1763,1764],{},"蛇形命名(snake_case)","的環境變數讀取方式",[1264,1767,1768],{},"'LINE_CHANNEL_ACCESS_TOKEN'","，改為使用",[1264,1771,1772],{},"物件導向","的讀取方式",[1264,1775,1776],{},"line.channelAccessToken","，提供更結構化的配置存取模式。",[1216,1779,1780],{},[1276,1781,1782],{},"config\u002Fline.config.ts",[1280,1784,1786],{"className":1282,"code":1785,"language":1284,"meta":1285,"style":1285},"const lineConfig = (configService: ConfigService): ClientConfig => ({\n  channelAccessToken: configService.getOrThrow\u003Cstring>(\n    'line.channelAccessToken',\n  ),\n  channelSecret: configService.getOrThrow\u003Cstring>('line.channelSecret'),\n}); \n",[1264,1787,1788,1825,1841,1848,1853,1873],{"__ignoreMap":1285},[1289,1789,1790,1792,1795,1797,1800,1804,1807,1811,1814,1816,1819,1822],{"class":1291,"line":340},[1289,1791,1029],{"class":1294},[1289,1793,1794],{"class":1456}," lineConfig",[1289,1796,1321],{"class":1294},[1289,1798,1799],{"class":1308}," (",[1289,1801,1803],{"class":1802},"stnAF","configService",[1289,1805,1806],{"class":1294},":",[1289,1808,1810],{"class":1809},"sOLd2"," ConfigService",[1289,1812,1813],{"class":1308},")",[1289,1815,1806],{"class":1294},[1289,1817,1818],{"class":1809}," ClientConfig",[1289,1820,1821],{"class":1294}," =>",[1289,1823,1824],{"class":1308}," ({\n",[1289,1826,1827,1830,1833,1836,1838],{"class":1291,"line":329},[1289,1828,1829],{"class":1308},"  channelAccessToken: configService.",[1289,1831,1832],{"class":1456},"getOrThrow",[1289,1834,1835],{"class":1308},"\u003C",[1289,1837,1608],{"class":1317},[1289,1839,1840],{"class":1308},">(\n",[1289,1842,1843,1846],{"class":1291,"line":318},[1289,1844,1845],{"class":1505},"    'line.channelAccessToken'",[1289,1847,1345],{"class":1308},[1289,1849,1850],{"class":1291,"line":134},[1289,1851,1852],{"class":1308},"  ),\n",[1289,1854,1855,1858,1860,1862,1864,1867,1870],{"class":1291,"line":122},[1289,1856,1857],{"class":1308},"  channelSecret: configService.",[1289,1859,1832],{"class":1456},[1289,1861,1835],{"class":1308},[1289,1863,1608],{"class":1317},[1289,1865,1866],{"class":1308},">(",[1289,1868,1869],{"class":1505},"'line.channelSecret'",[1289,1871,1872],{"class":1308},"),\n",[1289,1874,1875],{"class":1291,"line":31},[1289,1876,1754],{"class":1308},[1269,1878,1880],{"id":1879},"step-5在執行階段指定環境變數","Step 5：在執行階段指定環境變數",[1216,1882,1883,1884,1887,1888,1891],{},"在",[1264,1885,1886],{},"package.json","添加",[1264,1889,1890],{},"NODE_ENV","環境變數，確保應用程式啟動時就能明確指定執行環境。這種做法可以保證環境變數在應用程式讀取配置之前就已經設定完成。",[1216,1893,1894],{},"這部分我們可以藉由 Day 5 配置的 Pino 日誌庫查看不同執行環境下的變化。",[1216,1896,1897],{},"package.json：",[1280,1899,1903],{"className":1900,"code":1901,"language":1902,"meta":1285,"style":1285},"language-json shiki shiki-themes github-light github-dark-dimmed","{\n  \"scripts\": {\n    \"start:dev\": \"NODE_ENV=development nest start --watch\",\n    \"start:prod\": \"NODE_ENV=production node dist\u002Fsrc\u002Fmain\",\n    \u002F\u002F 略\n  }\n}\n","json",[1264,1904,1905,1910,1919,1932,1944,1949,1954],{"__ignoreMap":1285},[1289,1906,1907],{"class":1291,"line":340},[1289,1908,1909],{"class":1308},"{\n",[1289,1911,1912,1916],{"class":1291,"line":329},[1289,1913,1915],{"class":1914},"snmFh","  \"scripts\"",[1289,1917,1918],{"class":1308},": {\n",[1289,1920,1921,1924,1927,1930],{"class":1291,"line":318},[1289,1922,1923],{"class":1914},"    \"start:dev\"",[1289,1925,1926],{"class":1308},": ",[1289,1928,1929],{"class":1505},"\"NODE_ENV=development nest start --watch\"",[1289,1931,1345],{"class":1308},[1289,1933,1934,1937,1939,1942],{"class":1291,"line":134},[1289,1935,1936],{"class":1914},"    \"start:prod\"",[1289,1938,1926],{"class":1308},[1289,1940,1941],{"class":1505},"\"NODE_ENV=production node dist\u002Fsrc\u002Fmain\"",[1289,1943,1345],{"class":1308},[1289,1945,1946],{"class":1291,"line":122},[1289,1947,1948],{"class":1328},"    \u002F\u002F 略\n",[1289,1950,1951],{"class":1291,"line":31},[1289,1952,1953],{"class":1308},"  }\n",[1289,1955,1956],{"class":1291,"line":17},[1289,1957,1958],{"class":1308},"}\n",[1216,1960,1961],{},[1276,1962,1963],{},"設置成果驗證",[1242,1965,1966],{},[1216,1967,1968,1969,1972,1973,1976],{},"開發環境啟動測試：執行 ",[1264,1970,1971],{},"pnpm run start:dev","，可以看到 ",[1264,1974,1975],{},"pino-pritty"," 美化後的訊息格式",[1216,1978,1979],{},[1219,1980],{"alt":1981,"src":1982},"開發環境啟動執行畫面","https:\u002F\u002Fres.cloudinary.com\u002Fdseg0uwc9\u002Fimage\u002Fupload\u002Fv1758378973\u002F2025%20IT%20%E9%90%B5%E4%BA%BA%E8%B3%BD\u002FDay%207%EF%BC%9AJoi%20%E7%92%B0%E5%A2%83%E8%AE%8A%E6%95%B8%E7%B5%B1%E4%B8%80%E9%A9%97%E8%AD%89%EF%BC%8C%E9%87%8D%E6%A7%8B%20LINE%20Bot%20%E5%A4%A9%E6%B0%A3%E6%9C%8D%E5%8B%99%E6%A8%A1%E7%B5%84\u002F%E8%BC%B8%E5%85%A5%E7%94%9F%E7%94%A2%E7%92%B0%E5%A2%83%E5%95%9F%E5%8B%95_CLI_%E6%8C%87%E4%BB%A4_f1zfml.png",[1242,1984,1985],{},[1216,1986,1987,1988,1991,1992,1995],{},"生產環境啟動測試：執行 ",[1264,1989,1990],{},"pnpm run build"," 建置完成後，透過 ",[1264,1993,1994],{},"pnpm run start:prod"," 驗證完整訊息格式輸出。",[1216,1997,1998],{},[1219,1999],{"alt":2000,"src":2001},"生產環境啟動執行畫面","https:\u002F\u002Fres.cloudinary.com\u002Fdseg0uwc9\u002Fimage\u002Fupload\u002Fv1758379113\u002F2025%20IT%20%E9%90%B5%E4%BA%BA%E8%B3%BD\u002FDay%207%EF%BC%9AJoi%20%E7%92%B0%E5%A2%83%E8%AE%8A%E6%95%B8%E7%B5%B1%E4%B8%80%E9%A9%97%E8%AD%89%EF%BC%8C%E9%87%8D%E6%A7%8B%20LINE%20Bot%20%E5%A4%A9%E6%B0%A3%E6%9C%8D%E5%8B%99%E6%A8%A1%E7%B5%84\u002F%E7%94%9F%E7%94%A2%E7%92%B0%E5%A2%83%E5%95%9F%E5%8B%95%E5%9F%B7%E8%A1%8C%E7%95%AB%E9%9D%A2_opz3jw.png",[1269,2003,2005],{"id":2004},"step-6測試-joi-環境變數驗證機制的有效性","Step 6：測試 Joi 環境變數驗證機制的有效性",[1242,2007,2008],{},[1216,2009,2010,2011,2014],{},"刻意清空部分環境變數來驗證 ",[1264,2012,2013],{},"Joi Schema"," 的檢查機制是否正常運作",[1216,2016,2017],{},"透過環境變數驗證機制，我們能在應用程式啟動的第一時間就捕捉到配置缺失的問題，避免在執行時期才發現環境變數設定錯誤。這種預防性的檢查大幅提升了系統的穩定性和除錯效率。",[1216,2019,2020],{},[1219,2021],{"alt":2022,"src":2023},"Joi 驗證環境變數有必填未給的缺失情形","https:\u002F\u002Fres.cloudinary.com\u002Fdseg0uwc9\u002Fimage\u002Fupload\u002Fv1758380563\u002F2025%20IT%20%E9%90%B5%E4%BA%BA%E8%B3%BD\u002FDay%207%EF%BC%9AJoi%20%E7%92%B0%E5%A2%83%E8%AE%8A%E6%95%B8%E7%B5%B1%E4%B8%80%E9%A9%97%E8%AD%89%EF%BC%8C%E9%87%8D%E6%A7%8B%20LINE%20Bot%20%E5%A4%A9%E6%B0%A3%E6%9C%8D%E5%8B%99%E6%A8%A1%E7%B5%84\u002FJoi_%E7%92%B0%E5%A2%83%E8%AE%8A%E6%95%B8%E9%A9%97%E8%AD%89%E9%8C%AF%E8%AA%A4_rnedhs.png",[1256,2025,2026],{"id":2026},"重構天氣服務模組",[1216,2028,2029,2030,2033,2034,2037],{},"在 Day 6 的實作中，我們將處理第三方 API 的 ",[1264,2031,2032],{},"fetchWeatherData 函數","放置在 ",[1264,2035,2036],{},"line-webhook.service"," 中。儘管兩者在業務流程上相互關聯，但天氣資料處理邏輯應該獨立抽離為專屬模組，避免服務職責邊界模糊，同時提升程式碼的可維護性與重用性。",[1269,2039,2041],{"id":2040},"step-1輸入-nest-cli-指令生成-weather-module-service","Step 1：輸入 Nest CLI 指令生成 weather module & service",[1280,2043,2046],{"className":2044,"code":2045,"language":1550},[1548],"nest g module weather\nnest g service weather --no-spec\n",[1264,2047,2045],{"__ignoreMap":1285},[1269,2049,2051],{"id":2050},"step-2將-httpmodule-移轉到-weathermodulets","Step 2：將 HttpModule 移轉到 weather.module.ts",[1242,2053,2054],{},[2055,2056,2057,2068],"ul",{},[2058,2059,2060,2061,2063,2064,2067],"li",{},"將 HTTP 請求處理從 ",[1264,2062,2036],{}," 中解耦，統一由 ",[1264,2065,2066],{},"WeatherModule"," 負責天氣相關的所有外部 API 串接邏輯",[2058,2069,2070,2071,2074,2075,2078,2079,2081,2082,2084],{},"透過模組的 ",[1264,2072,2073],{},"exports"," 屬性對外暴露 ",[1264,2076,2077],{},"WeatherService","，實現服務層的依賴注入。其他模組在匯入 ",[1264,2080,2066],{}," 後，可直接注入並使用已實例化的 ",[1264,2083,2077],{},"，達到跨模組的服務共享與資源複用",[1216,2086,2087],{},[1276,2088,2089],{},"weather\u002Fweather.module.ts",[1280,2091,2093],{"className":1282,"code":2092,"language":1284,"meta":1285,"style":1285},"import { Module } from '@nestjs\u002Fcommon';\nimport { HttpModule } from '@nestjs\u002Faxios';\nimport { WeatherService } from '.\u002Fweather.service';\n\n@Module({\n  imports: [HttpModule],\n  providers: [WeatherService],\n  exports: [WeatherService],\n})\nexport class WeatherModule {}\n",[1264,2094,2095,2112,2126,2140,2144,2154,2159,2164,2169,2174],{"__ignoreMap":1285},[1289,2096,2097,2100,2103,2106,2109],{"class":1291,"line":340},[1289,2098,2099],{"class":1294},"import",[1289,2101,2102],{"class":1308}," { Module } ",[1289,2104,2105],{"class":1294},"from",[1289,2107,2108],{"class":1505}," '@nestjs\u002Fcommon'",[1289,2110,2111],{"class":1308},";\n",[1289,2113,2114,2116,2119,2121,2124],{"class":1291,"line":329},[1289,2115,2099],{"class":1294},[1289,2117,2118],{"class":1308}," { HttpModule } ",[1289,2120,2105],{"class":1294},[1289,2122,2123],{"class":1505}," '@nestjs\u002Faxios'",[1289,2125,2111],{"class":1308},[1289,2127,2128,2130,2133,2135,2138],{"class":1291,"line":318},[1289,2129,2099],{"class":1294},[1289,2131,2132],{"class":1308}," { WeatherService } ",[1289,2134,2105],{"class":1294},[1289,2136,2137],{"class":1505}," '.\u002Fweather.service'",[1289,2139,2111],{"class":1308},[1289,2141,2142],{"class":1291,"line":134},[1289,2143,1366],{"emptyLinePlaceholder":1365},[1289,2145,2146,2149,2152],{"class":1291,"line":122},[1289,2147,2148],{"class":1308},"@",[1289,2150,2151],{"class":1456},"Module",[1289,2153,1586],{"class":1308},[1289,2155,2156],{"class":1291,"line":31},[1289,2157,2158],{"class":1308},"  imports: [HttpModule],\n",[1289,2160,2161],{"class":1291,"line":17},[1289,2162,2163],{"class":1308},"  providers: [WeatherService],\n",[1289,2165,2166],{"class":1291,"line":110},[1289,2167,2168],{"class":1308},"  exports: [WeatherService],\n",[1289,2170,2171],{"class":1291,"line":76},[1289,2172,2173],{"class":1308},"})\n",[1289,2175,2176,2178,2181,2184],{"class":1291,"line":247},[1289,2177,1295],{"class":1294},[1289,2179,2180],{"class":1294}," class",[1289,2182,2183],{"class":1809}," WeatherModule",[1289,2185,2186],{"class":1308}," {}\n",[1269,2188,2190],{"id":2189},"step-3將原先處理天氣服務的業務邏輯移轉至-weatherservicets","Step 3：將原先處理天氣服務的業務邏輯移轉至 weather.service.ts",[1242,2192,2193],{},[1216,2194,2195],{},"加上參數驗證，當緯度或經度參數缺失時拋出 HTTP 400 錯誤",[1216,2197,2198],{},[1276,2199,2200],{},"weather\u002Fweather.service.ts",[1280,2202,2204],{"className":1282,"code":2203,"language":1284,"meta":1285,"style":1285},"\u002F\u002F 略\n\n@Injectable()\nexport class WeatherService {\n  \u002F\u002F 略\n  async getWeatherByCoordinates(latitude: number, longitude: number) {\n    if (!latitude || !longitude) {\n      throw new HttpException('請提供緯度和經度', HttpStatus.BAD_REQUEST);\n    }\n\n    \u002F\u002F 查詢參數\n    const queryParams = {\n      lat: latitude,\n      lon: longitude,\n      appid: this.WEATHER_API_KEY,\n      units: 'metric',\n      lang: 'zh_tw',\n    };\n\n    try {\n      \u002F\u002F 接收處理完的天氣數據\n      const responseData = await firstValueFrom(\n        this.httpService\n          .get(this.WEATHER_API_BASE_URL, { params: queryParams })\n          .pipe(\n            catchError((err: AxiosError) => {\n              return throwError(\n                () =>\n                  new Error(\n                    `Weather API request failed: ${JSON.stringify(err.response?.data)}`,\n                  ),\n              );\n            }),\n          ),\n      );\n      return this.#formateWeatherInfo(responseData.data);\n    } catch (error) {\n      throw error;\n    }\n  }\n\n  \u002F\u002F 格式化天氣服務的回傳值\n  #formateWeatherInfo(weatherData: CurrentWeatherResponse) {\n      \u002F\u002F 略\n  }\n}\n",[1264,2205,2206,2211,2215,2225,2236,2241,2271,2293,2316,2321,2325,2330,2342,2347,2352,2365,2375,2385,2390,2394,2401,2406,2425,2433,2453,2462,2485,2495,2503,2512,2546,2552,2558,2564,2570,2576,2593,2605,2613,2618,2623,2628,2634,2655,2661,2666],{"__ignoreMap":1285},[1289,2207,2208],{"class":1291,"line":340},[1289,2209,2210],{"class":1328},"\u002F\u002F 略\n",[1289,2212,2213],{"class":1291,"line":329},[1289,2214,1366],{"emptyLinePlaceholder":1365},[1289,2216,2217,2219,2222],{"class":1291,"line":318},[1289,2218,2148],{"class":1308},[1289,2220,2221],{"class":1456},"Injectable",[1289,2223,2224],{"class":1308},"()\n",[1289,2226,2227,2229,2231,2234],{"class":1291,"line":134},[1289,2228,1295],{"class":1294},[1289,2230,2180],{"class":1294},[1289,2232,2233],{"class":1809}," WeatherService",[1289,2235,1309],{"class":1308},[1289,2237,2238],{"class":1291,"line":122},[1289,2239,2240],{"class":1328},"  \u002F\u002F 略\n",[1289,2242,2243,2246,2249,2251,2254,2256,2259,2261,2264,2266,2268],{"class":1291,"line":31},[1289,2244,2245],{"class":1294},"  async",[1289,2247,2248],{"class":1456}," getWeatherByCoordinates",[1289,2250,1502],{"class":1308},[1289,2252,2253],{"class":1802},"latitude",[1289,2255,1806],{"class":1294},[1289,2257,2258],{"class":1317}," number",[1289,2260,1441],{"class":1308},[1289,2262,2263],{"class":1802},"longitude",[1289,2265,1806],{"class":1294},[1289,2267,2258],{"class":1317},[1289,2269,2270],{"class":1308},") {\n",[1289,2272,2273,2276,2278,2281,2284,2287,2290],{"class":1291,"line":17},[1289,2274,2275],{"class":1294},"    if",[1289,2277,1799],{"class":1308},[1289,2279,2280],{"class":1294},"!",[1289,2282,2283],{"class":1308},"latitude ",[1289,2285,2286],{"class":1294},"||",[1289,2288,2289],{"class":1294}," !",[1289,2291,2292],{"class":1308},"longitude) {\n",[1289,2294,2295,2298,2300,2303,2305,2308,2311,2314],{"class":1291,"line":110},[1289,2296,2297],{"class":1294},"      throw",[1289,2299,1496],{"class":1294},[1289,2301,2302],{"class":1456}," HttpException",[1289,2304,1502],{"class":1308},[1289,2306,2307],{"class":1505},"'請提供緯度和經度'",[1289,2309,2310],{"class":1308},", HttpStatus.",[1289,2312,2313],{"class":1317},"BAD_REQUEST",[1289,2315,1520],{"class":1308},[1289,2317,2318],{"class":1291,"line":76},[1289,2319,2320],{"class":1308},"    }\n",[1289,2322,2323],{"class":1291,"line":247},[1289,2324,1366],{"emptyLinePlaceholder":1365},[1289,2326,2327],{"class":1291,"line":236},[1289,2328,2329],{"class":1328},"    \u002F\u002F 查詢參數\n",[1289,2331,2332,2335,2338,2340],{"class":1291,"line":225},[1289,2333,2334],{"class":1294},"    const",[1289,2336,2337],{"class":1317}," queryParams",[1289,2339,1321],{"class":1294},[1289,2341,1309],{"class":1308},[1289,2343,2344],{"class":1291,"line":214},[1289,2345,2346],{"class":1308},"      lat: latitude,\n",[1289,2348,2349],{"class":1291,"line":203},[1289,2350,2351],{"class":1308},"      lon: longitude,\n",[1289,2353,2354,2357,2359,2361,2363],{"class":1291,"line":192},[1289,2355,2356],{"class":1308},"      appid: ",[1289,2358,1128],{"class":1317},[1289,2360,1511],{"class":1308},[1289,2362,1394],{"class":1317},[1289,2364,1345],{"class":1308},[1289,2366,2367,2370,2373],{"class":1291,"line":181},[1289,2368,2369],{"class":1308},"      units: ",[1289,2371,2372],{"class":1505},"'metric'",[1289,2374,1345],{"class":1308},[1289,2376,2377,2380,2383],{"class":1291,"line":170},[1289,2378,2379],{"class":1308},"      lang: ",[1289,2381,2382],{"class":1505},"'zh_tw'",[1289,2384,1345],{"class":1308},[1289,2386,2387],{"class":1291,"line":159},[1289,2388,2389],{"class":1308},"    };\n",[1289,2391,2392],{"class":1291,"line":148},[1289,2393,1366],{"emptyLinePlaceholder":1365},[1289,2395,2396,2399],{"class":1291,"line":137},[1289,2397,2398],{"class":1294},"    try",[1289,2400,1309],{"class":1308},[1289,2402,2403],{"class":1291,"line":125},[1289,2404,2405],{"class":1328},"      \u002F\u002F 接收處理完的天氣數據\n",[1289,2407,2408,2411,2414,2416,2419,2422],{"class":1291,"line":113},[1289,2409,2410],{"class":1294},"      const",[1289,2412,2413],{"class":1317}," responseData",[1289,2415,1321],{"class":1294},[1289,2417,2418],{"class":1294}," await",[1289,2420,2421],{"class":1456}," firstValueFrom",[1289,2423,2424],{"class":1308},"(\n",[1289,2426,2427,2430],{"class":1291,"line":101},[1289,2428,2429],{"class":1317},"        this",[1289,2431,2432],{"class":1308},".httpService\n",[1289,2434,2435,2438,2441,2443,2445,2447,2450],{"class":1291,"line":90},[1289,2436,2437],{"class":1308},"          .",[1289,2439,2440],{"class":1456},"get",[1289,2442,1502],{"class":1308},[1289,2444,1128],{"class":1317},[1289,2446,1511],{"class":1308},[1289,2448,2449],{"class":1317},"WEATHER_API_BASE_URL",[1289,2451,2452],{"class":1308},", { params: queryParams })\n",[1289,2454,2455,2457,2460],{"class":1291,"line":79},[1289,2456,2437],{"class":1308},[1289,2458,2459],{"class":1456},"pipe",[1289,2461,2424],{"class":1308},[1289,2463,2464,2467,2470,2473,2475,2478,2481,2483],{"class":1291,"line":67},[1289,2465,2466],{"class":1456},"            catchError",[1289,2468,2469],{"class":1308},"((",[1289,2471,2472],{"class":1802},"err",[1289,2474,1806],{"class":1294},[1289,2476,2477],{"class":1809}," AxiosError",[1289,2479,2480],{"class":1308},") ",[1289,2482,1305],{"class":1294},[1289,2484,1309],{"class":1308},[1289,2486,2487,2490,2493],{"class":1291,"line":56},[1289,2488,2489],{"class":1294},"              return",[1289,2491,2492],{"class":1456}," throwError",[1289,2494,2424],{"class":1308},[1289,2496,2497,2500],{"class":1291,"line":45},[1289,2498,2499],{"class":1308},"                () ",[1289,2501,2502],{"class":1294},"=>\n",[1289,2504,2505,2508,2510],{"class":1291,"line":34},[1289,2506,2507],{"class":1294},"                  new",[1289,2509,1499],{"class":1456},[1289,2511,2424],{"class":1308},[1289,2513,2514,2517,2520,2522,2525,2527,2529,2531,2534,2537,2540,2542,2544],{"class":1291,"line":22},[1289,2515,2516],{"class":1505},"                    `Weather API request failed: ${",[1289,2518,2519],{"class":1317},"JSON",[1289,2521,1511],{"class":1505},[1289,2523,2524],{"class":1456},"stringify",[1289,2526,1502],{"class":1505},[1289,2528,2472],{"class":1308},[1289,2530,1511],{"class":1505},[1289,2532,2533],{"class":1308},"response",[1289,2535,2536],{"class":1505},"?.",[1289,2538,2539],{"class":1308},"data",[1289,2541,1813],{"class":1505},[1289,2543,1517],{"class":1505},[1289,2545,1345],{"class":1308},[1289,2547,2549],{"class":1291,"line":2548},31,[1289,2550,2551],{"class":1308},"                  ),\n",[1289,2553,2555],{"class":1291,"line":2554},32,[1289,2556,2557],{"class":1308},"              );\n",[1289,2559,2561],{"class":1291,"line":2560},33,[1289,2562,2563],{"class":1308},"            }),\n",[1289,2565,2567],{"class":1291,"line":2566},34,[1289,2568,2569],{"class":1308},"          ),\n",[1289,2571,2573],{"class":1291,"line":2572},35,[1289,2574,2575],{"class":1308},"      );\n",[1289,2577,2579,2582,2585,2587,2590],{"class":1291,"line":2578},36,[1289,2580,2581],{"class":1294},"      return",[1289,2583,2584],{"class":1317}," this",[1289,2586,1511],{"class":1308},[1289,2588,2589],{"class":1456},"#formateWeatherInfo",[1289,2591,2592],{"class":1308},"(responseData.data);\n",[1289,2594,2596,2599,2602],{"class":1291,"line":2595},37,[1289,2597,2598],{"class":1308},"    } ",[1289,2600,2601],{"class":1294},"catch",[1289,2603,2604],{"class":1308}," (error) {\n",[1289,2606,2608,2610],{"class":1291,"line":2607},38,[1289,2609,2297],{"class":1294},[1289,2611,2612],{"class":1308}," error;\n",[1289,2614,2616],{"class":1291,"line":2615},39,[1289,2617,2320],{"class":1308},[1289,2619,2621],{"class":1291,"line":2620},40,[1289,2622,1953],{"class":1308},[1289,2624,2626],{"class":1291,"line":2625},41,[1289,2627,1366],{"emptyLinePlaceholder":1365},[1289,2629,2631],{"class":1291,"line":2630},42,[1289,2632,2633],{"class":1328},"  \u002F\u002F 格式化天氣服務的回傳值\n",[1289,2635,2637,2640,2643,2645,2648,2650,2653],{"class":1291,"line":2636},43,[1289,2638,2639],{"class":1308},"  #",[1289,2641,2642],{"class":1456},"formateWeatherInfo",[1289,2644,1502],{"class":1308},[1289,2646,2647],{"class":1802},"weatherData",[1289,2649,1806],{"class":1294},[1289,2651,2652],{"class":1809}," CurrentWeatherResponse",[1289,2654,2270],{"class":1308},[1289,2656,2658],{"class":1291,"line":2657},44,[1289,2659,2660],{"class":1328},"      \u002F\u002F 略\n",[1289,2662,2664],{"class":1291,"line":2663},45,[1289,2665,1953],{"class":1308},[1289,2667,2669],{"class":1291,"line":2668},46,[1289,2670,1958],{"class":1308},[1269,2672,2674],{"id":2673},"step-4-line-webhookmodule-匯入天氣服務模組","Step 4： line-webhook.module 匯入天氣服務模組",[1242,2676,2677],{},[1216,2678,2679,2680,2682],{},"匯入 ",[1264,2681,2066],{}," 實現模組間的依賴注入",[1216,2684,2685],{},[1276,2686,2687],{},"line-webhook\u002Fline-webhook.module.ts",[1280,2689,2691],{"className":1282,"code":2690,"language":1284,"meta":1285,"style":1285},"\u002F\u002F 略\nimport { WeatherModule } from 'src\u002Fweather\u002Fweather.module';\n\n@Module({\n  imports: [WeatherModule], \u002F\u002F 將天氣服務模組匯入\n  controllers: [LineWebhookController],\n  providers: [LineWebhookService, LineConfigProvider],\n})\nexport class LineWebhookModule {}\n",[1264,2692,2693,2697,2711,2715,2723,2731,2736,2741,2745],{"__ignoreMap":1285},[1289,2694,2695],{"class":1291,"line":340},[1289,2696,2210],{"class":1328},[1289,2698,2699,2701,2704,2706,2709],{"class":1291,"line":329},[1289,2700,2099],{"class":1294},[1289,2702,2703],{"class":1308}," { WeatherModule } ",[1289,2705,2105],{"class":1294},[1289,2707,2708],{"class":1505}," 'src\u002Fweather\u002Fweather.module'",[1289,2710,2111],{"class":1308},[1289,2712,2713],{"class":1291,"line":318},[1289,2714,1366],{"emptyLinePlaceholder":1365},[1289,2716,2717,2719,2721],{"class":1291,"line":134},[1289,2718,2148],{"class":1308},[1289,2720,2151],{"class":1456},[1289,2722,1586],{"class":1308},[1289,2724,2725,2728],{"class":1291,"line":122},[1289,2726,2727],{"class":1308},"  imports: [WeatherModule], ",[1289,2729,2730],{"class":1328},"\u002F\u002F 將天氣服務模組匯入\n",[1289,2732,2733],{"class":1291,"line":31},[1289,2734,2735],{"class":1308},"  controllers: [LineWebhookController],\n",[1289,2737,2738],{"class":1291,"line":17},[1289,2739,2740],{"class":1308},"  providers: [LineWebhookService, LineConfigProvider],\n",[1289,2742,2743],{"class":1291,"line":110},[1289,2744,2173],{"class":1308},[1289,2746,2747,2749,2751,2754],{"class":1291,"line":76},[1289,2748,1295],{"class":1294},[1289,2750,2180],{"class":1294},[1289,2752,2753],{"class":1809}," LineWebhookModule",[1289,2755,2186],{"class":1308},[1269,2757,2759],{"id":2758},"step-5將原先處理天氣服務的函數移除改成使用-weather-服務方法呼叫","Step 5：將原先處理天氣服務的函數移除，改成使用 weather 服務方法呼叫",[1242,2761,2762],{},[1216,2763,2764],{},"移除原先內嵌的天氣處理函數，透過建構子注入 WeatherService 並呼叫其方法取得天氣資料",[1280,2766,2768],{"className":1282,"code":2767,"language":1284,"meta":1285,"style":1285},"\u002F\u002F 略\n\n@Injectable()\nexport class LineWebhookService {\n  \u002F\u002F 略\n  constructor(\n    private readonly weatherService: WeatherService,\n  ) {\n  }\n\n  private async handleMessageEvent(event: MessageEvent): Promise\u003Cvoid> {\n    const messageEventHandlerMap = {\n      \u002F\u002F 略\n      location: async (message) => {\n        const { address, longitude, latitude } = message;\n        const defaultMsg = `📍 收到位置訊息\\n🏠 地址：${address}\\n🧭 精度：${longitude}\\n🧭 緯度：${latitude}`;\n\n        \u002F\u002F 透過 weather 服務呼叫取得第三方天氣服務的回傳字串\n        const weatherData = await this.weatherService.getWeatherByCoordinates(\n          latitude,\n          longitude,\n        );\n\n        return `${defaultMsg}\\n\\n${weatherData}`;\n      },\n    } satisfies Partial\u003CMessageEventHandlerMap>;\n\n    let replyMessage = '✨ 感謝你的訊息，我們已經收到了！';\n    const handler = messageEventHandlerMap[event.message.type];\n    if (handler) replyMessage = await handler(event.message);\n\n    await this.lineClient.replyMessage({\n      replyToken: event.replyToken,\n      messages: [{ type: 'text', text: replyMessage }],\n    });\n  }\n}\n\n",[1264,2769,2770,2774,2778,2786,2797,2801,2808,2825,2830,2834,2838,2874,2885,2889,2909,2934,2978,2982,2987,3008,3013,3018,3023,3027,3052,3057,3075,3079,3094,3106,3122,3126,3141,3146,3157,3162,3166],{"__ignoreMap":1285},[1289,2771,2772],{"class":1291,"line":340},[1289,2773,2210],{"class":1328},[1289,2775,2776],{"class":1291,"line":329},[1289,2777,1366],{"emptyLinePlaceholder":1365},[1289,2779,2780,2782,2784],{"class":1291,"line":318},[1289,2781,2148],{"class":1308},[1289,2783,2221],{"class":1456},[1289,2785,2224],{"class":1308},[1289,2787,2788,2790,2792,2795],{"class":1291,"line":134},[1289,2789,1295],{"class":1294},[1289,2791,2180],{"class":1294},[1289,2793,2794],{"class":1809}," LineWebhookService",[1289,2796,1309],{"class":1308},[1289,2798,2799],{"class":1291,"line":122},[1289,2800,2240],{"class":1328},[1289,2802,2803,2806],{"class":1291,"line":31},[1289,2804,2805],{"class":1294},"  constructor",[1289,2807,2424],{"class":1308},[1289,2809,2810,2813,2816,2819,2821,2823],{"class":1291,"line":17},[1289,2811,2812],{"class":1294},"    private",[1289,2814,2815],{"class":1294}," readonly",[1289,2817,2818],{"class":1802}," weatherService",[1289,2820,1806],{"class":1294},[1289,2822,2233],{"class":1809},[1289,2824,1345],{"class":1308},[1289,2826,2827],{"class":1291,"line":110},[1289,2828,2829],{"class":1308},"  ) {\n",[1289,2831,2832],{"class":1291,"line":76},[1289,2833,1953],{"class":1308},[1289,2835,2836],{"class":1291,"line":247},[1289,2837,1366],{"emptyLinePlaceholder":1365},[1289,2839,2840,2843,2846,2849,2851,2854,2856,2859,2861,2863,2866,2868,2871],{"class":1291,"line":236},[1289,2841,2842],{"class":1294},"  private",[1289,2844,2845],{"class":1294}," async",[1289,2847,2848],{"class":1456}," handleMessageEvent",[1289,2850,1502],{"class":1308},[1289,2852,2853],{"class":1802},"event",[1289,2855,1806],{"class":1294},[1289,2857,2858],{"class":1809}," MessageEvent",[1289,2860,1813],{"class":1308},[1289,2862,1806],{"class":1294},[1289,2864,2865],{"class":1809}," Promise",[1289,2867,1835],{"class":1308},[1289,2869,2870],{"class":1317},"void",[1289,2872,2873],{"class":1308},"> {\n",[1289,2875,2876,2878,2881,2883],{"class":1291,"line":225},[1289,2877,2334],{"class":1294},[1289,2879,2880],{"class":1317}," messageEventHandlerMap",[1289,2882,1321],{"class":1294},[1289,2884,1309],{"class":1308},[1289,2886,2887],{"class":1291,"line":214},[1289,2888,2660],{"class":1328},[1289,2890,2891,2894,2896,2899,2901,2903,2905,2907],{"class":1291,"line":203},[1289,2892,2893],{"class":1456},"      location",[1289,2895,1926],{"class":1308},[1289,2897,2898],{"class":1294},"async",[1289,2900,1799],{"class":1308},[1289,2902,1514],{"class":1802},[1289,2904,2480],{"class":1308},[1289,2906,1305],{"class":1294},[1289,2908,1309],{"class":1308},[1289,2910,2911,2914,2916,2919,2921,2923,2925,2927,2929,2931],{"class":1291,"line":192},[1289,2912,2913],{"class":1294},"        const",[1289,2915,1435],{"class":1308},[1289,2917,2918],{"class":1317},"address",[1289,2920,1441],{"class":1308},[1289,2922,2263],{"class":1317},[1289,2924,1441],{"class":1308},[1289,2926,2253],{"class":1317},[1289,2928,1447],{"class":1308},[1289,2930,1450],{"class":1294},[1289,2932,2933],{"class":1308}," message;\n",[1289,2935,2936,2938,2941,2943,2946,2950,2953,2955,2958,2960,2963,2965,2967,2969,2972,2974,2976],{"class":1291,"line":181},[1289,2937,2913],{"class":1294},[1289,2939,2940],{"class":1317}," defaultMsg",[1289,2942,1321],{"class":1294},[1289,2944,2945],{"class":1505}," `📍 收到位置訊息",[1289,2947,2949],{"class":2948},"s74oq","\\n",[1289,2951,2952],{"class":1505},"🏠 地址：${",[1289,2954,2918],{"class":1308},[1289,2956,2957],{"class":1505},"}",[1289,2959,2949],{"class":2948},[1289,2961,2962],{"class":1505},"🧭 精度：${",[1289,2964,2263],{"class":1308},[1289,2966,2957],{"class":1505},[1289,2968,2949],{"class":2948},[1289,2970,2971],{"class":1505},"🧭 緯度：${",[1289,2973,2253],{"class":1308},[1289,2975,1517],{"class":1505},[1289,2977,2111],{"class":1308},[1289,2979,2980],{"class":1291,"line":170},[1289,2981,1366],{"emptyLinePlaceholder":1365},[1289,2983,2984],{"class":1291,"line":159},[1289,2985,2986],{"class":1328},"        \u002F\u002F 透過 weather 服務呼叫取得第三方天氣服務的回傳字串\n",[1289,2988,2989,2991,2994,2996,2998,3000,3003,3006],{"class":1291,"line":148},[1289,2990,2913],{"class":1294},[1289,2992,2993],{"class":1317}," weatherData",[1289,2995,1321],{"class":1294},[1289,2997,2418],{"class":1294},[1289,2999,2584],{"class":1317},[1289,3001,3002],{"class":1308},".weatherService.",[1289,3004,3005],{"class":1456},"getWeatherByCoordinates",[1289,3007,2424],{"class":1308},[1289,3009,3010],{"class":1291,"line":137},[1289,3011,3012],{"class":1308},"          latitude,\n",[1289,3014,3015],{"class":1291,"line":125},[1289,3016,3017],{"class":1308},"          longitude,\n",[1289,3019,3020],{"class":1291,"line":113},[1289,3021,3022],{"class":1308},"        );\n",[1289,3024,3025],{"class":1291,"line":101},[1289,3026,1366],{"emptyLinePlaceholder":1365},[1289,3028,3029,3032,3035,3038,3040,3043,3046,3048,3050],{"class":1291,"line":90},[1289,3030,3031],{"class":1294},"        return",[1289,3033,3034],{"class":1505}," `${",[1289,3036,3037],{"class":1308},"defaultMsg",[1289,3039,2957],{"class":1505},[1289,3041,3042],{"class":2948},"\\n\\n",[1289,3044,3045],{"class":1505},"${",[1289,3047,2647],{"class":1308},[1289,3049,1517],{"class":1505},[1289,3051,2111],{"class":1308},[1289,3053,3054],{"class":1291,"line":79},[1289,3055,3056],{"class":1308},"      },\n",[1289,3058,3059,3061,3064,3067,3069,3072],{"class":1291,"line":67},[1289,3060,2598],{"class":1308},[1289,3062,3063],{"class":1294},"satisfies",[1289,3065,3066],{"class":1809}," Partial",[1289,3068,1835],{"class":1308},[1289,3070,3071],{"class":1809},"MessageEventHandlerMap",[1289,3073,3074],{"class":1308},">;\n",[1289,3076,3077],{"class":1291,"line":56},[1289,3078,1366],{"emptyLinePlaceholder":1365},[1289,3080,3081,3084,3087,3089,3092],{"class":1291,"line":45},[1289,3082,3083],{"class":1294},"    let",[1289,3085,3086],{"class":1308}," replyMessage ",[1289,3088,1450],{"class":1294},[1289,3090,3091],{"class":1505}," '✨ 感謝你的訊息，我們已經收到了！'",[1289,3093,2111],{"class":1308},[1289,3095,3096,3098,3101,3103],{"class":1291,"line":34},[1289,3097,2334],{"class":1294},[1289,3099,3100],{"class":1317}," handler",[1289,3102,1321],{"class":1294},[1289,3104,3105],{"class":1308}," messageEventHandlerMap[event.message.type];\n",[1289,3107,3108,3110,3113,3115,3117,3119],{"class":1291,"line":22},[1289,3109,2275],{"class":1294},[1289,3111,3112],{"class":1308}," (handler) replyMessage ",[1289,3114,1450],{"class":1294},[1289,3116,2418],{"class":1294},[1289,3118,3100],{"class":1456},[1289,3120,3121],{"class":1308},"(event.message);\n",[1289,3123,3124],{"class":1291,"line":2548},[1289,3125,1366],{"emptyLinePlaceholder":1365},[1289,3127,3128,3131,3133,3136,3139],{"class":1291,"line":2554},[1289,3129,3130],{"class":1294},"    await",[1289,3132,2584],{"class":1317},[1289,3134,3135],{"class":1308},".lineClient.",[1289,3137,3138],{"class":1456},"replyMessage",[1289,3140,1586],{"class":1308},[1289,3142,3143],{"class":1291,"line":2560},[1289,3144,3145],{"class":1308},"      replyToken: event.replyToken,\n",[1289,3147,3148,3151,3154],{"class":1291,"line":2566},[1289,3149,3150],{"class":1308},"      messages: [{ type: ",[1289,3152,3153],{"class":1505},"'text'",[1289,3155,3156],{"class":1308},", text: replyMessage }],\n",[1289,3158,3159],{"class":1291,"line":2572},[1289,3160,3161],{"class":1308},"    });\n",[1289,3163,3164],{"class":1291,"line":2578},[1289,3165,1953],{"class":1308},[1289,3167,3168],{"class":1291,"line":2595},[1289,3169,1958],{"class":1308},[1216,3171,3172,3173,3175],{},"經過模組化拆分後，天氣服務的職責邊界更加清晰。未來若需要擴充不同的天氣資料來源或處理邏輯，可直接在 ",[1264,3174,2066],{}," 中進行擴展，其他需要天氣資訊的模組只需透過依賴注入即可複用相關服務，提升程式碼的可維護性與擴展性。",[1256,3177,3178],{"id":3178},"本日結語",[1216,3180,3181,3182,3185],{},"今天的工作就像蓋房子時的打地基階段，雖然表面上看起來沒什麼大變化，但實際上讓專案的基礎架構變得更加穩固。把環境變數用 ",[1264,3183,3184],{},"Joi"," 管理好，讓天氣服務獨立出來，這些基礎建設重構可以讓之後的開發工作更輕鬆一些。",[3187,3188,3189],"style",{},"html pre.shiki code .s7YZ4, html code.shiki .s7YZ4{--shiki-default:#D73A49;--shiki-dark:#F47067}html pre.shiki code .s6WnN, html code.shiki .s6WnN{--shiki-default:#24292E;--shiki-dark:#F69D50}html pre.shiki code .sYgZi, html code.shiki .sYgZi{--shiki-default:#24292E;--shiki-dark:#ADBAC7}html pre.shiki code .sviXB, html code.shiki .sviXB{--shiki-default:#005CC5;--shiki-dark:#6CB6FF}html pre.shiki code .sDN9O, html code.shiki .sDN9O{--shiki-default:#6A737D;--shiki-dark:#768390}html pre.shiki code .sPO5f, html code.shiki .sPO5f{--shiki-default:#6F42C1;--shiki-dark:#DCBDFB}html pre.shiki code .s-HuK, html code.shiki .s-HuK{--shiki-default:#032F62;--shiki-dark:#96D0FF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .stnAF, html code.shiki .stnAF{--shiki-default:#E36209;--shiki-dark:#F69D50}html pre.shiki code .sOLd2, html code.shiki .sOLd2{--shiki-default:#6F42C1;--shiki-dark:#F69D50}html pre.shiki code .snmFh, html code.shiki .snmFh{--shiki-default:#005CC5;--shiki-dark:#8DDB8C}html pre.shiki code .s74oq, html code.shiki .s74oq{--shiki-default:#005CC5;--shiki-dark:#F47067}",{"title":1285,"searchDepth":134,"depth":134,"links":3191},[3192],{"id":1226,"depth":329,"text":1226,"children":3193},[3194,3202,3209],{"id":1258,"depth":318,"text":1259,"children":3195},[3196,3197,3198,3199,3200,3201],{"id":1271,"depth":134,"text":1272},{"id":1540,"depth":134,"text":1541},{"id":1555,"depth":134,"text":1556},{"id":1757,"depth":134,"text":1758},{"id":1879,"depth":134,"text":1880},{"id":2004,"depth":134,"text":2005},{"id":2026,"depth":318,"text":2026,"children":3203},[3204,3205,3206,3207,3208],{"id":2040,"depth":134,"text":2041},{"id":2050,"depth":134,"text":2051},{"id":2189,"depth":134,"text":2190},{"id":2673,"depth":134,"text":2674},{"id":2758,"depth":134,"text":2759},{"id":3178,"depth":318,"text":3178},[11,362],"md",{},"---\ntitle: \"Day 7：Joi 環境變數統一驗證，重構 LINE Bot 天氣服務模組\"\ndate: 2025-09-20 23:07:08\ntags:\n  - \"iThome 鐵人賽\"\n  - \"2025 鐵人賽\"\n  - \"Line Bot\"\n  - \"NestJS\"\ncategories:\n  - \"iThome 鐵人賽\"\n  - \"Line Bot\"\ndescription: \"在 Day 6 開發 LINE Bot 結合 OpenWeatherMap API 的過程中，我們採用私有方法將 API 請求處理與資料格式化整合在一起。今天將對 Day 6 的實作進行架構重構，主要目標是建立更完善的環…\"\ncanonical: https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10384302\nseries:\n  name: \"2025 iThome 鐵人賽：Line Bot × NestJS：30 天開發日記\"\n  url: https:\u002F\u002Fithelp.ithome.com.tw\u002Fusers\u002F20116554\u002Fironman\u002F8779\n  day: 7\n---\n\n![2025 鐵人賽背景圖](https:\u002F\u002Fres.cloudinary.com\u002Fdseg0uwc9\u002Fimage\u002Fupload\u002Fv1758378837\u002F2025%20IT%20%E9%90%B5%E4%BA%BA%E8%B3%BD\u002FDay%207%EF%BC%9AJoi%20%E7%92%B0%E5%A2%83%E8%AE%8A%E6%95%B8%E7%B5%B1%E4%B8%80%E9%A9%97%E8%AD%89%EF%BC%8C%E9%87%8D%E6%A7%8B%20LINE%20Bot%20%E5%A4%A9%E6%B0%A3%E6%9C%8D%E5%8B%99%E6%A8%A1%E7%B5%84\u002FJoi_%E7%92%B0%E5%A2%83%E8%AE%8A%E6%95%B8%E7%B5%B1%E4%B8%80%E9%A9%97%E8%AD%89_%E9%87%8D%E6%A7%8B_LINE_Bot_%E5%A4%A9%E6%B0%A3%E6%9C%8D%E5%8B%99%E6%A8%A1%E7%B5%84_ixnlre.png)\n\n## 前言\n\n在 [Day 6](https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10383636) 開發 LINE Bot 結合 OpenWeatherMap API 的過程中，我們採用私有方法將 API 請求處理與資料格式化整合在一起。今天將對 [Day 6](https:\u002F\u002Fithelp.ithome.com.tw\u002Farticles\u002F10383636) 的實作進行架構重構，主要目標是建立更完善的環境變數管理機制，同時優化服務模組的職責分離。\n\n> 本日程式碼的[範例連結](https:\u002F\u002Fgithub.com\u002FLING-JUN-HAO\u002Fnestjs-linebot-ironman\u002Ftree\u002Fday6)\n\n* * *\n\n### env 透過設定檔統一驗證管理\n\n傳統的 `.env 環境變數`讀取方式雖然簡單直接，但缺乏結構化的存取模式、無法進行設定值的型別驗證，以及難以確保必要環境變數的完整性，這些限制可能導致執行時期的配置錯誤。為了解決這些問題，我們可以建立一套統一的環境變數驗證管理機制。\n\n#### Step 1：新增 config\u002Fconfiguration.ts\n\n**config\u002Fconfiguration.ts：**\n\n```ts\nexport default () => {\n  const config = {\n    \u002F\u002F Line Bot 相關設定\n    line: {\n      channelAccessToken: process.env.LINE_CHANNEL_ACCESS_TOKEN,\n      channelSecret: process.env.LINE_CHANNEL_SECRET,\n    },\n\n    \u002F\u002F OpenWeatherMap 相關設定\n    weather: {\n      baseUrl: process.env.WEATHER_BASE_URL,\n      apiKey: process.env.WEATHER_API_KEY,\n    },\n\n    \u002F\u002F 伺服器基本設定\n    port: process.env.PORT,\n  };\n\n  const { error, value } = configSchema.validate(config, {\n    abortEarly: false, \u002F\u002F 顯示所有錯誤，而不是第一個錯誤就停止檢查\n  });\n\n  if (error) throw new Error(`環境變數驗證錯誤: ${error.message}`);\n\n  return value;\n};\n```\n\n#### Step 2：安裝 joi 套件\n\nJoi 是一個的 JavaScript 資料驗證函式庫，用來定義和驗證物件的結構規則。透過宣告 Schema 定義，可以確保資料符合預期的格式和約束條件，適合用於環境變數驗證、API 輸入檢查等場景。\n\n```\npnpm install --save joi\n```\n\n#### Step 3：定義 joi schema 驗證環境變數\n\n透過服務分組架構，將環境變數依所屬服務進行物件化管理。這種結構化配置能精確控制參數的必填與選填屬性，並在啟動時完成型別檢查與格式驗證，確保在服務運行前發現並修正配置問題，避免執行時才發現環境變數設定錯誤。\n\n**config\u002Fconfiguration.ts：**\n\n```ts\nconst configSchema = Joi.object({\n  \u002F\u002F Line Bot 相關設定\n  line: Joi.object({\n    channelAccessToken: Joi.string().required(), \u002F\u002F 字串且必填\n    channelSecret: Joi.string().required(), \u002F\u002F 字串且必填\n  }).required(), \u002F\u002F 必填\n\n  \u002F\u002F OpenWeatherMap 相關設定\n  weather: Joi.object({\n    baseUrl: Joi.string().uri().required(), \u002F\u002F uri 格式且必填\n    apiKey: Joi.string().required(), \u002F\u002F 字串且必填\n  }).required(), \u002F\u002F 必填\n\n  \u002F\u002F 伺服器基本設定\n  port: Joi.number().port().default(3000), \u002F\u002F 數字且是有效的端口號，預設值是 3000\n});\n```\n\n#### Step 4：調整 ConfigService 環境變數讀取方式\n\n將原先採用`蛇形命名(snake_case)`的環境變數讀取方式`'LINE_CHANNEL_ACCESS_TOKEN'`，改為使用`物件導向`的讀取方式`line.channelAccessToken`，提供更結構化的配置存取模式。\n\n**config\u002Fline.config.ts**\n\n```ts\nconst lineConfig = (configService: ConfigService): ClientConfig => ({\n  channelAccessToken: configService.getOrThrow\u003Cstring>(\n    'line.channelAccessToken',\n  ),\n  channelSecret: configService.getOrThrow\u003Cstring>('line.channelSecret'),\n}); \n```\n\n#### Step 5：在執行階段指定環境變數\n\n在`package.json`添加`NODE_ENV`環境變數，確保應用程式啟動時就能明確指定執行環境。這種做法可以保證環境變數在應用程式讀取配置之前就已經設定完成。\n\n這部分我們可以藉由 Day 5 配置的 Pino 日誌庫查看不同執行環境下的變化。\n\npackage.json：\n\n```json\n{\n  \"scripts\": {\n    \"start:dev\": \"NODE_ENV=development nest start --watch\",\n    \"start:prod\": \"NODE_ENV=production node dist\u002Fsrc\u002Fmain\",\n    \u002F\u002F 略\n  }\n}\n```\n\n**設置成果驗證**\n\n> 開發環境啟動測試：執行 `pnpm run start:dev`，可以看到 `pino-pritty` 美化後的訊息格式\n\n![開發環境啟動執行畫面](https:\u002F\u002Fres.cloudinary.com\u002Fdseg0uwc9\u002Fimage\u002Fupload\u002Fv1758378973\u002F2025%20IT%20%E9%90%B5%E4%BA%BA%E8%B3%BD\u002FDay%207%EF%BC%9AJoi%20%E7%92%B0%E5%A2%83%E8%AE%8A%E6%95%B8%E7%B5%B1%E4%B8%80%E9%A9%97%E8%AD%89%EF%BC%8C%E9%87%8D%E6%A7%8B%20LINE%20Bot%20%E5%A4%A9%E6%B0%A3%E6%9C%8D%E5%8B%99%E6%A8%A1%E7%B5%84\u002F%E8%BC%B8%E5%85%A5%E7%94%9F%E7%94%A2%E7%92%B0%E5%A2%83%E5%95%9F%E5%8B%95_CLI_%E6%8C%87%E4%BB%A4_f1zfml.png)\n\n> 生產環境啟動測試：執行 `pnpm run build` 建置完成後，透過 `pnpm run start:prod` 驗證完整訊息格式輸出。\n\n![生產環境啟動執行畫面](https:\u002F\u002Fres.cloudinary.com\u002Fdseg0uwc9\u002Fimage\u002Fupload\u002Fv1758379113\u002F2025%20IT%20%E9%90%B5%E4%BA%BA%E8%B3%BD\u002FDay%207%EF%BC%9AJoi%20%E7%92%B0%E5%A2%83%E8%AE%8A%E6%95%B8%E7%B5%B1%E4%B8%80%E9%A9%97%E8%AD%89%EF%BC%8C%E9%87%8D%E6%A7%8B%20LINE%20Bot%20%E5%A4%A9%E6%B0%A3%E6%9C%8D%E5%8B%99%E6%A8%A1%E7%B5%84\u002F%E7%94%9F%E7%94%A2%E7%92%B0%E5%A2%83%E5%95%9F%E5%8B%95%E5%9F%B7%E8%A1%8C%E7%95%AB%E9%9D%A2_opz3jw.png)\n\n#### Step 6：測試 Joi 環境變數驗證機制的有效性\n\n> 刻意清空部分環境變數來驗證 `Joi Schema` 的檢查機制是否正常運作\n\n透過環境變數驗證機制，我們能在應用程式啟動的第一時間就捕捉到配置缺失的問題，避免在執行時期才發現環境變數設定錯誤。這種預防性的檢查大幅提升了系統的穩定性和除錯效率。\n\n![Joi 驗證環境變數有必填未給的缺失情形](https:\u002F\u002Fres.cloudinary.com\u002Fdseg0uwc9\u002Fimage\u002Fupload\u002Fv1758380563\u002F2025%20IT%20%E9%90%B5%E4%BA%BA%E8%B3%BD\u002FDay%207%EF%BC%9AJoi%20%E7%92%B0%E5%A2%83%E8%AE%8A%E6%95%B8%E7%B5%B1%E4%B8%80%E9%A9%97%E8%AD%89%EF%BC%8C%E9%87%8D%E6%A7%8B%20LINE%20Bot%20%E5%A4%A9%E6%B0%A3%E6%9C%8D%E5%8B%99%E6%A8%A1%E7%B5%84\u002FJoi_%E7%92%B0%E5%A2%83%E8%AE%8A%E6%95%B8%E9%A9%97%E8%AD%89%E9%8C%AF%E8%AA%A4_rnedhs.png)\n\n### 重構天氣服務模組\n\n在 Day 6 的實作中，我們將處理第三方 API 的 `fetchWeatherData 函數`放置在 `line-webhook.service` 中。儘管兩者在業務流程上相互關聯，但天氣資料處理邏輯應該獨立抽離為專屬模組，避免服務職責邊界模糊，同時提升程式碼的可維護性與重用性。\n\n#### Step 1：輸入 Nest CLI 指令生成 weather module & service\n\n```\nnest g module weather\nnest g service weather --no-spec\n```\n\n#### Step 2：將 HttpModule 移轉到 weather.module.ts\n\n> -   將 HTTP 請求處理從 `line-webhook.service` 中解耦，統一由 `WeatherModule` 負責天氣相關的所有外部 API 串接邏輯\n> -   透過模組的 `exports` 屬性對外暴露 `WeatherService`，實現服務層的依賴注入。其他模組在匯入 `WeatherModule` 後，可直接注入並使用已實例化的 `WeatherService`，達到跨模組的服務共享與資源複用\n\n**weather\u002Fweather.module.ts**\n\n```ts\nimport { Module } from '@nestjs\u002Fcommon';\nimport { HttpModule } from '@nestjs\u002Faxios';\nimport { WeatherService } from '.\u002Fweather.service';\n\n@Module({\n  imports: [HttpModule],\n  providers: [WeatherService],\n  exports: [WeatherService],\n})\nexport class WeatherModule {}\n```\n\n#### Step 3：將原先處理天氣服務的業務邏輯移轉至 weather.service.ts\n\n> 加上參數驗證，當緯度或經度參數缺失時拋出 HTTP 400 錯誤\n\n**weather\u002Fweather.service.ts**\n\n```ts\n\u002F\u002F 略\n\n@Injectable()\nexport class WeatherService {\n  \u002F\u002F 略\n  async getWeatherByCoordinates(latitude: number, longitude: number) {\n    if (!latitude || !longitude) {\n      throw new HttpException('請提供緯度和經度', HttpStatus.BAD_REQUEST);\n    }\n\n    \u002F\u002F 查詢參數\n    const queryParams = {\n      lat: latitude,\n      lon: longitude,\n      appid: this.WEATHER_API_KEY,\n      units: 'metric',\n      lang: 'zh_tw',\n    };\n\n    try {\n      \u002F\u002F 接收處理完的天氣數據\n      const responseData = await firstValueFrom(\n        this.httpService\n          .get(this.WEATHER_API_BASE_URL, { params: queryParams })\n          .pipe(\n            catchError((err: AxiosError) => {\n              return throwError(\n                () =>\n                  new Error(\n                    `Weather API request failed: ${JSON.stringify(err.response?.data)}`,\n                  ),\n              );\n            }),\n          ),\n      );\n      return this.#formateWeatherInfo(responseData.data);\n    } catch (error) {\n      throw error;\n    }\n  }\n\n  \u002F\u002F 格式化天氣服務的回傳值\n  #formateWeatherInfo(weatherData: CurrentWeatherResponse) {\n      \u002F\u002F 略\n  }\n}\n```\n\n#### Step 4： line-webhook.module 匯入天氣服務模組\n\n> 匯入 `WeatherModule` 實現模組間的依賴注入\n\n**line-webhook\u002Fline-webhook.module.ts**\n\n```ts\n\u002F\u002F 略\nimport { WeatherModule } from 'src\u002Fweather\u002Fweather.module';\n\n@Module({\n  imports: [WeatherModule], \u002F\u002F 將天氣服務模組匯入\n  controllers: [LineWebhookController],\n  providers: [LineWebhookService, LineConfigProvider],\n})\nexport class LineWebhookModule {}\n```\n\n#### Step 5：將原先處理天氣服務的函數移除，改成使用 weather 服務方法呼叫\n\n> 移除原先內嵌的天氣處理函數，透過建構子注入 WeatherService 並呼叫其方法取得天氣資料\n\n```ts\n\u002F\u002F 略\n\n@Injectable()\nexport class LineWebhookService {\n  \u002F\u002F 略\n  constructor(\n    private readonly weatherService: WeatherService,\n  ) {\n  }\n\n  private async handleMessageEvent(event: MessageEvent): Promise\u003Cvoid> {\n    const messageEventHandlerMap = {\n      \u002F\u002F 略\n      location: async (message) => {\n        const { address, longitude, latitude } = message;\n        const defaultMsg = `📍 收到位置訊息\\n🏠 地址：${address}\\n🧭 精度：${longitude}\\n🧭 緯度：${latitude}`;\n\n        \u002F\u002F 透過 weather 服務呼叫取得第三方天氣服務的回傳字串\n        const weatherData = await this.weatherService.getWeatherByCoordinates(\n          latitude,\n          longitude,\n        );\n\n        return `${defaultMsg}\\n\\n${weatherData}`;\n      },\n    } satisfies Partial\u003CMessageEventHandlerMap>;\n\n    let replyMessage = '✨ 感謝你的訊息，我們已經收到了！';\n    const handler = messageEventHandlerMap[event.message.type];\n    if (handler) replyMessage = await handler(event.message);\n\n    await this.lineClient.replyMessage({\n      replyToken: event.replyToken,\n      messages: [{ type: 'text', text: replyMessage }],\n    });\n  }\n}\n\n```\n\n經過模組化拆分後，天氣服務的職責邊界更加清晰。未來若需要擴充不同的天氣資料來源或處理邏輯，可直接在 `WeatherModule` 中進行擴展，其他需要天氣資訊的模組只需透過依賴注入即可複用相關服務，提升程式碼的可維護性與擴展性。\n\n### 本日結語\n\n今天的工作就像蓋房子時的打地基階段，雖然表面上看起來沒什麼大變化，但實際上讓專案的基礎架構變得更加穩固。把環境變數用 `Joi` 管理好，讓天氣服務獨立出來，這些基礎建設重構可以讓之後的開發工作更輕鬆一些。\n",{"title":593,"description":594},{"name":366,"url":367,"day":17},{"loc":592,"images":3217,"lastmod":595},[3218,3219,3220,3221],{"loc":1222},{"loc":1982},{"loc":2001},{"loc":2023},"ithome-2025-day-07","2025-09-20-ithome-2025-day-07",[11,360,362,350],"It9cRFinlYvAMeL9F4b-ZOUw6R22ipHGzF0zoxp_xKU",1792575193719]