C++对象共享场景下LNK2005与LNK1169错误排查求助

嘿，刚接触面向对象编程就动手写井字棋，已经很棒啦！你遇到的这个LNK2005错误是C++里很常见的链接问题，核心原因是同一个函数（这里是Player的构造函数）被多次定义了，我来给你拆解下常见的解决办法：

• 第一步：给头文件加上保护机制
  如果你的Player类定义在头文件（比如Player.h）里，当多个.cpp文件都包含这个头文件时，每个.cpp都会生成一份构造函数的定义，链接器就会报错说重复定义。
  解决办法是给头文件加保护，有两种常用方式：

  • 方式一：使用#ifndef系列指令（兼容性最好）：

    #ifndef PLAYER_H
    #define PLAYER_H
    // 这里放Player类的定义和相关代码
    #endif
    

  • 方式二：使用#pragma once（更简洁，大部分主流编译器都支持）：

    #pragma once
    // 这里放Player类的定义和相关代码
    

• 第二步：把成员函数的实现移到.cpp文件中
  如果你的Player构造函数是直接在头文件的类内部实现的（比如Player(Board* b, char c) { ... }），或者在头文件里类外部但没加inline关键字，也会触发重复定义错误。
  正确的做法是：

  • 在Player.h里只放类的声明：

    #pragma once
    #include "Board.h"
    class Player {
    public:
        // 只声明构造函数，不写具体实现
        Player(Board* board, char symbol);
        // 其他成员函数的声明...
    };
    

  • 在Player.cpp里写构造函数的具体实现：

    #include "Player.h"
    Player::Player(Board* board, char symbol) {
        // 这里写构造函数的逻辑代码
    }
    

• 第三步：如果必须在头文件里实现函数，加inline关键字
  要是因为某些需求（比如想让函数做内联优化）必须在头文件里实现成员函数，记得给函数加上inline关键字，告诉编译器这个函数允许被多次定义，链接器不会报错：

  #pragma once
  #include "Board.h"
  class Player {
  public:
      inline Player(Board* board, char symbol) {
          // 构造函数的逻辑代码
      }
  };
  

你可以先从检查头文件保护开始，再调整构造函数的实现位置，这两个是导致这个错误最常见的原因，按照步骤调整后应该就能解决问题啦！

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