Clion与IDF的多版本隔离共存与一键式启动工具环境

安装IDF

懒得管格式舒适了，直接每一步骤列出来：

1.下载源码

这不用多说吧，直接GitHub索索esp-idf就出来了，tag选择好你想下载的版本，不要傻乎乎下到最新版了，万一最新版本还不稳定，出现个神奇bug那你不炸了。

传送门： 点我

x轴350像素，y轴50像素那里有个Tags，进去自己选要下的版本，或者你自己会git的话，自己打开终端输吧。

2.安装idf

打开你下载的版本\esp-idf文件目录，从这里进去cmd，然后需要用到python环境，
重点：决定你能否完全分离式多版本共存的重点就在这里

不同的版本之间需要不同的python环境，这边建议你每一个版本用一个纯净python环境来安装，你可以用docker或者anaconda管理python。

csdn上应该有教程，不过在安装anaconda的时候，有一篇文章貌似让你自己配一个镜像源网站，我的队友按照他的配置来了，结果报错了两小时：），我的建议是就用默认的网站源

回到主题
cmd启动！
然后创建一个纯净环境，conda create --name IDFv5_3 python=python3.9
用conda info --envs看看生成没，创建成功后就可以激活了。
使用conda activate IDFv5_3激活后，前缀出现环境名代表成功
当前cmd激活了python环境后，就可以安装了，进入你git下来的目录路径\esp-idf之后，执行install.bat
初次安装会安装工具链，消耗时间巨长，默认好像是安装到C盘去的，我尝试过更换到D盘，效果不理想，恳请大佬指正:)
我的工具路径在C:\Users\Lenovo.espressif\tools

3.激活环境

安装完之后，就可以激活了，还是回到esp-idf那个目录，执行export.bat 再次强调，用cmd打开，如果是powershell的话，就是.ps1后缀

这样的话基本已经算是成功一半多了，如果出现了某些神奇警告，告诉你某些依赖没有生成，问题丢给AI，这个问题他帮我解决过
现在你这个cmd窗口就有了idf的路径环境变量，但是你需要让你的clion也能有这个路径，一般教程会教你设置成全局path，这样的话，你每次切换版本要去更换全局的路径。但咱这是一般的教程吗？移步下一章。

多版本IDF共存

干脆把clion配置环境和多版本共存放在一起蒜鸟

clion配置idf环境

我们先来给clion的窗口配置一下环境路径。
怎么配置呢，难道是在clion里面的终端执行刚才的操作？
NONONO，自己写一个环境文件才是正解，这个方法是我翻csdn的时候发现的，这里感谢一下csdn上的一位大佬写的这个方法，我也忘记是哪个大佬的文章了，@大佬。
创建一个bat文件里面的内容如下，自己更换一下对应的路径。这个就是刚才我们在cmd里面的操作，构造了一个脚本，每次首次在项目激活工具链的时候就会自动执行这些操作，从而让clion窗口激活好idf环境。

set IDF_TOOLS_PATH=C:\Users\Lenovo\.espressif
@call C:\Users\Lenovo\.espressif\python_env\idf5.3_py3.8_env\Scripts\activate.bat
@call D:\Gitee\esp-adf\esp-idf\export.bat

设置一下工具链，新建一个MinGW2的工具链，名字分隔好，环境文件导入刚才写的就可以了

多版本共存

先检查一下你的全局环境变量有没有idf相关的，如果有的话就删了，每次我们都是在clion或者cmd窗口下才会设置路径。
刚才给clion配置环境文件的方法，只有你成功了，那么你只需要复制粘贴刚才的方法，把每个版本的工具链建造好就可以了。

一键式启动工具环境

那么你们有没有发现，clion的终端就像一坨标记了一处地点。那你只能老老实实去cmd窗口激活工具环境了呗。
那你要面临的操作如下：
conda activate IDF5_3
D:
cd D:\espidf5.3\esp-idf
export.bat
idf.py monitor
好好好，你要是真想每次用工具的时候都这么做的话，那下面的教程可以不看了
直接上操作，根据上述的这些指令，我们可以写好如下脚本

脚本文件

@echo off
chcp 65001 > nul
title ESP-IDFv6.0 环境激活工具

