clion新建项目时需在file | new project对话框中直接填写location（路径）和name（项目名称），路径支持ctrl space自动补全，名称同步用于文件夹名及cmakelists.txt中的project()声明；打开已有项目时必须选择含platformio.ini或cmakelists.txt的根目录，不可仅选源文件；路径严禁含空格或中文，否则cmake将解析失败。
创建新项目时直接指定项目名称和路径
CLion 在新建项目阶段就要求你填这两个关键信息，不是后期补的。点 File | New Project 后，弹出窗口里第一栏是 Location（路径），第二栏是 Name（项目名称）。路径字段支持自动补全：Ctrl Space 触发，输入部分路径名就能下拉选择；名称字段会自动作为项目文件夹名，也用于生成 CMakeLists.txt 中的 project() 名称。
打开已有项目时，“路径”就是 platformio.ini 或 CMakeLists.txt 所在目录
如果你是通过 File | Open 打开一个已有项目，CLion 实际认的是你选中的那个配置文件所在的**最上层文件夹**——比如你选中 platformio.ini，那整个项目根路径就是该文件所在目录；选中 CMakeLists.txt 也一样。注意：不能只选一个 .c 文件，否则 CLion 无法识别为有效项目，会提示“no valid project found”。
项目创建后改名或改路径，得手动同步三处
CLion 不提供“重命名项目”一键操作，硬要改就得同步处理：
- 把项目文件夹本身重命名（比如从
hello_c改成hello_world） - 编辑根目录下的
CMakeLists.txt，更新project(hello_c C)→project(hello_world C) - 如果用了 PlatformIO，在
platformio.ini里检查[env:...]段是否含硬编码路径或名称（一般不用改，但某些自定义脚本可能依赖）
改完必须点击右上角 Reload CMake project（小刷新图标）或右键 CMakeLists.txt → Reload CMake Project，否则 CLion 还按旧名编译。
路径中含空格或中文会导致 CMake 报错，别这么干
这是新手高频翻车点。CMake 对空格极其敏感，C:/Users/张三/Desktop/my project 这种路径会让 cmake_minimum_required 阶段就失败，报错类似 Parse error in command line argument: C:/Users/张三/Desktop/my。解决办法只有两个：
- 路径全程用英文、数字、下划线，不带空格和中文（推荐）
- 非要用中文路径？那就把整个项目挪到
C:/projects/这类干净路径下再打开
工具链检测、GDB 调试器初始化、甚至 CMake 缓存目录（cmake-build-debug）生成都可能因路径不洁而静默失败，这个细节比项目名还关键。
