位置：文档库 > C/C++ > 解决C++代码中出现的“error: use of deleted function 'function'”问题

解决C++代码中出现的“error: use of deleted function 'function'”问题

彭佳慧上传于 2024-04-13 06:14

《解决C++代码中出现的"error: use of deleted function 'function'"问题》

在C++开发过程中，开发者常会遇到编译错误提示"error: use of deleted function 'function'"。这类错误通常源于编译器显式删除了某些默认生成的函数，而开发者却尝试调用这些被删除的函数。本文将系统分析该错误的成因、诊断方法及解决方案，帮助开发者快速定位并修复问题。

一、错误本质解析

C++11标准引入了"deleted function"机制，允许开发者显式禁止某些函数的生成。当使用= delete修饰符标记函数时，编译器会阻止该函数的调用。常见的被删除函数包括：

默认构造函数（当类中包含引用成员或const成员时）
拷贝构造函数和拷贝赋值运算符（当类中包含不可拷贝的成员时）
移动构造函数和移动赋值运算符（当显式删除或声明为private时）
析构函数（当类中包含非可访问的析构函数成员时）

编译器在以下情况下会自动删除特殊成员函数：

class NonCopyable {
public:
    NonCopyable() = default;
    NonCopyable(const NonCopyable&) = delete;  // 显式删除拷贝构造
    NonCopyable& operator=(const NonCopyable&) = delete;  // 显式删除拷贝赋值
};

class HasReference {
    int& ref;  // 引用成员阻止默认构造
public:
    HasReference(int& r) : ref(r) {}
    // 编译器自动删除默认构造函数
};

二、常见错误场景

1. 尝试拷贝不可拷贝对象

当类中包含std::unique_ptr或std::mutex等不可拷贝成员时，编译器会删除拷贝构造函数：

#include 

class ResourceHolder {
    std::unique_ptr ptr;
public:
    ResourceHolder(int v) : ptr(std::make_unique(v)) {}
    // 隐式删除拷贝构造和拷贝赋值
};

int main() {
    ResourceHolder r1(42);
    ResourceHolder r2 = r1;  // 错误：调用被删除的拷贝构造函数
    return 0;
}

解决方案：

实现自定义拷贝语义（如果确实需要拷贝）
改用移动语义
禁止拷贝，强制使用引用或指针

2. 引用成员导致的构造问题

包含引用成员的类无法使用默认构造函数：

class RefWrapper {
    int& value;
public:
    RefWrapper(int& v) : value(v) {}  // 必须通过此构造函数初始化
    // 编译器自动删除默认构造函数
};

int main() {
    RefWrapper rw;  // 错误：尝试调用被删除的默认构造函数
    int x = 10;
    RefWrapper rw2(x);  // 正确用法
    return 0;
}

解决方案：

始终通过构造函数初始化引用成员
考虑使用指针替代引用（如果需要重新绑定）

3. const成员的限制

包含const成员的类在默认构造时可能遇到问题：

class ConstMember {
    const int id;
public:
    ConstMember() = default;  // 错误：无法初始化const成员
    // 需要显式提供构造函数
    ConstMember(int v) : id(v) {}
};

解决方案：

为所有const成员提供构造函数初始化列表
考虑是否真的需要const修饰符

4. 继承体系中的删除函数

基类删除的函数会继承影响派生类：

class Base {
public:
    Base(const Base&) = delete;
};

class Derived : public Base {
    // 隐式删除Derived的拷贝构造函数
};

int main() {
    Derived d1;
    Derived d2 = d1;  // 错误：调用被删除的拷贝构造函数
    return 0;
}

解决方案：

重新实现派生类的特殊成员函数
检查继承设计是否合理

三、诊断与修复流程

1. 错误信息分析

典型错误信息包含三个关键部分：

错误类型：error: use of deleted function
被删除的函数签名
调用位置（通常包含行号）

示例：

error: use of deleted function 'ResourceHolder::ResourceHolder(const ResourceHolder&)'
note: 'ResourceHolder::ResourceHolder(const ResourceHolder&)' is implicitly deleted...

2. 定位问题根源

使用以下步骤定位问题：

检查错误信息中提到的类
查看该类是否包含不可拷贝的成员（如unique_ptr、引用等）
检查是否显式或隐式调用了被删除的函数
确认是否需要该函数，或是否应该使用替代方案

3. 修复策略选择

根据具体场景选择修复方案：

场景	推荐方案
需要拷贝语义	实现自定义拷贝构造函数和赋值运算符
需要移动语义	实现移动构造函数和移动赋值运算符
不应拷贝	显式删除拷贝函数并文档化
误用默认构造	提供正确的构造函数参数

四、最佳实践

1. 遵循Rule of Five/Zero

