內容導覽
圖片模糊的罪魁禍首
你一定遇過這個煩人狀況。
每次從 WordPress 媒體庫插入圖片,系統總是自作聰明,自動幫你選用「中」或「大」尺寸。
明明上傳的是高畫質原圖,前台看起來卻一片模糊,排版徹底走樣。
文章圖片一多,你就得被迫手動點選、瘋狂重複調整尺寸,浪費大把時間。
這不是你的錯,這是 WordPress 預設的底層邏輯在阻礙你。
破解預設尺寸的運作機制
WordPress 資料庫的 options 資料表裡,藏著一個叫作 image_default_size 的鍵名。
這個數值直接決定了編輯器叫出媒體庫時,預先勾選的圖片規格。
要一勞永逸解決,我們必須在系統查詢這個選項「之前」,直接進行攔截。
利用 pre_option_image_default_size 這個過濾器(filter),就能強制核心回傳 full 參數。
讓插入行為永遠鎖定原始圖片,不需要再翻轉選單手動點選。
1行代碼終結繁瑣切換
實作步驟非常短,邏輯極度清晰。
將下方這段匿名函式掛載到主題中,即可瞬間生效。
add_filter('pre_option_image_default_size', function() { return 'full'; });此後,只要點擊插入圖片,選項永遠會停留在「完整尺寸」。
如果未來因特殊需求想恢復原狀,直接將此段代碼移除即可,沒有後遺症。
實務部署的踩坑提醒
強制選用 full 尺寸,意味著如果你的原始圖檔動輒數 MB,網頁效能將直接崩潰。
核心觀念:這項優化必須搭配良好的圖片壓縮習慣,或是安裝 Imagify、ShortPixel 等外掛,確保傳輸的實際檔案體積依舊輕量。
另外不用擔心手機版破版,因為 WordPress 底層具備 srcset 響應式屬性。
即使預設代碼指定 full,瀏覽器仍會根據行動裝置的螢幕寬度,自動抓取對應的縮圖進行渲染。
部署時,切記不要直接改動主主題的 functions.php 檔案,否則主題一更新修改就會灰飛煙滅。
建議一律使用子主題,或是安裝 Code Snippets 外掛進行安全管理。
若要針對特定文章類型或使用者角色做排除,亦可在過濾器內部加上 current_user_can() 等條件判斷,保留開發彈性。
文章分享


