必须先安装Python Community Edition插件并配置虚拟环境解释器,否则Run菜单不出现;验证需见语法高亮、右键Run选项及Interpreter页面显示“Package list loaded”。

Python 插件没装,或者解释器没配对,Run 菜单项就不会出现 —— 这是 CLion 里 Python 代码“跑不起来”最常见、也最容易被忽略的起点。
必须先装 Python Community Edition 插件
CLion 默认不带 Python 支持,哪怕你系统里装了 python3,IDE 也完全不认识 .py 文件。
- 打开
Settings/Preferences→Plugins - 搜索
Python,只装Python Community Edition(别选 Professional,它要订阅,且多数人用不到 Web 框架支持) - 安装后重启 CLion —— 不重启,插件不会生效
- 验证是否成功:新建一个
test.py,如果语法高亮、import补全、右键菜单出现Run 'test.py',就说明插件已就位
解释器配置不能选“系统 Python”就完事
选 /usr/bin/python3 或 C:\Python312\python.exe 看似省事,但很快会踩包冲突、权限、版本混用的坑。真实项目几乎都该用虚拟环境。
- 推荐做法:在项目根目录下手动创建
.venv(Linux/macOS:python3 -m venv .venv;Windows:python -m venv .venv) - CLion 配置路径时,不要点 “System Interpreter”,而要点齿轮 →
Add→Virtualenv Environment→Existing environment→ 浏览到.venv/bin/python(macOS/Linux)或.venv\Scripts\python.exe(Windows) - 注意:CLion 不会自动帮你装
pip,如果创建后发现pip命令报错,进终端激活环境后运行python -m ensurepip - Conda 用户:选
Conda Environment类型,路径指向anaconda3/envs/xxx/bin/python(或Scripts\python.exe),别用 Conda 的 base 环境,避免污染
运行配置里三个关键项常被忽略
右键 Run 'xxx.py' 是快捷方式,但背后依赖的是完整的运行配置。很多问题出在参数、工作目录或环境变量上。
SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能,主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ,专为学生、算法学习者和开发者设计;✅ 一个技能,两种用途 :;核心要点📝 题解模式 :输入题目/题号,自动生成完整 Python 题解(含详细注释、解题思路、复杂度分析);💬 注释模式 :输入 Python 代码,自动添加详细中。它将相关步骤、
-
Script path:必须填绝对路径或使用$ProjectFileDir$这类宏,别手输相对路径,CLion 不解析 -
Working directory:默认是项目根目录,但如果脚本里用了open('data.txt'),而data.txt在./input/下,就得手动改成$ProjectFileDir$/input -
Environment variables:默认只有PYTHONUNBUFFERED=1,但遇到ModuleNotFoundError时,很可能需要加PYTHONPATH=$ProjectFileDir$/src(假设模块在src/下) - 调试时想传命令行参数?填在
Parameters栏,空格分隔,含空格的用双引号,比如--input "config v2.json"
混合 C++/Python 项目无法交叉调试是硬限制
CLion 当前(2026 年 8 月)仍不支持在同一个调试会话里既走 Python 断点又走 C++ 断点 —— 这是官方已知限制(CPP-5797),不是你配置错了。
立即学习“Python免费学习笔记(深入)”;
- 若你在写 pybind11 扩展,调试 C++ 部分只能用原生方式:启动 Python 脚本 → 用
Run → Attach to Process→ 选 Native 节点下的进程(不是 Python 节点)→ 再设 C++ 断点 - Python 层逻辑单独调试没问题;C++ 层逻辑必须脱离 Python 解释器上下文单独编译测试,或改用 GDB/LLDB 命令行调试
- 没有“一键 F5 同时进 Python 和 C++”的方案,强行找插件或 hack 只会浪费时间
Settings → Plugins 里 Python 插件状态是否为 enabled,以及 Python Interpreter 页面右上角有没有显示“Package list loaded”。没加载成功,后面所有操作都是空中楼阁。

















