使用CLion进行远程开发(Remote Toolchain 模式)

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

allnlei

1392人浏览 · 2025-10-24 20:14:35

allnlei · 2025-10-24 20:14:35 发布

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

🔧 远程Ubuntu服务器准备

安装必要的软件
在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中进行配置。

配置远程工具链
- 打开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。
配置Meson Profile
如果是meson项目，则需要配置使用remote Toolchain，及其他定制化的配置。

注： Clion 25.2.4 对meson的支持不是很好，有很多bug，需要手动解决如下一些问题。

Setup options 不起作用，它覆盖掉服务器buildDir的configure。
在服务器端可以用单独的build目录构建

rust需要最新版本，并且安装在/usr/bin, 因为clion的windows端不能读取服务器的.bashrc

如何安装新的rust。

# 添加 Rust PPA（可能有更新的版本）
sudo add-apt-repository ppa:ubuntu-mozilla-security/rust-next
sudo apt update

# 安装/升级 Rust
sudo apt install rustc-1.85 cargo-1.85

# 配置 rustc 的替代版本
sudo update-alternatives --install /usr/bin/rustc rustc /usr/bin/rustc-1.85 100
sudo update-alternatives --install /usr/bin/cargo cargo /usr/bin/cargo-1.85 100

🚀 开始远程开发

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

上传项目：首次配置时，可以通过菜单 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 从字符串中删除。