k3s+ k3d是macos开发者最优解：m1/m2下仅占800mb内存、25秒冷启，原生containerd+sqlite免etcd，arm无兼容问题；minikube适合需完整插件生态者；orbstack启动最快但调试困难。
直接说结论：对大多数 macOS 开发者，k3s（配合 k3d）是当前综合性能、启动速度、资源占用和多节点模拟能力的最优解；minikube 适合需要完整插件生态（如 ingress、metrics-server）且习惯虚拟机驱动的用户；OrbStack 是新锐选择，启动最快、内存最省，但插件支持和调试可见性略弱。
选 k3s + k3d：M1/M2 芯片下实测内存仅 800MB，25 秒冷启
不是所有“轻量”都一样。k3s 原生用 containerd + SQLite 替代 etcd，跳过 Docker Desktop 的抽象层，ARM 架构下无兼容问题。k3d 则把它封装进 Docker 容器里运行——不依赖虚拟机驱动，也不和 Docker Desktop 的 Kubernetes 冲突。
- 必须先禁用 Docker Desktop 内置 K8s：否则
kubectl上下文容易混乱，k3d创建的集群可能被自动覆盖 - 安装命令要带
HOMEBREW_NO_AUTO_UPDATE=1：避免 brew 更新阻塞k3d安装（尤其在 CI 或脚本中） - 创建多节点集群时，
--agents 3后必须加--port 443:443@loadbalancer：否则 Ingress 流量无法路由到 worker 节点 - 默认集群名是
k3d-k3s-default，切上下文用：kubectl config use-context k3d-k3d-k3s-default（注意双k3d-前缀）
用 minikube --driver=docker：绕过 hyperkit 权限问题，适配 Apple Silicon
macOS 14+ 上 hyperkit 驱动常因系统安全策略失败，报错类似 Failed to start host: unable to verify HyperKit binary。改用 --driver=docker 可完全规避——它复用已运行的 Docker daemon，无需额外内核扩展。
- 启动前确认 Docker Desktop 正在运行，且已启用 “Start Docker Desktop when you log in”
- 国内网络下必须加镜像参数：
--image-mirror-country=cn --registry-mirror=https://registry.cn-hangzhou.aliyuncs.com，否则minikube start卡在拉取k8s.gcr.io镜像 -
minikube addons enable ingress后，Ingress Controller 的 Pod 名称是nginx-ingress-controller，但命名空间是kube-system，不是ingress-nginx（这是社区版 Helm chart 的命名，minikube 插件用的是旧版） - 别用
minikube dashboard查看服务日志——它只展示 UI，查 Pod 日志仍得用：kubectl logs -n kube-system deployment/nginx-ingress-controller
OrbStack：5 秒启动，但 kubectl apply 失败时 debug 成本高
OrbStack 确实快，kubectl get nodes 返回 Ready 状态后，集群就可用。但它把所有 K8s 组件打包进一个高度封装的容器中，没有暴露 /var/log、不支持 minikube ssh 类调试入口。
- 遇到
ImagePullBackOff，不能直接docker ps查容器，得用：orbstack logs kubernetes（输出是滚动日志流，没结构化） - Ingress 不支持 HostPath 挂载，
hostPath类型的 PV 会静默失败，报错只有FailedMount，实际原因是 OrbStack 容器未映射宿主机路径 - 它不自动注册
localhost解析，访问http://myapp.test前，必须手动往/etc/hosts加：127.0.0.1 myapp.test - 升级 OrbStack 后，K8s 版本不会自动更新，需手动执行：
orbstack kubernetes upgrade
别忽略 kubeconfig 和 context 切换这个“隐形瓶颈”
多个本地 K8s 方案共存时，kubectl 默认使用 ~/.kube/config，而每个工具都会往里面写 context。你看到 kubectl get nodes 返回空或报错 The connection to the server localhost:6443 was refused，大概率不是集群没起来，而是当前 context 指向了已停用的 docker-desktop 或已删除的 minikube。
- 列出所有 context：
kubectl config get-contexts，当前激活项前面有星号 - 快速切换：
kubectl config use-context k3d-my-cluster或kubectl config use-context minikube - 删掉废弃 context：
kubectl config delete-context docker-desktop（不是delete-cluster） - 如果
kubectl命令卡住超过 10 秒，先运行：nc -zv localhost 6443，不通就说明 context 错了，或者对应集群根本没运行
