CLion本身不内置Python支持，需手动安装Python插件并配置解释器：先在Settings→Plugins中安装Python Community Edition（免费基础版）或Professional版（含Web框架支持），再于Project→Python Interpreter中添加venv/Conda/Docker等类型解释器，最后通过右键.py文件运行并验证sys.executable路径一致。
CLion 本身不内置 Python 支持，必须手动安装插件并绑定解释器，否则新建 .py 文件只是纯文本，没有语法高亮、跳转或调试能力。
Python 插件必须手动启用，且有两个关键版本
CLion 默认只认 C/C++，Python 插件不是开箱即用的。打开 File | Settings | Plugins，搜索 Python，你会看到两个选项：
-
Python Community Edition：免费，支持基础语法、venv、pip集成、基本调试 -
Python Professional：需订阅，额外支持Django、Flask框架导航、数据库工具、远程解释器等
如果你只写脚本或 CLI 工具，Community 版完全够用；但若涉及 Web 开发或需要类型检查（比如用 Pyright），建议勾选 Include prereleases 并安装最新预发布版——2023.3 起已原生集成 Pyright，比默认的 MyPy 更快更准。
解释器配置不能只选 python.exe，路径和环境类型决定行为边界
进 File | Settings | Project: xxx | Python Interpreter，点 Add 后别急着选系统 Python。常见错误是直接指向 C:\Python39\python.exe，结果后续 pip install 全局污染，或团队协作时环境不一致。
- 用
venv：选Virtual environment→New environment，CLion 会自动在项目根目录建venv/，隔离依赖，适合大多数项目 - 用
Conda：选Conda environment→Existing environment，路径填miniconda3\envs\myenv\python.exe；注意 CLion 不会自动识别conda activate创建的环境，必须显式指定可执行文件路径 - 用
Docker：需提前运行容器并暴露python端口，选Docker类型后填镜像名如python:3.11-slim；适合 CI/CD 或需复现生产环境的场景
配完后务必在 Python 控制台运行 import sys; print(sys.executable)，输出路径必须和你在设置里选的一致，否则补全、调试全失效。
运行配置不自动切换，.py 文件右键 Run 才生效
CLion 默认运行的是 CMakeLists.txt 构建出的可执行文件，不会因为你打开了 main.py 就自动切到 Python 运行器。必须手动触发：
- 右键
.py文件 →Run 'xxx'（第一次会自动生成配置） - 或点击右上角运行配置下拉框 →
Edit Configurations...→ 左上角+→Python→ 指定脚本路径和解释器
容易忽略的点：Working directory 默认是项目根目录，但很多脚本依赖相对路径读取数据（如 ./data/config.json）。如果报 FileNotFoundError，先检查这里是否该改成 $ProjectFileDir$/src 之类。
代码补全失效？先关掉 Code Completion 里的“Autopopup”陷阱
很多人装完插件发现 import numpy 后敲 np. 没提示，不是插件没装好，而是被一个隐藏开关卡住了：
- 进
File | Settings | Editor | General | Code Completion - 取消勾选
Autopopup code completion（尤其 Windows 上常因输入法冲突误触发） - 改为手动按
Ctrl+Space唤出补全，稳定得多
另外，如果用了 Conda 或 venv，但补全仍缺失包名，大概率是解释器没正确加载 site-packages——点开解释器列表右侧的齿轮图标 → Show All... → 选中对应环境 → 点下方文件夹图标，确认路径里包含 Lib/site-packages。
最常被跳过的一步：改完解释器后不重启 CLion，旧缓存会继续干扰类型推导和导入解析。哪怕只是换了个 venv，也建议关掉项目再重开一次。
