Skip to content

Kiro IDE 不支持 Dev Containers 的临时方案

问题

Kiro IDE 目前尚未内置 Dev Containers 支持(原生功能仍在开发中)。如果你的项目依赖 devcontainer 环境(特殊依赖、特定运行时),默认情况下 Kiro 会在宿主机环境执行命令,导致命令报错或环境不匹配。

解决方案

方案 A:通过 Steering 强制命令走 devcontainer CLI(推荐)

  1. 安装 devcontainer CLI:

    bash
    npm install -g @devcontainers/cli
  2. 在项目 .kiro/steering/ 下创建 execution.md

    markdown
    ---
    inclusion: always
    ---
    
    # 命令执行规则
    
    ## 所有命令必须在 devcontainer 中执行
    
    绝对不要在宿主机直接运行命令,必须用以下格式包装:

    devcontainer exec --workspace-folder . <命令>

    
    在开始任务前,先确认 devcontainer 已启动:

    devcontainer up --workspace-folder .

  3. 重新打开 Kiro,Agent 会自动将命令包装进 devcontainer 执行。

方案 B:SSH 远程连接到已运行的 devcontainer

  1. 用 VSCode 或 Cursor 启动 devcontainer(这两个 IDE 有原生 Dev Containers 插件)。
  2. 在容器内安装 SSH 服务:
    bash
    sudo apt install -y openssh-server
    sudo service ssh start
  3. 获取容器 IP(宿主机执行):
    bash
    docker inspect <container_id> | grep IPAddress
  4. 在 Kiro 中通过 Remote SSH 连接到该 IP,即可在 devcontainer 环境内工作。

方案 C:使用 devpod 插件(Kiro 扩展市场)

在 Kiro 扩展市场搜索 devpod,安装 devpod 插件,可以通过 devpod 启动 devcontainer 工作区后与 Kiro 集成。功能基本等同,适合团队统一开发环境场景。

注意事项

  • 方案 A 中 Kiro 偶尔会"遗忘" steering 规则(在长对话中),需要手动提醒。
  • 原生 Dev Containers 支持是社区呼声最高的功能(Issue #164 已有 30+ 评论),官方有计划跟进,关注进展可追踪该 Issue。

来源GitHub Issue #164