使用SpaCy运行convert脚本时遇Invalid config override错误如何解决？

核心排查与修复步骤 #

• 检查项目根目录的project.yml文件，定位convert任务的配置段，删除或修正单独的-符号配置项——这是触发错误的直接原因，SpaCy要求配置参数必须以--开头，单独的-属于无效格式。
• 验证SpaCy版本兼容性：运行py -m spacy info查看当前版本，确保是3.x系列（项目基于v3）。版本不符的话执行pip install spacy==3.5.3（可根据项目文档调整具体版本）。
• 清理项目临时文件：删除项目下的corpus、tmp等缓存目录，再重新执行py -m spacy project run convert。
• 显式指定配置文件：使用命令py -m spacy project run convert -- --config config.cfg，通过--分隔命令和配置参数，强制加载正确的配置格式。

辅助排查动作 #

• 确认命令行当前工作目录是克隆的textcat_demo文件夹，否则会加载错误的配置文件。
• 重新克隆项目：删除现有项目文件夹后重新克隆仓库，排除文件损坏的可能。

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