编译报错：User::set_user_username(std::string)多重定义问题求助

这个报错是C++链接阶段的典型问题，本质是同一个函数的定义被编译器生成了多份，链接器不知道该选用哪一份。下面是几种最常见的诱因和对应的解决办法：

• 头文件中直接定义非内联成员函数
  如果你在User.h这类头文件里直接写了set_user_username的函数体（而非仅声明），且没有用inline关键字修饰，那么每一个包含该头文件的.cpp源文件，编译时都会生成一份该函数的定义副本。当链接器整合所有目标文件时，就会发现多个完全相同的函数定义，从而抛出冲突错误。

  错误写法示例：

  // User.h
  #include <string>
  class User {
  public:
      // 直接在头文件实现函数体，无inline修饰
      void set_user_username(std::string name) {
          username = name;
      }
  private:
      std::string username;
  };
  

  解决思路有两种：

  1. 将函数体移到对应的.cpp源文件（比如User.cpp），头文件仅保留函数声明：

     // User.h
     class User {
     public:
         void set_user_username(std::string name); // 仅声明
     };
     
     // User.cpp
     #include "User.h"
     void User::set_user_username(std::string name) {
         username = name;
     }
     

  2. 给成员函数加上inline关键字，告知编译器可以将函数体展开，避免生成多份定义：

     // User.h
     class User {
     public:
         inline void set_user_username(std::string name) {
             username = name;
         }
     };
     

• 头文件缺少重复包含保护
  虽然头文件重复包含本身不会直接引发多重定义，但如果头文件内含有函数定义（而非声明），同时没有添加保护机制，多次包含头文件会导致同一个函数被多次插入到不同编译单元中，最终触发链接冲突。

  解决办法是给所有头文件添加保护，常用两种方式：

  // 方式1：使用#ifndef宏（跨编译器兼容）
  #ifndef USER_H
  #define USER_H
  // 头文件内容
  #endif // USER_H
  
  // 方式2：使用#pragma once（主流编译器均支持，写法更简洁）
  #pragma once
  // 头文件内容
  

• 同一个成员函数被多次定义在不同源文件中
  检查项目内所有.cpp文件，是否不小心在多个文件里都实现了User::set_user_username。比如既在User.cpp里写了函数体，又在main.cpp或其他文件里重复实现了一遍，链接器就会识别到两份完全相同的定义，进而报错。

  解决办法是确保该成员函数仅在一个源文件中实现，其他文件仅通过包含头文件来调用它。

内容的提问来源于stack exchange，提问作者Jenny Lee