如何配置本地IDE远程调试控制台模式的Ubuntu 22系统

VS Code 配置步骤 #

• 安装Remote - SSH扩展：在VS Code扩展市场搜索并安装Remote - SSH官方扩展，这是实现远程开发的核心工具。
• 连接远程主机：
  1. 点击左侧活动栏的「远程资源管理器」图标（样式为><双向箭头）。
  2. 选择「SSH Targets」栏，点击"+"号添加远程主机，输入ssh 你的用户名@远程主机IP/域名（例如ssh ubuntu@192.168.1.100）。
  3. 选择保存配置的文件（默认选第一个系统路径即可）。
  4. 在SSH Targets列表找到新增主机，右键选择「Connect to Host in New Window」，输入远程主机密码（配置SSH密钥后可免密）。
• 远程终端与调试配置：
  1. 连接成功后，VS Code窗口标题会显示远程主机标识，此时打开的终端默认就是远程系统的控制台，直接输入命令即可执行。
  2. 调试设置：打开远程主机上的项目目录（或同步本地项目到远程），点击左侧「调试图标」，创建launch.json配置文件。以C/C为例，选择「C/C: gdb Launch」模板，修改program为远程可执行文件路径，miDebuggerPath设为远程gdb路径（通常是/usr/bin/gdb），保存后即可启动调试，断点、变量查看等操作和本地完全一致。
  3. Python等其他语言同理，选择对应语言的调试模板，配置远程解释器路径即可。

CLion 配置步骤 #

• 配置远程部署环境：
  1. 打开CLion，进入File > Settings > Build, Execution, Deployment > Deployment。
  2. 点击"+"号，选择「SFTP」类型，给配置命名（比如「Remote Ubuntu」）。
  3. 在「Connection」标签页填写远程IP、用户名、密码（或SSH密钥），点击「Test Connection」确认连接成功。
  4. 在「Mappings」标签页设置本地项目目录与远程目录的映射（例如本地/home/me/myproj对应远程/home/ubuntu/myproj）。
• 配置远程工具链：
  1. 进入File > Settings > Build, Execution, Deployment > Toolchains。
  2. 点击"+"号，选择「Remote Host」，关联刚才配置的SFTP连接。
  3. CLion会自动检测远程主机上的gcc/g++、gdb等工具，确认路径无误后保存。
• 远程运行与调试：
  1. 打开本地项目，CLion会自动同步文件到远程（也可手动触发Tools > Deployment > Sync with Deployment Target）。
  2. 运行/调试配置：点击右上角配置下拉框，选择「Edit Configurations」，新建对应语言的配置（比如「C/C++ Application」），选择远程工具链，指定远程可执行文件路径，保存后即可点击运行或调试按钮，终端会显示远程执行输出，调试操作完全本地化。
  3. 远程终端：通过View > Tool Windows > Terminal打开终端，在终端右上角选择远程主机终端，直接执行远程命令。

通用优化技巧 #

• SSH免密登录：本地执行ssh-keygen生成密钥对，将~/.ssh/id_rsa.pub的内容复制到远程主机的~/.ssh/authorized_keys文件中，后续连接无需输入密码。
• 文件同步：VS Code可直接操作远程文件；CLion支持自动同步，也可手动用rsync命令：rsync -avz 本地目录/ 用户名@远程IP:远程目录/。
• 调试器版本兼容：尽量保证本地IDE关联的调试器与远程主机的调试器版本一致，避免兼容性问题（比如远程用gdb 12，本地也优先用同版本）。

内容的提问来源于stack exchange，提问作者FourierFlux