寻求可跨平台使用的Cosmos DB JSON文档导入命令行工具推荐

现成跨平台dotnet工具（符合你的优先需求） #

目前已经有成熟的跨平台dotnet全局工具可直接使用，无需自行开发：

• 可直接安装官方出品的cosmosdb跨平台命令行工具，安装命令为dotnet tool install -g cosmosdb-cli，全系统（Windows/Mac/Linux）兼容，同时支持本地Cosmos DB模拟器和云端实例。
• 批量导入JSON的命令模板如下：

cosmosdb sql container bulk import --account-endpoint <Cosmos端点> --account-key <访问密钥> --database-name <目标库名> --container-name <目标容器名> --input-path <JSON文件目录路径>/*.json

工具内置冲突处理、批量限速等能力，完全满足预填充需求。

无额外依赖的Azure CLI方案 #

如果不想给团队新增工具安装要求，可以直接用Azure CLI原生能力实现：

• Azure CLI本身是跨平台工具，本地开发者和Azure DevOps默认代理都可直接使用，同时兼容本地模拟器和云端实例。
• 仅需要写10行以内的简单脚本遍历存放静态JSON的目录，调用az cosmosdb sql document create命令逐批插入即可，也可以直接调用批量导入的原生命令实现更高效率。

轻量自研方案 #

如果有自定义逻辑需求（比如导入前校验、字段转换等），可以基于官方Cosmos DB .NET SDK v3+的批量执行API自行开发，核心逻辑代码不超过100行，打包成dotnet全局工具后全团队可统一使用。

兼顾本地开发和Azure DevOps部署场景的最优方案如下：

1. 将所有静态JSON文件统一存放在仓库的固定目录（比如/deploy/cosmos-seed），所有场景复用同一套数据源
2. 编写一套简单的跨平台脚本，支持通过参数传入Cosmos DB端点、密钥、库名、容器名：本地开发时传入模拟器的默认参数，DevOps流水线部署时传入云端实例的参数即可
3. 本地开发环境的初始化指引中加入执行该脚本的步骤，DevOps部署流水线在Cosmos DB资源部署完成后增加执行该脚本的步骤，两端完全复用同一套逻辑，无需额外适配。

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