在开发使用 FastApi 框架的 Python 某项目时,我遇到了一个因为 Conda 环境配置没有起作用的问题。
我是用 Cursor 编辑器开发 FastApi 项目的,项目运行在 Conda 环境blog
中, 由于使用了 opencc-python-reimplemented,Python 版本要求 3.10.16。于是我创建blog基于此版本:
conda create -n blog python=3.10.16
但 Cursor 的终端显示的 Python 版本却是 2.7,导致项目总是报错。
为了进一步定位问题,我分别在 IDE(Cursor)和本机终端中进入blog
环境时查看。在 IDE 终端和本机终端中执行python --version
以及pip --version
命令后,显示的版本并不一样,IDE 终端中的版本明显是错误的。这就基本确定了问题所在,即 IDE 没有正确使用 Conda 的blog
环境配置。
经排查分析,最后找到解决方案。
- 可在IDE中,通过手动激活 Conda 环境以规避此问题。在终端执行如下命令:
export PATH="/Users/mac/anaconda3/bin:\$PATH";conda activate blog
- 检查
~/.zshrc
文件(我的是Mac, 使用 zsh )。在此文件中,需确保 Conda 的export PATH
配置优先。我发现wirdsurf
相关配置在最后两行,于是将 Conda 的配置置于文件末尾,覆盖了原有的错误顺序。修改完成后,重启Cursor 编辑器。再次在 Cursor 编辑器中运行项目,一切恢复正常了,Python 版本正确显示为 3.10.16,项目得以顺利推进。
在开发过程中,环境配置问题往往是最让人头疼的,好在现在能借助AI,总能找到解决办法。希望这次的经验分享能为大家在处理类似问题时提供一些思路和帮助。