破解WordPress圖片模糊!1行代碼讓插入圖片永遠維持完整尺寸

圖片模糊的罪魁禍首

你一定遇過這個煩人狀況。

每次從 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() 等條件判斷,保留開發彈性。

文章分享