CodeBuddy的Docker支持需四步配置：一、确认Docker引擎就绪（docker --version验证并启动服务）；二、安装Remote-Containers扩展；三、在项目根目录创建.devcontainer文件夹及devcontainer.json配置文件；四、验证容器内Node.js、Git、网络及扩展状态。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
CodeBuddy 的 Docker 支持不是“一键开关”，而是通过配置开发容器（Dev Container）来启用。核心在于让 CodeBuddy 能识别并连接到本地 Docker 引擎，再加载项目专属的容器环境。只要四步到位，就能稳定运行容器化开发。
确认 Docker 运行时已就绪
这是最基础也最容易卡住的环节。CodeBuddy 本身不内置 Docker，必须依赖宿主机的 Docker 引擎。
- 终端执行 docker --version，看到类似 Docker version 24.0.7 即表示 CLI 可用
- 若提示命令未找到，需先安装 Docker：Linux/macOS 推荐用阿里云镜像源一键安装（
curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun）；Windows 用户直接下载 Docker Desktop 并启动 - 确保服务正在运行：
sudo systemctl enable --now docker（Linux）、检查 Docker Desktop 图标是否常驻状态栏（macOS/Windows）
安装 Remote-Containers 扩展
CodeBuddy 基于 VS Code 的 Remote-Containers 架构，该扩展是连接 IDE 与容器的桥梁。
- 在 CodeBuddy 中按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入 Extensions: Install Extensions
- 搜索 Remote-Containers，选择官方 Microsoft 发布的版本安装
- 安装完成后重启 CodeBuddy，右下角状态栏应出现 Dev Container 相关图标或提示
创建 .devcontainer 配置
这是触发“在容器中重新打开”功能的关键结构，必须严格命名和放置。
- 在项目根目录下新建文件夹，命名为 .devcontainer（开头带英文点号，不可写成 devcontainer 或 .devcontainer.json）
- 在该文件夹内创建 devcontainer.json 文件，内容至少包含镜像或构建路径，例如：
或基于本地 Dockerfile：
{ "dockerfile": "Dockerfile" }- 保存后，用 CodeBuddy 的 File → Open Folder 重新打开该项目根目录，等待右下角弹出 Reopen in Container 提示
验证与调试常见问题
即使配置完成，也可能因细节缺失导致容器无法启动。建议快速核对以下几项：
-
Node.js / Git / curl 是否可用：进入容器终端（Ctrl+Shift+P → Dev Container: Open Console），运行
node -v、git --version -
网络是否连通：容器内执行
ping google.com或curl -I https://api.github.com - 扩展是否生效：在容器内打开 Extensions 面板，确认常用插件（如 ESLint、Prettier）已自动安装并启用
- 若提示 “Cannot connect to the Docker daemon”，说明 Docker 服务未运行或当前用户无权限——可尝试将用户加入
docker组（sudo usermod -aG docker $USER）并重新登录