C++11后应遵循Rule of Five（需要管理资源时）或Rule of Zero（依赖成员自动管理）：

// Rule of Zero示例
class ResourceHolder {
    std::vector data;  // 自动管理资源
public:
    explicit ResourceHolder(size_t size) : data(size) {}
    // 不需要自定义析构、拷贝、移动函数
};

// Rule of Five示例
class ManagedResource {
    int* ptr;
public:
    ManagedResource() : ptr(new int) {}
    ~ManagedResource() { delete ptr; }
    ManagedResource(const ManagedResource&) = delete;
    ManagedResource& operator=(const ManagedResource&) = delete;
    ManagedResource(ManagedResource&& other) noexcept : ptr(other.ptr) {
        other.ptr = nullptr;
    }
    ManagedResource& operator=(ManagedResource&& other) noexcept {
        if (this != &other) {
            delete ptr;
            ptr = other.ptr;
            other.ptr = nullptr;
        }
        return *this;
    }
};

2. 使用智能指针管理资源

优先使用智能指针避免手动资源管理：

#include 

class SmartResource {
    std::unique_ptr ptr;
public:
    SmartResource() : ptr(std::make_unique(0)) {}
    // 自动生成正确的移动语义
    // 拷贝构造被隐式删除（正确行为）
};

3. 显式控制特殊成员函数

明确声明需要或不需要的特殊成员函数：

class ExplicitControl {
public:
    ExplicitControl() = default;  // 显式默认
    ~ExplicitControl() = default;
    ExplicitControl(const ExplicitControl&) = delete;  // 禁止拷贝
    ExplicitControl& operator=(const ExplicitControl&) = delete;
    ExplicitControl(ExplicitControl&&) = default;  // 允许移动
    ExplicitControl& operator=(ExplicitControl&&) = default;
};

4. 编译器警告配置

启用相关编译器警告帮助早期发现问题：

GCC/Clang: -Wdelete-non-virtual-dtor, -Wextra
MSVC: /W4, /permissive-

五、复杂案例分析

案例1：多重继承中的删除函数

class NonCopyBase {
public:
    NonCopyBase(const NonCopyBase&) = delete;
};

class CopyableBase {
public:
    CopyableBase() = default;
    CopyableBase(const CopyableBase&) = default;
};

class Derived : public NonCopyBase, public CopyableBase {
    // 隐式删除拷贝构造函数，因为NonCopyBase禁止拷贝
};

int main() {
    Derived d1;
    Derived d2 = d1;  // 错误
    return 0;
}

解决方案：重新考虑继承设计，或为Derived实现自定义拷贝逻辑。

案例2：模板类中的删除函数

template 
class TemplateHolder {
    T data;
public:
    TemplateHolder() = default;
    // 当T为不可拷贝类型时，拷贝构造被删除
};

class NonCopyable {
public:
    NonCopyable(const NonCopyable&) = delete;
};

int main() {
    TemplateHolder h1;
    TemplateHolder h2 = h1;  // 正确
    
    TemplateHolder nh1;
    TemplateHolder nh2 = nh1;  // 错误
    return 0;
}

解决方案：使用SFINAE或C++20概念限制模板参数类型。

六、工具与调试技巧

1. 使用静态分析工具

Clang-Tidy: -checks=*,-llvm-*,-google-*,-hicpp-* +自定义检查
Cppcheck: 检测未初始化的成员变量
PVS-Studio: 专业静态分析工具

2. 编译时断言

使用static_assert验证类特性：

#include 

class AssertCopyable {
public:
    static_assert(std::is_copy_constructible::value,
                 "AssertCopyable must be copy constructible");
};

3. 调试技巧

使用grep -r "= delete"查找项目中的显式删除函数
检查包含不可拷贝成员的类
验证所有构造函数是否正确初始化所有成员

七、总结与预防

"use of deleted function"错误通常源于对C++对象生命周期和资源管理的理解不足。预防此类错误的最佳实践包括：

遵循RAII原则管理资源
明确声明需要的特殊成员函数
优先使用标准库提供的类型（如智能指针、容器）
在团队中建立代码规范，统一资源管理策略
使用现代C++特性（如移动语义、概念）减少错误

通过系统掌握C++对象模型和资源管理机制，开发者可以有效避免这类编译错误，编写出更健壮、更易维护的代码。

关键词：C++、deleted function、拷贝构造函数、移动语义、资源管理、RAII、编译错误、智能指针、继承、模板

简介：本文详细分析了C++中"error: use of deleted function"错误的成因、常见场景和解决方案。通过具体案例讲解了引用成员、const成员、不可拷贝成员等导致的删除函数问题，提供了诊断流程、修复策略和最佳实践，帮助开发者系统掌握资源管理和对象生命周期控制。

立即下载

C/C++相关