如何在Ubuntu下的Qt Creator中配置使用Anaconda Python虚拟环境?
Qt Creator里语言服务器配置和项目运行配置是完全独立的两个模块——你照着官方语言服务器文档配的所有内容,只负责代码补全、语法检查、跳转提示这类静态分析功能,完全不影响点击运行按钮时实际调用哪个Python解释器,这就是你碰到运行时始终走base环境Python的核心原因。
具体配置遗漏/错误点
1. 未修改项目运行配置的可执行路径
- 点击左侧边栏的项目配置图标(小电脑样式),切换到对应项目的「Run」设置页
- 页面中「Run executable」的默认值就是Qt Creator自动探测到的
/home/sahand/anaconda3/bin/python,也就是你报错提示里出现的退出路径 - 手动将该路径替换为目标虚拟环境的解释器:
/home/sahand/anaconda3/envs/tf-n/bin/python - 同页面下的运行参数栏,填写项目入口脚本的绝对路径即可,注意不要重复拼接Python路径
2. 未在全局Python设置中注册自定义解释器
- 打开菜单栏「编辑 -> 偏好设置 -> Python」的全局设置页(注意这是独立的Python语言支持设置,不是语言服务器配置页)
- 在「Python解释器」下拉选项中点击添加,手动选择路径
/home/sahand/anaconda3/envs/tf-n/bin/python,将其加入Qt Creator的可识别解释器列表 - 将该解释器设置为当前项目的默认解释器,避免后续新建运行配置时自动回退到base环境的Python
3. 未同步语言服务器的项目环境指向
- 完成运行解释器配置后,需要回到语言服务器设置页,在对应项目的配置项中指定当前项目使用的Python路径为目标虚拟环境解释器
- 如果仅配置了语言服务器(如Pyright/Pylance)本身的可执行路径,未传递项目venv路径参数,会出现程序能正常运行,但代码补全、依赖识别不到tf-n环境中安装的PySide6等库的次生问题
4. 存在旧配置缓存残留
- 如果修改完上述设置后,运行时仍调用base环境Python,可进入项目根目录,删除Qt Creator生成的隐藏配置文件(如
.cproject、.qttargets.json)中残留的旧Python路径字段 - 完全重启Qt Creator重新加载项目,避免进程缓存沿用旧的解释器配置
你遇到的
/home/sahand/anaconda3/bin/python exited with code 1报错,本质是Qt Creator未切换到tf-n虚拟环境,直接使用base环境Python运行项目,由于base环境缺失项目所需依赖,导致程序启动直接报错退出。
内容的提问来源于stack exchange,提问作者SahandV
相关产品推荐
相关产品推荐

