社群分享圖片與圖示
當使用者在 X、LinkedIn、Slack、Discord 或 WhatsApp 貼上網站連結時,應該出現一張包含可讀標題的大圖。瀏覽器與手機應顯示清晰的圖示。
1. 檢查
- App 資料夾(
src/app/或app/),現有的favicon.ico、icon.*、apple-icon.*、opengraph-image.*、twitter-image.*。 - 根佈局中的
metadataBase。缺少時,og:image 網址會是相對路徑,社群平台會忽略它們。 如果缺少此設定,請新增(參見launch-seo技能,或設定metadataBase: new URL("https://your-domain.com"))。 next.config.*:output: "export"?- 品牌資訊:名稱、標語、主色、標誌(偏好 SVG)。從
globals.css重複使用 token。 - 閱讀對應版本的官方文件:
node_modules/next/dist/docs/01-app/03-api-reference/03-file-conventions/01-metadata/opengraph-image.mdnode_modules/next/dist/docs/01-app/03-api-reference/03-file-conventions/01-metadata/app-icons.mdnode_modules/next/dist/docs/01-app/03-api-reference/04-functions/image-response.md
2. Open Graph 圖片(全站)
將 assets/opengraph-image.tsx 複製到 app/opengraph-image.tsx,並編輯品牌數值。它匯出 alt、size(1200×630)和 contentType,並使用來自 next/og 的 ImageResponse 繪製圖片。
分享圖片的設計規則:
- 標題字數 3–8 個字,至少 64 px,高對比。在 300 px 寬的縮圖上必須可讀。
- 將重要內容保持在中央 1000×500 區域內;部分平台會裁切邊緣。
- 在角落放置品牌標記 + 網域名稱,讓人知道連結去向。
- 僅使用 Flexbox:
ImageResponse支援 CSS 的子集(display: flex,無 grid)。每個包含多個子元素的元素需要display: "flex"。 - 字型:預設字型可直接使用。若要使用自訂字型,請載入
.ttf/.otf/.woff檔案(非.woff2),使用readFile並在fonts選項中傳遞,如文件所示。 - 大小限制:Open Graph 為 8 MB,Twitter 為 5 MB。產生的 PNG 通常小於 100 KB。
twitter-image 為選用:當缺少時,X 會使用 Open Graph 圖片。請確保根 metadata 設定 twitter: { card: "summary_large_image" }。
3. 每頁圖片(部落格文章、文件、產品頁面)
在動態路由區段內新增 opengraph-image.tsx,例如 app/blog/[slug]/opengraph-image.tsx。它接收 params(一個 Promise)並可以載入文章標題;從圖片檔案匯出 generateStaticParams,以便預先渲染每張圖片。保持相同的模板,讓所有分享看起來像同一個品牌。
這比看起來更重要:當某頁面在 metadata/generateMetadata 中設定自己的 openGraph 時,它會取代父層的 openGraph 物件,導致該頁面的根分享圖片消失。區段層級的 opengraph-image 檔案(或明確的 openGraph.images)可以解決此問題。
4. 圖示
檔案(在 app/ 中) | 尺寸 | 用途 |
|---|---|---|
favicon.ico | 32×32(可為多重尺寸) | 瀏覽器分頁,應用程式根目錄必須 |
icon.png 或 icon.svg | 512×512 PNG 或 SVG | 現代瀏覽器,Android |
apple-icon.png | 180×180 | iOS 主畫面 |
您也可以使用 ImageResponse 產生 icon.tsx / apple-icon.tsx — 參見 assets/icon.tsx。在上線前取代預設的 create-next-app favicon.ico;如果沒有可用的 .ico 工具,使用 32×32 的 icon.png 並移除舊的 favicon.ico 是可以接受的。
5. 靜態匯出注意事項
使用 output: "export"(在 Next.js 16.4 上測試):
- 靜態匯出必須關閉
cacheComponents,並且每個產生的圖片檔案(opengraph-image.tsx、icon.tsx、apple-icon.tsx)需要export const dynamic = "force-static";,否則建置會失敗。動態區段也需要generateStaticParams。 - 產生的圖片在匯出時沒有副檔名(
out/opengraph-image),因此靜態主機在提供服務時沒有Content-Type標頭(已在 Cloudflare Pages 上驗證)。部分爬蟲會拒絕這種情況。全站圖片的最佳解決方案:開啟執行中網站的/opengraph-image,儲存它,並提交為app/opengraph-image.png(然後刪除.tsx檔案);它會以正確類型匯出為opengraph-image.png。圖示也相同(app/icon.png、app/apple-icon.png)。對於每篇文章的圖片,請在主機的標頭檔案中(Cloudflare Pages/Netlify 上的public/_headers)為這些路徑設定Content-Type: image/png。
6. 驗證
-
npm run build必須通過。建置輸出會列出opengraph-image路由。 -
啟動網站(
npm run start,或提供out/資料夾)並執行檢查腳本(Node 18+,無相依套件)。<skill-dir>是包含此 SKILL.md 的資料夾:node <skill-dir>/scripts/check-og.mjs http://localhost:3000/ http://localhost:3000/blog/some-post它會讀取頁面的
og:*和twitter:*標籤,下載圖片,並檢查絕對 URL、HTTP 狀態、檔案大小、尺寸(1200×630)、og:image:alt和twitter:card。如果標籤中包含 localhost URL,則會回報,因為這表示metadataBase在正式環境中遺失或不正確。 -
在瀏覽器中開啟圖片 URL 並檢視。確保當瀏覽器視窗較窄時,文字仍然可讀。
-
部署後,告訴使用者使用各平台自己的工具進行測試(LinkedIn Post Inspector、Facebook Sharing Debugger)。這些工具也會重新整理快取的預覽。
報告
列出已建立的圖片和圖示檔案、檢查腳本的輸出,並提醒使用者平台會快取預覽:更改圖片後,請使用上述工具重新抓取。