运行cell2location脚本时出现‘cannot import name 'parse_use_gpu_arg’错误求助

核心原因 #

这个错误几乎都是cell2location与scvi-tools版本不兼容导致的——parse_use_gpu_arg是scvi-tools旧版本中的函数，新版本已被移除或重命名，而cell2location的特定版本需要依赖该函数存在的scvi版本。

具体修复步骤 #

1. 完全清理现有环境（可选但推荐） #

避免残留依赖冲突，先删除旧环境：

conda remove --name your_env_name --all

2. 严格按照cell2location指定版本创建环境 #

cell2location对scvi-tools的版本有明确约束，不要手动指定scvi版本，直接通过cell2location的安装包拉取兼容依赖：

• 创建并激活conda环境：

conda create -n cell2loc_env python=3.9
conda activate cell2loc_env

• 安装cell2location（优先用pip，conda包可能更新不及时）：

pip install cell2location[tutorials]

如果需要稳定版，可指定版本号：

pip install cell2location==0.1.0[tutorials]

3. 验证依赖版本 #

安装完成后，检查scvi-tools版本是否符合要求：

import scvi
print(scvi.__version__)

对于cell2location v0.1.x，scvi-tools版本应在0.15.x-0.17.x区间；若使用更新的cell2location版本，可查看其setup.py文件确认对应的scvi版本约束。

4. 手动指定兼容的scvi版本（若自动安装无效） #

如果自动安装的scvi版本不匹配，手动卸载后安装兼容版本：

pip uninstall -y scvi-tools
pip install scvi-tools==0.16.0

额外排查点 #

• 检查scanpy版本：过高的scanpy版本可能和scvi冲突，可指定scanpy=1.9.1
• 确认conda环境隔离：运行conda list查看环境内所有包，确保没有意外引入base环境的全局依赖

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