echo [✓] 步骤1：成功运行脚本

REM 第一步：检查conda是否可用
where conda >nul 2>&1
if %errorlevel% neq 0 (
    echo 错误: 未找到conda命令
    echo 请确保Anaconda/Miniconda已安装并添加到系统PATH
    pause
    exit /b 1
)

REM 第二步：激活Conda环境
call conda activate IDF6_0
if %errorlevel% neq 0 (
    echo 错误: 无法激活Conda环境 IDF6_0
    echo 请检查: 
    echo  1. Conda是否已安装
    echo  2. 环境名称是否正确
    echo  3. 是否在Conda基础环境中运行此脚本
    pause
    exit /b 1
)
echo [✓] 步骤2：成功激活Conda环境 IDF6_0

REM 第三步：切换到ESP-IDF目录
set IDF_PATH=D:\espidf_6.0\esp-idf
if not exist "%IDF_PATH%" (
    echo 错误: 目录不存在: %IDF_PATH%
    echo 请检查ESP-IDF安装路径
    pause
    exit /b 1
)
cd /d "%IDF_PATH%"
echo [✓] 步骤3：已切换到 ESP-IDF 目录: %cd%

REM 第四步：运行export.bat设置环境变量
if not exist "export.bat" (
    echo 错误: 未找到 export.bat
    echo 请确认这是正确的ESP-IDF目录
    pause
    exit /b 1
)
call "export.bat"
echo [✓] 步骤4：成功设置ESP-IDF环境变量

echo.
echo ========================================
echo  环境准备完成! 现在可以开始ESP-IDF开发
echo ========================================
echo.

REM 验证环境
where idf.py >nul
if %errorlevel% equ 0 (
    idf.py --version
) else (
    echo 警告: 未找到idf.py命令，环境可能未正确设置
)

REM 返回项目目录
if "%~1" neq "" (
    cd /d "%~1"
    echo [✓] 已切换回项目目录:
)

cmd /k

别问为什么那么多echo和错误检查
DeepSeek是个好东西，你提想法，它来实现。
自己不要直接秒上去了，看看路径相关的，换成自己的文件路径来
接下来配置Clion

Clion外部工具配置

打开设置，找到工具，选择外部工具，这俩是我自己创建的工具

左上角选择新增工具，然后名称自己取，程序cmd.exe就行，实参填写：/c start cmd /k "D:\espidf_6.0\esp-idf\StartIDF6.0.bat" "$ProjectFileDir$"路径自己记得改啊。
工作目录这样填：$ProjectFileDir$，

然后点击应用和确定，不要创建好了不应用:)
接下来呢，你只需要每次到这里使用外部工具就可以，还是有点麻烦怎么办？
clion把状态栏的设计功能开放了，你只需要右键窗口的最上面的空白部分，也就是包含了编译，下载图标的那些地方。

右键后选择自定义工具栏

你想放那边就选中那边，然后点左上角的添加，选中外部工具，然后把刚才定义的外部工具添加进去就可以了。

每个版本来一个工具，真正实现了多版本隔离共存与多版本一键式启动工具环境的功能:)
效果如下

结尾

这是笔者第一次写一个像样的文章，因为clion用起来很顺手，vscode平时就用来写arduino的简单一点的项目，idf的话用clion又比较难配置，逛了csdn，也灭有看到一个比较完整的教程，笔者就想着能自己写一个完整的协同配置的文章出来，方便大家。但是因为赶着回去准备考试，所以这篇文章写的不是很详细，可能就只能充当引导作用，总之如果你按照我的操作来的话，遇见的问题不出意外的话，AI都能帮你解决，但是要注意甄别AI的行为，可能因为表达不到位，让AI给出了错误的操作。
总之你只要知道：idf的灵活摇摆环境依赖export.bat的激活文件，如果你没有设置全局环境路径的话，那么每打开一个新的窗口，不管是cmd还是clion，都会失去之前激活的环境，需要再次激活，每次激活比较麻烦，所以引入了脚本文件。
恳请大佬指正！！

参考文献

[1]csdn某位大佬的clion环境文件的配置
[2]笔者对DeepSeek+豆包的调教日志