CLion可直接用Docker容器作本地开发环境，但必须正确配置Docker工具链和绑定该工具链的CMake Profile，否则出现头文件找不到、gdb缺失、CMake假阳性报错；需先启用Docker插件、验证CLI路径、镜像预装gdb/gdbserver/rsync、CMake生成路径设为容器内路径（如/app/build），并确保容器启动时添加--cap-add=SYS_PTRACE。
CLion 能直接用 Docker 容器当本地开发环境，但必须配对工具链 + CMake Profile，否则头文件找不到、gdb 找不到、CMake 报错全是假阳性。
配置 Docker 工具链前先确认 Docker 插件已启用
CLion 默认捆绑 Docker 插件，但可能被手动禁用。进 Settings > Plugins，在 Installed 标签页搜 Docker，确保复选框勾选。没启用的话，后续所有 Docker 相关设置项都会灰掉。
再检查 Docker CLI 路径是否被正确识别：
- Linux/macOS：默认应为
/usr/local/bin/docker - Windows：通常是
C:\Program Files\Docker\Docker\resources\bin\docker.exe
如果 CLion 没自动检测到，手动填入路径并点 Test Connection。失败常见原因：Docker Desktop 未运行、WSL2 后端未启用、或 Windows 上 Docker 的 TCP 端口（2375）未开放。
创建 Docker 工具链时镜像必须含完整调试工具链
只装 gcc 和 cmake 不够，gdb、gdbserver、rsync 缺一不可。否则 CLion 在容器内启动调试会卡在 “Waiting for debugger connection”，或者报错 Cannot find gdb。
推荐的最小化 Dockerfile 片段：
FROM ubuntu:22.04
RUN apt-get update && \
apt-get install -y build-essential cmake gdb gdbserver rsync && \
rm -rf /var/lib/apt/lists/*
WORKDIR /app
COPY . .
CMD ["bash"]注意：gdbserver 是 CLion 远程调试必需组件，不是可选；rsync 用于文件同步，缺了会导致修改代码后容器内文件不更新。
CMake Profile 必须绑定 Docker 工具链且生成路径在容器内
新建 CMake Profile 时，Toolchain 下拉菜单里必须选中你刚建好的 Docker 工具链（名称带 “Docker” 字样），不能选系统或 MinGW。否则 CLion 仍用宿主机编译器索引，#include <vector></vector> 都标红。
关键参数：
-
Build directory填容器内路径，如/app/build（不是C:\project\build） -
Generator推荐选Let CMake decide，避免 Ninja/Make 冲突 - 勾选
Use same build directory for all profiles可省事，但多配置时容易混
保存后点 Reload CMake Project。此时 CLion 会自动把项目目录挂载进容器、执行 cmake --version 和 g++ --version 验证，并重建符号索引——这个过程可能耗时 1–3 分钟，别误以为卡死。
调试失败大概率是端口或权限问题
CLion 调试容器内程序，本质是容器内启 gdbserver 监听，CLion 宿主机连过去。常见断点无效或连接超时，往往不是代码问题：
- 容器启动时没加
-p 1234:1234映射调试端口（CLion 默认用 1234，可在Run > Edit Configurations > Docker > Port mappings改） - 镜像里没开
gdbserver权限：Ubuntu 默认禁止非 root 用户调用ptrace，需在容器启动命令加--cap-add=SYS_PTRACE - SSH 不是必须的——除非你用的是 Remote Host 工具链；Docker 工具链走的是容器直连，跟 SSH 完全无关，配了反而干扰
真正要盯住的只有三件事：工具链选对、CMake Profile 绑定对、容器有 gdbserver + SYS_PTRACE。其余花活（比如自建 SSH、改 /etc/ssh/sshd_config）在 Docker 工具链模式下全是冗余操作。
