CLion 原生不支持远程开发，必须通过 JetBrains Gateway+Remote Dev Server 实现；远端需 Linux 系统并运行 jetbrains-agent，所有构建调试均在远端执行，本地仅作 GUI 客户端。
CLion 本身不支持原生远程开发，所谓“远程开发”实际是通过 Remote Development 插件（JetBrains Gateway）+ jetbrains-agent 在远端启动 IDE 后端，本地只运行轻量客户端。直接在 CLion 设置里配 SSH 或挂载远程文件系统，无法真正实现远程编译、调试、代码补全等核心功能。
为什么不能直接在 CLion 里填个 SSH 地址就连接？
CLion 的 Deployment 配置和 SFTP 同步只是单向文件上传 / 下载，Build 和 Run 仍走本地工具链；Toolchain 设置里的 SSH Config 仅用于拉取远程 CMake 或编译器路径信息，并不把构建过程发到远端执行。真要远程编译调试，必须让 CMake、GDB、clangd 全部在远端运行。
常见错误现象：
- 改了远程头文件，本地 CLion 不重新索引，补全 / 跳转失效
- 用
SSH Config配了远端 toolchain，但cmake --build仍调本地 Ninja - 手动
ssh运行 GDB 成功，CLion 调试时提示Cannot connect to GDB server
正确路径：用 JetBrains Gateway + Remote Dev Server
这是目前唯一被 JetBrains 官方支持的远程 C++ 开发方式，本质是把 CLion 的后端（包括 clangd、CMake 驱动、GDB 前端集成）完整部署到远端 Linux 机器上，本地只跑 GUI 客户端。
立即学习 “C++ 免费学习笔记（深入）”；
实操关键点：
- 远端必须是 Linux（x86_64 或 aarch64），已安装
glibc >= 2.28；macOS / Windows 不能作 remote server - 本地需单独安装
JetBrains Gateway（不是 CLion），从 官网下载 ，版本需与远端打算安装的 IDE 版本一致（如都为 2024.2） - 远端执行：
curl -fsSL https://download.jetbrains.com/idea/refresh-edition.sh | sh，它会自动下载并启动jetbrains-agent - 首次连接时，Gateway 会提示输入远端 IP 和用户凭证，成功后自动拉取远端 CLion 后端并建立 WebSocket 通道
注意：refresh-edition.sh 启动的是 headless server，不依赖桌面环境，也无需 X11 转发。
CMake 和调试器必须完全走远端
一旦通过 Gateway 连上，所有操作都在远端上下文中执行——这意味着你看到的 CMakeLists.txt 是远端文件系统里的，cmake build directory 是远端路径（如 /home/user/project/cmake-build-debug），GDB 加载的也是远端生成的二进制。
容易踩的坑：
- 本地
.gitignore里排除了cmake-build-*，但远端没忽略，导致远端磁盘被占满；应在远端项目根目录维护一份独立的.gitignore - 远端
GDB版本太低（如 CentOS 7 自带 7.6），无法解析现代 C++20 DWARF5 符号，调试时变量显示为<optimized out>；建议用apt install gdb或源码编译gdb 13+ - 远端防火墙未放开
jetbrains-agent默认端口（1111），Gateway 连接卡在“Connecting……”；检查sudo ufw status或iptables -L
本地文件系统与远程项目的映射关系很弱
Gateway 模式下没有“本地同步副本”的概念。你在编辑器里打开的每个文件，都是实时通过 WebSocket 从远端读取的；保存动作也直接写回远端。本地硬盘上不会自动生成对应文件。
这意味着：
- 不要指望用 VS Code 或 Sublime 同时编辑同一个远程项目——文件锁和缓存不一致会导致内容错乱
- 远端项目若放在 NFS 或 CIFS 挂载点上，I/O 延迟会导致 clangd 索引变慢、补全卡顿；建议将项目放在远端本地磁盘（如
/home/user/src） - 如果需要离线查看代码，只能提前用
rsync -av user@host:/path/to/project ./local-backup手动拉取，但修改后必须再推回去，且无法享受远程构建能力
真正的远程开发，就是把远端当唯一工作机。本地电脑只负责输入和显示，别把它当“主控端”。这点和 VS Code 的 Remote-SSH 插件逻辑一致，但实现层更重、约束更多。
