kafka 无独立脚本工具路径变量，需将 bin/（linux/macos）或 bin/windows/（windows）加入 path；配置 kafka_home 并更新 path 后，可全局调用 kafka-topics.sh/.bat 等命令。

kafka 本身不提供独立的“脚本工具路径”环境变量，但要让 kafka-topics.sh、kafka-console-producer.sh 等命令在任意目录下直接运行，关键在于把 kafka 的 bin/ 目录（linux/macos）或 bin/windows/ 目录（windows）加入系统 path 环境变量。

---

Linux / macOS 配置方式

• Kafka 的可执行脚本（如 kafka-server-start.sh、kafka-topics.sh）位于解压目录下的 bin/ 子目录中，例如：
  /opt/module/kafka/bin/

• 编辑全局或用户级环境配置文件：

  sudo vim /etc/profile.d/kafka-env.sh

  或（仅当前用户）：

  vim ~/.bashrc

• 添加以下两行（请按你实际安装路径修改）：

  export KAFKA_HOME=/opt/module/kafka
  export PATH=$PATH:$KAFKA_HOME/bin

• 生效配置：

  

  windows-healing-gateway

  通过任务计划程序自动监控并自修复 Windows 上的 OpenClaw Gateway，具备 AI 诊断和 Telegram 报警功能。

  下载

  source /etc/profile.d/kafka-env.sh   # 全局方式
  # 或
  source ~/.bashrc                     # 用户方式

• 验证是否生效：

  echo $KAFKA_HOME
  kafka-topics.sh --version

---

Windows 配置方式

• Kafka 的 Windows 脚本位于 bin\windows\ 目录下，例如：
  D:\kafka_2.13-3.6.0\bin\windows\

• 打开「系统属性 → 高级 → 环境变量」
  → 在「系统变量」中点击「新建」：

  • 变量名：KAFKA_HOME
    变量值：D:\kafka_2.13-3.6.0

• 找到 Path 变量 → 「编辑」→ 「新建」→ 添加：
  %KAFKA_HOME%\bin\windows

• 点击确定保存，重新打开 CMD 或 PowerShell（旧窗口不生效）

• 验证：

  echo %KAFKA_HOME%
  kafka-topics.bat --version

---

注意事项

• 必须先配置好 Java（JDK 8+）和 ZooKeeper（或启用 KRaft 模式），否则脚本即使能调用也会启动失败
• Linux 下脚本需有执行权限：chmod +x $KAFKA_HOME/bin/*.sh
• Windows 若提示“输入行太长”，说明路径嵌套过深 → 建议将 Kafka 解压到盘符根目录（如 D:\kafka\）
• Kafka 3.3+ 支持 KRaft 模式，可跳过 ZooKeeper；但脚本路径配置逻辑不变

---