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

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

🔧 远程Ubuntu服务器准备

1. 安装必要的软件
   在Ubuntu终端中执行以下命令，安装SSH服务以及C/C++开发所必需的工具链：

   sudo apt update
   sudo apt install openssh-server -y
   sudo apt install gcc g++ make cmake gdb -y
   

⚙️ CLion客户端配置

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

1. 配置远程工具链

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

2. 配置部署映射
   此步骤确保CLion知道如何将本地文件同步到服务器的哪个位置。

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

3. 配置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操作，可以进行以下的操作步骤

1. 打开部署设置窗口：
   路径与您的图片完全一致：File -> Settings -> Build, Execution, Deployment -> Deployment -> Options。

2. 找到排除列表：
   在 Options 选项卡中，找到输入框：“Exclude items by name:”。

3. 编辑列表，移除 .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 可能有助于解决。