Windows环境命令行创建Kafka主题报“命令语法不正确”错误

本次触发的“命令语法不正确”并非Kafka主题创建参数书写错误导致——尝试的4组命令中，第2、4组的参数逻辑在Kafka 2.5.0版本中完全合规，该版本既支持新的--bootstrap-server无ZooKeeper连接模式，也保留了旧的--zookeeper参数兼容；即使是第3组用单横杠的参数写法，Kafka自带的参数解析器也能正常识别，所有参数层面的问题均不成立。
真正触发系统级“命令语法不正确”报错的原因，是Windows批处理脚本执行层面的解析失败，流程根本没有走到Kafka Java程序的参数校验环节，常见诱因有3个：

• Kafka的安装路径包含空格、中文字符，比如被安装在C:\Program Files\这类带空格的系统目录下，自带的.bat脚本内部对路径变量没有加双引号包裹，会被cmd截断成多个碎片参数，直接触发系统语法报错
• JAVA_HOME环境变量配置指向的JDK路径同样存在空格、中文字符，bat脚本调用Java启动程序时，路径解析失败
• 在PowerShell环境下执行bat脚本，PowerShell对双横杠开头的长参数存在历史兼容问题，会把--开头的内容识别为自身的参数标记，传递给cmd时参数串被截断

1. 先做最小化验证，定位报错位置：进入Kafka安装目录下的bin/windows文件夹，直接执行.\kafka-topics.bat --help
   • 如果连帮助信息都打不出来、依旧报语法错误，优先排查环境问题：把Kafka、JDK都挪到无空格、无中文的纯英文路径下（比如D:\kafka_2.12-2.5.0、D:\jdk1.8），把执行环境从PowerShell换成系统原生cmd，再重新跑--help命令直到能正常输出帮助信息
   • 如果帮助信息可以正常输出，说明环境无异常，按照Kafka 2.5.0的标准双横杠参数写法执行主题创建即可，不要用单横杠的简化写法，避免cmd自身的参数解析冲突：
     • 推荐的无ZooKeeper连接创建命令：.\kafka-topics.bat --bootstrap-server localhost:9092 --create --topic test-topic --partitions 1 --replication-factor 1
     • 兼容的ZooKeeper连接创建命令：.\kafka-topics.bat --zookeeper localhost:2181 --create --topic test-topic --partitions 1 --replication-factor 1

内容的提问来源于stack exchange，提问作者KISHAN