CLion远程工具链必须手动创建并绑定到CMake/Makefile，仅配SSH终端或Deployment不会触发远程构建；Credential测试失败主因是SSH服务未启、密码认证禁用、家目录权限过严、WSL误用localhost；CMake未用远程工具链表现为日志显“local mode”、修改CMakeLists.txt无反应、状态栏显示“Local”；需在Settings→CMake中手动选择Remote Host条目；路径未自动检测到工具时应手动填绝对路径（如/usr/bin/cmake）；Deployment仅同步文件，Toolchain决定构建位置，二者路径须严格一致。
CLion 远程工具链必须手动创建并显式绑定到 CMake 或 Makefile 配置，仅配 SSH 终端或 Deployment 不会触发远程构建。
Remote Host 工具链创建时 Credential 测试失败的常见原因
测试连接失败通常不是网络问题，而是凭证配置与远程主机实际状态不一致：
- SSH 服务未启用：
systemctl is-active ssh在远程 Linux 上确认返回active - 密码认证被禁用：检查远程
/etc/ssh/sshd_config中PasswordAuthentication yes是否生效，改完需sudo systemctl restart ssh - 用户家目录权限过松：CLion 拒绝连接若远程
~/.ssh或~权限 >755（如chmod 700 ~/.ssh、chmod 755 ~） - WSL 场景下误填 localhost：WSL2 的 IP 每次启动可能变化，建议在 WSL 内运行
cat /etc/resolv.conf | grep nameserver取nameserver行的 IP，而非用localhost或127.0.0.1
CMake 配置未使用远程工具链的典型表现
即使 Remote Host 工具链已创建并测试成功，CMake 仍可能在本地执行，现象包括：
- 构建日志中出现
Running CMake in local mode或路径含C:\...//Users/... - 修改远程
CMakeLists.txt后本地重新加载无反应 - CLion 右下角状态栏显示
Local而非工具链名称（如Ubuntu Server）
解决方式：打开 Settings | Build, Execution, Deployment | CMake，在 Toolchain 下拉菜单中**手动选择你创建的 Remote Host 条目**；不要依赖“自动检测”，该选项默认只认本地工具链。
远程路径未自动检测到 cmake/gcc 时的手动指定
CLion 在首次连接后会尝试扫描远程 $PATH，但常因 shell 初始化文件（如 ~/.bashrc）未被非交互式 SSH 调用而失败。此时你会看到 cmake、gcc 等字段标红或为空：
- 先登录远程终端，运行
which cmake和which gcc确认路径（常见为/usr/bin/cmake、/usr/bin/gcc） - 回到 CLion 工具链设置，在对应字段粘贴完整路径，**不要写别名或 shell 函数**
- 若用交叉编译器（如
aarch64-linux-gnu-gcc），路径通常不在$PATH默认范围，必须手动填绝对路径，例如/opt/gcc-arm-12.2/bin/aarch64-linux-gnu-gcc - 修改后点击
Apply，观察右侧是否变为绿色对勾 —— 仅当全部标绿，CMake 才能正常调用
Deployment mapping 与 Toolchain 的关系容易被混淆
Deployment（SFTP）负责文件同步，Toolchain 负责执行构建命令，二者独立配置但必须路径一致：
- Deployment 的
Local path必须和你打开的 CLion 项目根目录完全一致（Windows 上注意反斜杠转义） - Deployment 的
Deployment path必须与 Toolchain 中“远程工作目录”语义对齐 —— 它应是你在远程机器上期望 CMake 运行的目录，例如/home/user/myproject - 若两者映射错位（比如 Deployment 同步到
/tmp/myproj，但 Toolchain 默认工作目录是/home/user），CMake 会找不到CMakeLists.txt并报错CMake Error: The source directory ".../CMakeLists.txt" does not exist.
真正起作用的是 Toolchain 的工作目录逻辑，Deployment 只管“把本地文件放到哪”，不决定“CMake 在哪跑”。这个分工不厘清，远程构建大概率卡在第一步。
