应依次检查Python版本与pip一致性、全局安装Recraft、使用venv隔离环境、手动安装适配WSL2的wheel包、配置正确API密钥环境变量；每步需验证对应操作成功。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在WSL2环境中安装了Python，但无法成功调用Recraft库，则可能是由于库未正确安装、环境隔离或依赖冲突导致。以下是解决此问题的步骤：
一、确认WSL2中Python环境与pip可用性
Recraft库需通过pip安装并依赖Python 3.8及以上版本，必须确保当前使用的Python解释器与pip命令指向同一环境，避免系统Python与conda或pyenv管理的环境混淆。
1、打开WSL2终端，执行python3 --version确认Python版本不低于3.8。
2、执行which python3和which pip3，验证二者路径是否一致或属于同一虚拟环境目录。
立即学习“Python免费学习笔记（深入）”；
3、若路径不一致，使用python3 -m pip --version强制通过Python模块调用pip，避免误用系统pip。
二、使用pip3全局安装Recraft库
Recraft官方PyPI包名为recraft，直接通过pip3安装可确保二进制兼容性，适用于WSL2默认的Ubuntu/Debian发行版。
1、运行sudo apt update && sudo apt install -y python3-pip确保pip3已就绪。
2、执行python3 -m pip install --upgrade pip升级pip至最新稳定版。
3、执行python3 -m pip install recraft安装Recraft库。
4、验证安装：运行python3 -c "import recraft; print(recraft.__version__)"，若输出版本号即表示成功。
三、在venv虚拟环境中安装Recraft
WSL2中多个项目共存时，推荐使用独立虚拟环境避免依赖污染；Recraft可能依赖特定版本的httpx或pydantic，隔离环境可规避冲突。
1、创建新环境：python3 -m venv ~/recraft_env。
2、激活环境：source ~/recraft_env/bin/activate。
3、升级pip：pip install --upgrade pip。
4、安装Recraft：pip install recraft。
5、测试导入：python -c "from recraft import RecraftClient; print('OK')"，如无异常即完成。
四、手动安装适配WSL2的wheel包
若pip install recraft失败并提示编译错误（如missing rust toolchain），说明Recraft含C扩展且未提供预编译wheel，此时应尝试从GitHub获取兼容Linux x86_64的发布包。
1、访问https://github.com/recraft-ai/recraft-python/releases，查找最新tag下后缀为-cp3*.whl且含manylinux或linux_x86_64的文件。
2、使用wget下载对应wheel，例如：wget https://github.com/recraft-ai/recraft-python/releases/download/v0.4.2/recraft-0.4.2-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl。
3、运行python3 -m pip install ./recraft-0.4.2-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl进行本地安装。
4、确认导入可用：必须使用与wheel匹配的Python版本（如cp310对应Python 3.10）。
五、配置Recraft API密钥并验证客户端初始化
Recraft库需有效API密钥才能实例化客户端，密钥须通过环境变量注入，否则调用将立即抛出RecraftAuthError。
1、前往https://recraft.ai/settings/api-keys生成新密钥，复制字符串。
2、在WSL2中执行：echo 'export RECRRAFT_API_KEY="sk-xxx"' >> ~/.bashrc && source ~/.bashrc。
3、启动Python交互环境：python3，然后输入：from recraft import RecraftClient; client = RecraftClient()。
4、若无报错且client对象可调用方法，则RECRRAFT_API_KEY已正确加载；注意环境变量名称为RECRRAFT_API_KEY而非RECRaFT_API_KEY或RECRAFT_API_KEY。
