CLion 安装失败：提示“Java not found”或启动黑屏
CLion 是基于 JVM 的 IDE，不自带 JRE，Windows/macOS/Linux 上都必须先有兼容的 JDK（17 或 21，推荐 JetBrains Runtime 或官方 OpenJDK）。它不会用系统 PATH 里随便一个 java —— 比如 macOS 自带的 JDK 20+、某些 Linux 发行版预装的 JRE 8，都可能被拒绝。
- Windows：下载 JetBrains Runtime (JBR) 17，解压后在 CLion 启动器快捷方式属性中，把目标路径改成：
"C:\path\to\jbr\bin\javaw.exe" -Djb.restart.code=888 -Djb.vmOptionsFile=... - macOS：不要用
brew install openjdk后直接双击打开；而是终端执行：open -a "CLion.app" --env JAVA_HOME="/opt/homebrew/opt/openjdk@17/libexec/openjdk.jdk/Contents/Home" - Linux：检查
java -version输出是否为 17.x 或 21.x；如果不是，用update-alternatives --config java切换，或在~/.bashrc中显式导出JAVA_HOME
CMakeLists.txt 配置后 CLion 不识别项目
CLion 不是“打开文件夹就自动工作”的编辑器，它依赖 CMake 工具链和正确解析的 CMakeLists.txt。常见现象是项目树空、无代码补全、main() 不标为可运行入口。
- 确保根目录下有
CMakeLists.txt，且第一行是cmake_minimum_required(VERSION 3.20)（CLion 2023.3+ 推荐 ≥3.20） - 不要在
project(...)前写任意非注释语句（比如message("hello")），否则 CMake 配置阶段会静默失败 - 如果用了
find_package(Threads REQUIRED)却没调用target_link_libraries(... ${CMAKE_THREAD_LIBS_INIT})，CLion 可能解析成功但编译报错——这属于配置逻辑错误，IDE 不会预警 - 点击右上角
Reload project按钮（不是 File → Reload project），或按Ctrl+Shift+O（Windows/Linux）/Cmd+Shift+O（macOS）强制重载 CMake
调试时断点不命中：符号未加载或进程跳过
CLion 调试依赖调试信息（-g）、未优化（-O0）和匹配的调试器（GDB/LLDB）。断点灰掉、程序运行不停、变量显示 <optimized out></optimized> 都指向这几个环节出了问题。
- 确认 CMake 配置中设置了
set(CMAKE_BUILD_TYPE Debug)，且没有在add_compile_options(-O2)这类地方覆盖优化级别 - Linux 上默认用 GDB，但某些发行版（如 Ubuntu 24.04）预装的是
gdb-minimal，缺少 Python 支持，会导致断点失效；应安装完整版：sudo apt install gdb - macOS 上若用 Homebrew 安装了 LLDB，需在 CLion Settings → Build → Toolchains 中手动指定
lldb路径（通常是/opt/homebrew/bin/lldb），否则它可能 fallback 到系统自带旧版 - 检查 Run/Debug Configuration 中的 “Build target” 是否选对了可执行目标（不是 static library），且 “Target” 下拉里显示的是实际生成的二进制名（如
myapp，不是myapp.dir）
远程开发连不上 Linux 服务器：SSH 配置与权限陷阱
CLion 的 Remote Development（通过 SSH）不是简单填个 IP 就行。它需要服务器端有完整构建工具链、CMake、编译器，且用户对项目目录有读写执行权限，SSH 登录不能触发交互式提示（如 MOTD、二次认证）。
立即学习“C++免费学习笔记（深入）”；
- 服务器上运行
ssh user@host -o LogLevel=DEBUG3，看是否卡在debug3: auth_read_banner: no banner或PTY allocation request failed—— 前者常因/etc/ssh/sshd_config中PrintMotd no缺失，后者多因PermitTTY yes未启用 - CLion 默认用 SFTP 同步代码，但若服务器
/home/user权限是700且 CLion 尝试创建临时目录失败，会静默降级为只读模式；建议提前在服务器运行：mkdir -p ~/.cache/JetBrains/RemoteDev并确保属主正确 - 不要用密码登录 + 二次验证（如 Google Authenticator）；必须用密钥对，且私钥不能有密码（或提前用
ssh-agentload）；公钥要严格放在~/.ssh/authorized_keys，末尾不能有多余空格或换行 - 远程 CMake 构建目录建议设为绝对路径，如
/home/user/myproject/cmake-build-debug，避免 CLion 在不同 session 间混淆缓存
