安装 Google ADK 后执行 adk web 报错“command not found”，通常是因 Python 版本不兼容或 pip 安装目标错误导致，需使用 Python 3.11+ 及对应 pip3.x 显式安装。

安装 google adk 后执行 `adk web` 报错“command not found”，通常是因 python 版本不兼容或 pip 安装目标错误导致，需使用 python 3.11+ 及对应 pip3.x 显式安装。

Google ADK（Agent Development Kit）要求运行环境为 Python 3.11 或更高版本。官方文档虽未在首屏强调该硬性依赖，但其底层依赖（如 pydantic>=2.5, typing_extensions>=4.8 等）与 Python 3.8/3.9 存在兼容性冲突，导致 pip install google-adk 表面成功，实则未正确注册 CLI 入口点（即 adk 命令），从而触发 Command 'adk' not found 错误。

✅ 正确安装步骤如下：

1. 确认 Python 版本

   python3 --version  # 必须 ≥ 3.11
   # 若为 3.8/3.9/3.10，请升级或切换版本（推荐 pyenv 或 conda）

2. 激活虚拟环境（推荐）

   

   Google Search Grounding 3

   通过 Gemini 搜索落地（主）和 Custom Search JSON API（备）进行 Google 网页搜索。用途：(1) 附引用的综合回答（落地搜索），(2) 含摘要的原始链接结果，(3) 图片搜索。希伯来语支持极佳。优于内置 web_search (Perplexity)。

   下载

   python3.11 -m venv adk-env
   source adk-env/bin/activate  # Linux/macOS
   # 或 adk-env\Scripts\activate.bat  # Windows

3. 使用匹配的 pip 安装（关键！）
   ❌ 错误：pip install google-adk（可能调用旧版 pip 关联的 Python）
   ✅ 正确：pip3.11 install google-adk

   即使已激活 venv，也建议显式使用 pip3.11，确保包安装到目标 Python 解释器的 site-packages 并正确注册 adk 可执行脚本。

4. 验证安装

   adk --version  # 应输出类似 "google-adk 0.4.0"
   adk web        # 启动本地开发服务器

⚠️ 注意事项：

• 不要混用 python3 和 pip 的版本（例如 python3.11 + pip → 可能仍指向系统默认 pip）；始终用 pip3.11 或 python3.11 -m pip。
• 若已错误安装，先彻底清理：pip3.11 uninstall google-adk，再重装。
• Windows 用户请确保 Scripts/ 目录在 PATH 中（venv 激活后通常自动生效）；若仍报错，可尝试 python -m google_adk.cli web 作为临时替代。

完成上述操作后，adk 命令即可被系统识别，后续所有 ADK 工具链（如 adk run multi_agent_tool）均可正常调用。