在Mac上快速搭建Kafka环境有两种主流方式：一是用Homebrew原生安装Kafka与ZooKeeper，便于深度调试；二是用Docker容器化部署，实现环境隔离与多版本并行。
如果您希望在Mac上快速搭建一个可用于本地开发、测试或学习的Kafka消息队列环境，则需完成Kafka及其依赖组件ZooKeeper的安装与基础配置。以下是两种主流且经过验证的可行路径：
一、使用Homebrew进行原生安装
该方式将Kafka及ZooKeeper作为系统级服务直接安装至macOS，便于直接访问配置文件、日志和命令行工具，适合需要理解底层机制或进行深度调试的开发者。
1、确保已安装Xcode Command Line Tools。打开终端，执行：
xcode-select --install
2、若尚未安装Homebrew，先运行官方安装脚本：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
3、执行Kafka安装命令，Homebrew将自动拉取并安装Kafka及其依赖ZooKeeper：
brew install kafka
4、确认配置文件位置：ZooKeeper配置位于 /usr/local/etc/kafka/zookeeper.properties，Kafka服务配置位于 /usr/local/etc/kafka/server.properties。
5、依次启动ZooKeeper与Kafka服务：
zookeeper-server-start /usr/local/etc/kafka/zookeeper.properties
kafka-server-start /usr/local/etc/kafka/server.properties
二、使用Docker一键容器化部署
该方式通过标准化容器封装Kafka与ZooKeeper，完全隔离宿主机环境，避免Java版本、端口冲突或配置污染问题，特别适用于快速验证、多版本并行或环境一致性要求高的场景。
1、确保已安装Docker Desktop for Mac，并已启动后台服务。
2、创建docker-compose.yml文件，内容如下（保存至任意目录，例如~/kafka-docker）：
version: '3'
services:
zookeeper:
image: confluentinc/cp-zookeeper:7.3.2
environment:
ZOOKEEPER_CLIENT_PORT: 2181
kafka:
image: confluentinc/cp-kafka:7.3.2
depends_on:
- zookeeper
ports:
- "9092:9092"
environment:
KAFKA_BROKER_ID: 1
KAFKA_ZOOKEEPER_CONNECT: zookeeper:2181
KAFKA_LISTENER_SECURITY_PROTOCOL_MAP: PLAINTEXT:PLAINTEXT,PLAINTEXT_HOST:PLAINTEXT
KAFKA_ADVERTISED_LISTENERS: PLAINTEXT://kafka:29092,PLAINTEXT_HOST://localhost:9092
KAFKA_LISTENERS: PLAINTEXT://0.0.0.0:29092,PLAINTEXT_HOST://0.0.0.0:9092
KAFKA_INTER_BROKER_LISTENER_NAME: PLAINTEXT
KAFKA_OFFSETS_TOPIC_REPLICATION_FACTOR: 1
KAFKA_TRANSACTION_STATE_LOG_MIN_ISR: 1
KAFKA_TRANSACTION_STATE_LOG_REPLICATION_FACTOR: 1
3、在该文件所在目录下执行启动命令：
docker-compose up -d
4、验证容器运行状态：
docker-compose ps，应显示zookeeper与kafka均处于“Up”状态。
三、验证Kafka环境是否就绪
无论采用哪种安装方式，均需通过创建Topic、生产与消费消息来确认服务连通性与功能完整性。
1、创建名为test的主题，分区数为1，副本数为1：
kafka-topics --create --bootstrap-server localhost:9092 --topic test --partitions 1 --replication-factor 1
2、列出当前所有Topic，确认test已存在：
kafka-topics --list --bootstrap-server localhost:9092
3、启动控制台生产者，向test发送测试消息：
kafka-console-producer --bootstrap-server localhost:9092 --topic test
4、另开一个终端窗口，启动控制台消费者，从头开始读取消息：
kafka-console-consumer --bootstrap-server localhost:9092 --topic test --from-beginning
5、在生产者终端中输入任意文本并回车，观察消费者终端是否实时输出相同内容。若可见输出，则说明Kafka消息流转链路已打通。
