WordPress 媒體庫沒用到的圖片怎麼找出來刪掉（不用外掛）

// 在「媒體」選單底下加一頁「沒用到的圖片」，只列出來，不會自動刪除
add_action( 'admin_menu', function () {
	add_media_page( '可能沒用到的圖片', '沒用到的圖片', 'manage_options', 'zw-unused-images', 'zw_unused_images_page' );
} );

function zw_unused_images_page() {
	global $wpdb;

	// 先收集一定有在用的圖片編號：網站圖示、Logo、頁首圖片、WooCommerce 預設商品圖
	$used_ids = array_map( 'intval', array(
		get_option( 'site_icon' ),
		get_option( 'site_logo' ),
		get_theme_mod( 'custom_logo' ),
		get_option( 'woocommerce_placeholder_image' ),
	) );
	$header   = get_theme_mod( 'header_image_data' );
	if ( is_object( $header ) && ! empty( $header->attachment_id ) ) {
		$used_ids[] = (int) $header->attachment_id;
	}
	// WooCommerce 商品圖庫（每個商品存的是一串用逗號分開的圖片編號）
	foreach ( $wpdb->get_col( "SELECT meta_value FROM {$wpdb->postmeta} WHERE meta_key = '_product_image_gallery'" ) as $gallery ) {
		$used_ids = array_merge( $used_ids, array_map( 'intval', explode( ',', $gallery ) ) );
	}

	$images = get_posts( array(
		'post_type'      => 'attachment',
		'post_mime_type' => 'image',
		'post_status'    => 'inherit',
		'posts_per_page' => 200, // 一次檢查 200 張，圖片很多的網站分批看
		'orderby'        => 'date',
		'order'          => 'ASC',
	) );

	$unused = array();
	foreach ( $images as $image ) {
		$id = $image->ID;
		if ( in_array( $id, $used_ids, true ) ) {
			continue;
		}
		// 1. 精選圖片
		if ( $wpdb->get_var( $wpdb->prepare( "SELECT 1 FROM {$wpdb->postmeta} WHERE meta_key = '_thumbnail_id' AND meta_value = %d LIMIT 1", $id ) ) ) {
			continue;
		}
		// 2. 用檔名找：文章、頁面、範本、可重複使用區塊的內容，自訂欄位，網站設定（小工具等）
		$file = get_post_meta( $id, '_wp_attached_file', true ); // 例如 2026/10/photo.jpg
		$stem = $wpdb->esc_like( preg_replace( '/\.[^.\/]+$/', '', $file ) ); // 2026/10/photo
		$original = '%' . $stem . '.%';  // 原圖 photo.jpg
		$resized  = '%' . $stem . '-%';  // 縮圖 photo-300x200.jpg
		$in_posts = $wpdb->get_var( $wpdb->prepare(
			"SELECT 1 FROM {$wpdb->posts}
			 WHERE post_type NOT IN ( 'revision', 'attachment' ) AND post_status NOT IN ( 'trash', 'auto-draft' )
			 AND ( post_content LIKE %s OR post_content LIKE %s ) LIMIT 1",
			$original, $resized
		) );
		$in_meta = $wpdb->get_var( $wpdb->prepare(
			"SELECT 1 FROM {$wpdb->postmeta} WHERE meta_key <> '_wp_attached_file' AND meta_key <> '_wp_attachment_metadata'
			 AND ( meta_value LIKE %s OR meta_value LIKE %s ) LIMIT 1",
			$original, $resized
		) );
		$in_options = $wpdb->get_var( $wpdb->prepare(
			"SELECT 1 FROM {$wpdb->options} WHERE option_value LIKE %s OR option_value LIKE %s LIMIT 1",
			$original, $resized
		) );
		if ( $in_posts || $in_meta || $in_options ) {
			continue;
		}
		$unused[] = $image;
	}

	echo '<div class="wrap"><h1>可能沒用到的圖片</h1>';
	echo '<p>檢查了 ' . count( $images ) . ' 張，找到 ' . count( $unused ) . ' 張在文章、頁面、精選圖片、商品圖庫和網站設定裡都找不到的圖片。刪除前請先備份，並點開確認。</p>';
	echo '<table class="widefat striped"><thead><tr><th>圖片</th><th>檔名</th><th>上傳日期</th><th></th></tr></thead><tbody>';
	foreach ( $unused as $image ) {
		echo '<tr><td>' . wp_get_attachment_image( $image->ID, array( 60, 60 ) ) . '</td>'
			. '<td>' . esc_html( basename( get_attached_file( $image->ID ) ) ) . '</td>'
			. '<td>' . esc_html( get_the_date( 'Y-m-d', $image ) ) . '</td>'
			. '<td><a href="' . esc_url( get_edit_post_link( $image->ID ) ) . '">查看／刪除</a></td></tr>';
	}
	echo '</tbody></table></div>';
}