使用CLion进行远程开发(Remote Development)

在Windows上使用CLion连接远程Ubuntu服务器进行开发，可以让你在享受Windows系统便利的同时，拥有Linux的编译和运行环境。下面是配置步骤指南。

🔧 远程Ubuntu服务器准备

安装必要的软件
在Ubuntu终端中执行以下命令，安装SSH服务以及C/C++开发所必需的工具链：
bash 复制代码
```
sudo apt update
sudo apt install openssh-server -y
sudo apt install gcc g++ make cmake gdb -y
```

⚙️ CLion客户端配置

接下来，在你的Windows电脑上的CLion中进行配置。

配置远程工具链
- 打开CLion，进入 File > Settings（Windows）。
- 依次导航到 Build, Execution, Deployment > Toolchains。
- 点击左上角的 + 号，选择 Remote Host。
- 在弹出的窗口中：
  - Name：给你的远程配置起个名字，例如"Ubuntu Server"。
  - 点击 Credentials 旁边的齿轮图标，再点击 + 号添加一个新的SSH配置。
  - Host：填写你刚才记录的Ubuntu服务器的IP地址。
  - User name：填写你的Ubuntu用户名。
  - Password：填写对应用户的密码。
  - 点击 Test Connection 测试连接，确保成功。
配置部署映射

此步骤确保CLion知道如何将本地文件同步到服务器的哪个位置。
- 在设置中，进入 Build, Execution, Deployment > Deployment。
- 点击 + 号添加一个新的部署配置，类型为 SFTP。
- 在 Connection 选项卡中，选择刚才在工具链中创建的SSH配置。
- 在 Mappings 选项卡中，设置路径映射关系：
  - Local path：选择你本地Windows上的项目文件夹。
  - Deployment path ：设置代码在远程Ubuntu服务器上存放的路径，例如 ~/project_name。这个路径是相对于SSH用户根目录的。
配置CMake Profile

这是告诉CLion使用远程环境进行构建的关键一步。
- 在设置中，进入 Build, Execution, Deployment > CMake。
- 点击 + 号创建一个新的Profile。
- Name：为此配置命名，如"Remote-Debug"。
- Toolchain：在下拉菜单中，选择第一步创建的远程工具链（如"Ubuntu Server"）。
- CLion会自动检测远程服务器上的CMake等工具。完成后点击 OK。

🚀 开始远程开发

完成以上配置后，就可以开始开发了。

上传项目 ：首次配置时，可以通过菜单 Tools > Deployment > Upload to ... 将本地项目文件上传到远程服务器。
自动上传 ：为了便利，建议开启自动上传功能。在 Settings > Build, Execution, Deployment > Deployment > Options 中，勾选 Upload external changes，这样当你修改文件时，CLion会自动将其同步到远程服务器。
构建和运行：完成上传后，在CLion右上角的运行配置下拉菜单中，选择你刚创建的CMake Profile（如"Remote-Debug"），然后点击运行或调试按钮。CLion就会使用远程Ubuntu服务器上的环境来编译和运行你的程序了。

同步.git到远程服务器：

默认clion不会同步.git到远程服务器，想要在远程服务器可以直接执行git操作，可以进行以下的操作步骤

打开部署设置窗口 ：

路径与您的图片完全一致：File -> Settings -> Build, Execution, Deployment -> Deployment -> Options。
找到排除列表 ：

在 Options 选项卡中，找到输入框："Exclude items by name:"。
编辑列表，移除 .git：
- 列表内容为：.svn;.cvs;.idea;.DS_Store;.hg;.git;*.hprof;*.pyc, 需要将 ;.git 从字符串中删除。

🔍 故障排除与小贴士

CMake版本问题 ：如果远程Ubuntu上的CMake版本较低，可能导致报错"CMake 3.XX or higher is required"。你需要修改项目根目录下的 CMakeLists.txt 文件，将 cmake_minimum_required(VERSION XXXX) 中的版本号修改为远程服务器支持的版本。
调试：CLion同样支持远程调试。你需要创建一个 Remote Debug 的运行配置，并确保远程服务器上运行了 gdbserver 来监听调试端口，然后在CLion中开始调试即可。
符号链接 ：如果遇到文件同步问题，可以尝试按住 Ctrl+Shift+Alt+/，打开Registry，勾选 clion.remote.tar.dereference 可能有助于解决。