Colab环境安装GPU版LightGBM触发意外关键字参数报错问题

• 核心原因是手动编译安装的GPU版LightGBM与Colab预装版本存在大版本API断层。Colab默认预装的是正式发布的稳定版（目前为4.x系列稳定版），而直接拉取GitHub主分支源码编译时，默认拉取的是正在迭代的开发版，该版本对训练接口做了破坏性调整：early_stopping_rounds、verbose_eval等原本可直接传入lgb.train()、模型初始化函数的训练控制参数，已被移出主接口参数列表，必须通过回调机制传入，因此会反复触发「意外关键字参数」报错——删掉一个报错参数后，下一个不符合新接口规范的参数会继续触发同类报错，和GPU编译本身没有关系。
• 你使用的安装命令存在冗余和版本遗漏问题：重复执行了两次Python包安装流程，且没有指定源码版本，默认拉取的开发分支本身就和稳定版API不兼容，是问题的直接诱因。

可根据自身需求二选一：

• 方案1：保留原有代码逻辑不变，安装API兼容的GPU版本
  先彻底清理环境中已安装的不兼容版本，再拉取对应稳定版标签的源码编译安装，执行以下命令即可：

  # 卸载所有已安装的LightGBM版本，避免多版本冲突
  !pip uninstall -y lightgbm
  # 拉取v4.3.0稳定版源码，该版本API与Colab默认预装版本完全一致
  !git clone --recursive --branch v4.3.0 https://github.com/Microsoft/LightGBM
  # 编译GPU组件并安装Python包
  !cd LightGBM && rm -rf build && mkdir build && cd build && cmake -DUSE_GPU=1 .. && make -j4
  !cd LightGBM/python-package && python3 setup.py install --precompile
  

  命令执行完成后必须重启Colab运行时，清除Python环境的包缓存，原有代码不需要做任何修改即可正常使用GPU加速，不会再触发参数报错。
• 方案2：保留最新开发版，适配新API修改代码
  如果需要使用主分支最新开发版的特性，需要将原直接传入训练接口的控制参数改为回调形式传入，示例对比如下：
  旧版（稳定版）写法：

  import lightgbm as lgb
  model = lgb.train(
      params,
      train_data,
      valid_sets=[val_data],
      num_boost_round=1000,
      early_stopping_rounds=50,
      verbose_eval=10
  )
  

  新版（开发版）对应写法：

  import lightgbm as lgb
  model = lgb.train(
      params,
      train_data,
      valid_sets=[val_data],
      num_boost_round=1000,
      callbacks=[
          lgb.early_stopping(stopping_rounds=50),
          lgb.log_evaluation(period=10)
      ]
  )
  

  所有原直接传入的训练控制类参数，都需要替换为对应的回调函数传入，否则会持续触发参数报错。

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