codebuddy容器化开发需四步：一、启动docker并安装remote-containers扩展；二、创建.devcontainer目录及devcontainer.json；三、用buddycn devcontainer init自动初始化；四、通过docker-compose.yml支持多服务拓扑；最后验证node.js、git、网络及扩展状态。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在CodeBuddy中启用容器化开发流程，但本地缺乏Docker运行时支持或Dev Containers配置未生效，则可能是由于Docker服务未启动、Remote-Containers扩展缺失，或项目根目录缺少标准的.devcontainer结构。以下是实现CodeBuddy与Docker开发环境集成的具体操作路径：
一、确认并启用Docker运行时与VS Code兼容层
CodeBuddy基于VS Code Remote-Containers架构构建，其容器化能力依赖宿主机Docker引擎及Remote-Containers扩展协同工作。该步骤确保底层基础设施就绪，避免因服务不可用导致容器启动失败。
1、在终端执行docker --version验证Docker CLI是否已安装且可调用。
2、若返回版本号（如Docker version 24.0.7），继续执行sudo service docker start（Linux/macOS）或检查Windows Docker Desktop是否处于运行状态。
3、打开CodeBuddy，按下Cmd+Shift+P（macOS）或Ctrl+Shift+P（Windows/Linux），输入Extensions: Install Extensions，搜索并安装Remote-Containers官方扩展。
4、重启CodeBuddy使扩展生效，此时状态栏右下角应显示Dev Container图标或可点击的容器状态提示。
二、创建标准化.devcontainer配置目录
CodeBuddy通过识别项目根目录下的.devcontainer文件夹及其内部配置文件，自动加载预设的开发容器镜像与工具链。此结构是触发“Reopen in Container”行为的前提条件，必须严格遵循命名与层级规范。
1、在项目根目录下新建名为.devcontainer的文件夹（注意开头为英文点号）。
2、进入该文件夹，创建devcontainer.json文件，内容需包含至少image或dockerfile字段。
3、若使用自定义镜像，devcontainer.json中写入：{"image": "codebuddy/nodejs:20"}；若基于Dockerfile构建，写入：{"dockerfile": "Dockerfile"}。
4、保存后，重新在CodeBuddy中通过File > Open Folder打开该项目根目录，等待编辑器右下角弹出Reopen in Container提示。
三、使用CodeBuddy内置命令行快速初始化配置
CodeBuddy提供buddycn devcontainer init命令，可依据当前项目技术栈自动推断并生成适配的.devcontainer配置。该方式免去手动编写JSON的复杂性，尤其适用于Node.js、Python、Java等主流语言项目。
1、确保已按安装指南执行Install the ‘buddycn’ command步骤，使buddycn全局可用。
2、在项目根目录的内置终端中执行：buddycn devcontainer init --stack nodejs（支持nodejs、python、java17等参数）。
3、命令将自动生成.devcontainer/devcontainer.json与.devcontainer/Dockerfile（如选择Dockerfile模式），并预装Git、ZSH、fzf等开发者工具。
4、执行完毕后，直接点击右下角提示或通过命令面板运行Remote-Containers: Reopen in Container启动环境。
四、通过Docker Compose复用多服务开发拓扑
对于含数据库、缓存、消息队列等依赖组件的复杂项目，仅靠单容器无法满足本地联调需求。CodeBuddy支持将docker-compose.yml作为容器启动入口，实现多服务协同运行的开发环境还原。
1、在项目根目录创建docker-compose.yml，定义服务依赖关系，例如包含app（应用容器）、redis、postgres三个服务。
2、在.devcontainer/devcontainer.json中设置：{"dockerComposeFile": "docker-compose.yml","service": "app","workspaceFolder": "/workspace"}。
3、确保docker-compose.yml中app服务的volumes挂载宿主机项目目录至容器内/workspace路径。
4、执行Remote-Containers: Reopen in Container时，CodeBuddy将自动调用docker compose up拉起全部服务，并将IDE连接至app容器的VS Code Server实例。
五、验证容器内开发环境完整性
容器成功启动后，需确认关键开发组件是否按预期加载。CodeBuddy在容器内预置了生产级Node.js 20、Git、ZSH等工具集，但部分项目可能需额外验证运行时状态与网络连通性。
1、打开容器内集成终端（Terminal > New Terminal），执行node -v确认输出v20.x版本号。
2、执行git status验证工作区是否已正确挂载且Git配置（用户名、邮箱）已继承宿主机设置。
3、若项目含Redis依赖，运行redis-cli -h redis ping（假设compose中服务名为redis），返回PONG表示网络可达。
4、执行code --list-extensions检查预装扩展（如ESLint、Prettier、GitHub Pull Requests）是否已激活，所有扩展须显示“installed in Dev Container”状态。
