WordPress 后台富文本编辑器上传图片，如何默认插入原尺寸图片？

在 WordPress 后台编辑文章、页面或 WooCommerce 产品详情时，使用富文本编辑器插入图片，系统默认经常会选择“缩略图”或“中等尺寸”。

如果图片本身是产品图、详情图、长图，插入缩略图会导致前台显示不清晰，或者还需要每次手动切换成“原尺寸”，操作起来比较麻烦。

本文介绍一种简单方法：通过在主题的 functions.php 文件中添加代码，让 WordPress 后台插入图片时默认使用 原尺寸 Full Size。

---

一、问题说明

在 WordPress 后台上传图片时，媒体库右侧通常会有这些选项：

• 对齐

• 链接到

• 尺寸

默认情况下，尺寸可能会自动选择：

• 缩略图

• 中等

• 大尺寸

但很多时候我们希望默认选择：

• 原尺寸

• 不链接

• 无对齐

尤其是在编辑 WooCommerce 产品详情页时，如果每次都手动切换图片尺寸，会影响编辑效率。

---

二、解决方法

把下面代码添加到当前主题的 functions.php 文件中即可。

建议路径：

/wp-content/themes/当前主题/functions.php

也可以放到子主题的 functions.php 中，避免主题更新后代码被覆盖。

---

三、基础版代码：默认插入原尺寸图片

/**
 * 后台媒体库插入图片时，默认使用“原尺寸”
 * 适用于 WordPress 经典编辑器 / WooCommerce 产品描述富文本编辑器
 */
add_action('admin_enqueue_scripts', function () {
    wp_add_inline_script(
        'media-views',
        "
        jQuery(document).ready(function($) {
            if (typeof wp !== 'undefined' && wp.media && wp.media.view && wp.media.view.settings) {
                wp.media.view.settings.defaultProps = wp.media.view.settings.defaultProps || {};
                wp.media.view.settings.defaultProps.size = 'full';
            }
        });
        "
    );
});

/**
 * 同时修改 WordPress 图片默认尺寸设置为原尺寸
 */
add_action('admin_init', function () {
    update_option('image_default_size', 'full');
});

 

添加完成后，刷新 WordPress 后台编辑页面，再次打开媒体库插入图片时，默认尺寸就会变成“原尺寸”。

---

四、推荐版代码：默认原尺寸、不链接、无对齐

如果你希望插入图片时更加干净，比如：

• 默认尺寸：原尺寸

• 默认链接到：无

• 默认对齐：无

可以使用下面这个增强版代码。

/**
 * 后台富文本插入图片默认：
 * 尺寸：原尺寸
 * 链接到：无
 * 对齐：无
 */
add_action('admin_enqueue_scripts', function () {
    wp_add_inline_script(
        'media-views',
        "
        jQuery(document).ready(function($) {
            if (typeof wp !== 'undefined' && wp.media && wp.media.view && wp.media.view.settings) {
                wp.media.view.settings.defaultProps = wp.media.view.settings.defaultProps || {};

                wp.media.view.settings.defaultProps.size = 'full';
                wp.media.view.settings.defaultProps.link = 'none';
                wp.media.view.settings.defaultProps.align = 'none';
            }
        });
        "
    );
});

add_action('admin_init', function () {
    update_option('image_default_size', 'full');
    update_option('image_default_link_type', 'none');
    update_option('image_default_align', 'none');
});

 

一般情况下，推荐直接使用这个增强版。

---

五、代码作用说明

1. 默认图片尺寸设置为原尺寸

wp.media.view.settings.defaultProps.size = 'full';

这行代码的作用是修改媒体库插入图片时的默认尺寸，让它默认选择 full，也就是 WordPress 里的“原尺寸”。

---

2. 默认图片不添加链接

wp.media.view.settings.defaultProps.link = 'none';

这行代码可以让插入的图片默认不链接到附件页，也不链接到媒体文件。

这样可以避免用户点击图片后跳转到无意义的附件页面。

---

3. 默认图片无对齐

wp.media.view.settings.defaultProps.align = 'none';

这行代码可以让图片默认不添加左对齐、居中、右对齐等样式。

对于产品详情页、图文详情页来说，通常让图片跟随页面内容自然显示会更合适。

---

4. 同步更新 WordPress 默认设置

update_option('image_default_size', 'full');
update_option('image_default_link_type', 'none');
update_option('image_default_align', 'none');

这几行代码会同步修改 WordPress 数据库里的默认媒体设置，确保后台媒体库的默认选项更稳定。

---

六、使用注意事项

1. 代码只影响之后新插入的图片

这段代码不会自动修改已经插入到文章、页面或产品描述里的旧图片。

如果之前已经插入的是缩略图，需要重新插入，或者手动修改图片 HTML。

---

2. 建议使用子主题

如果代码直接写在父主题的 functions.php 文件里，后续主题更新时可能会被覆盖。

更推荐放到：

/wp-content/themes/子主题/functions.php

或者使用 Code Snippets 插件添加代码。

---

3. 修改前建议备份

编辑 functions.php 前，建议先备份原文件。

如果代码粘贴错误，可能会导致网站后台或前台报错。

---

七、总结

WordPress 默认插入缩略图虽然适合部分文章场景，但对于产品详情页、长图页面、图片展示页面来说，默认插入原尺寸会更加方便。

只需要在 functions.php 中添加一段代码，就可以让后台富文本编辑器插入图片时默认使用：

• 原尺寸

• 不链接

• 无对齐

这样可以减少重复操作，提高内容编辑效率。