如何在Django Admin中用非CSS方法隐藏关联字段的铅笔、"+"和"x"按钮

嘿，我来给你分享几个不用CSS就能搞定Django Admin里那些铅笔、+和x按钮的实用方法，完全不用碰样式文件，都是纯Python实现的！

对于外键（ForeignKey）或多对多（ManyToManyField）这类关联字段，我们可以通过重写默认的Widget来移除那些编辑、添加按钮。核心思路是修改Widget的渲染逻辑，把按钮对应的HTML代码注释掉或者直接删除。

针对外键字段的例子 #

假设你有一个Book模型关联了Author模型，想要在Book的Admin页面里隐藏Author字段的铅笔（编辑）和+（添加）按钮：

from django import forms
from django.contrib.admin.widgets import ForeignKeyRawIdWidget
from django.contrib import admin
from .models import Book, Author

# 自定义一个不带编辑/添加按钮的外键Widget
class NoEditForeignKeyWidget(ForeignKeyRawIdWidget):
    def render(self, name, value, attrs=None, renderer=None):
        # 先获取默认的渲染结果
        html = super().render(name, value, attrs, renderer)
        # 注释掉添加和编辑按钮的HTML（避免破坏原有结构）
        html = html.replace('<a class="related-widget-wrapper-link add-related"', '<!--')
        html = html.replace('<a class="related-widget-wrapper-link change-related"', '<!--')
        html = html.replace('</a>', '-->')
        return html

# 在Admin类里直接指定自定义Widget
@admin.register(Book)
class BookAdmin(admin.ModelAdmin):
    def formfield_for_foreignkey(self, db_field, request, **kwargs):
        if db_field.name == 'author':
            kwargs['widget'] = NoEditForeignKeyWidget(
                db_field.remote_field,
                self.admin_site
            )
        return super().formfield_for_foreignkey(db_field, request, **kwargs)

针对多对多字段的例子 #

如果是多对多字段，我们可以继承FilteredSelectMultiple来修改：

from django.contrib.admin.widgets import FilteredSelectMultiple

class NoAddFilteredSelectMultiple(FilteredSelectMultiple):
    def render(self, name, value, attrs=None, renderer=None):
        html = super().render(name, value, attrs, renderer)
        # 移除添加按钮的HTML
        return html.replace('<a class="related-widget-wrapper-link add-related"', '<!--').replace('</a>', '-->')

@admin.register(Book)
class BookAdmin(admin.ModelAdmin):
    def formfield_for_manytomany(self, db_field, request, **kwargs):
        if db_field.name == 'categories':
            kwargs['widget'] = NoAddFilteredSelectMultiple(
                db_field.verbose_name,
                is_stacked=False
            )
        return super().formfield_for_manytomany(db_field, request, **kwargs)

如果某个关联字段你只需要展示，不需要用户编辑或添加新对象，那直接把它加到readonly_fields里就可以了——这样不仅会隐藏按钮，字段还会变成只读状态，操作起来超简单：

@admin.register(Book)
class BookAdmin(admin.ModelAdmin):
    readonly_fields = ('author',)
    # 记得在fields或fieldsets里包含这个字段
    fields = ('title', 'author', 'publication_date')

⚠️ 注意：这个方法会让整个字段无法修改，如果你还需要让用户选择已有对象但不能添加/编辑，就用方法1更合适。

如果你的Admin页面有多个字段需要处理，单独写Widget可能有点繁琐，这时可以自定义一个ModelForm，在表单里统一替换Widget：

from django import forms
from django.contrib.admin.widgets import ForeignKeyRawIdWidget
from django.contrib import admin
from .models import Book

class BookAdminForm(forms.ModelForm):
    class Meta:
        model = Book
        fields = '__all__'
    
    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        # 给author字段替换自定义Widget
        self.fields['author'].widget = NoEditForeignKeyWidget(
            Book._meta.get_field('author').remote_field,
            admin.site
        )
        # 可以在这里继续处理其他字段...

@admin.register(Book)
class BookAdmin(admin.ModelAdmin):
    form = BookAdminForm

这些方法都是纯后端实现，完全不需要写CSS，而且能精准控制每个字段的按钮显示，比全局隐藏更灵活。

内容的提问来源于stack exchange，提问作者Ivan Camilito Ramirez Verdes