Codex++ 插件市场修复失败：`config.toml TOML parse failed` 的解决方法

Codex 插件市场修复失败config.toml TOML parse failed的解决方法摘要本文详细介绍了 Codex 插件市场修复失败并提示config.toml TOML parse failed错误的完整解决方案。文章分析了常见的 TOML 语法错误原因如重复定义配置段、JSON 格式误用、Windows 路径转义错误等提供了一键修复的 PowerShell 脚本并指导用户如何验证配置问题、安全恢复原有配置最终确保插件市场功能恢复正常。一、问题现象在 Windows 上使用 Codex 时点击“插件市场修复”或“一键修复”后出现以下报错插件市场修复失败config.toml TOML parse failed有时还会伴随以下现象Codex 可以打开但插件市场无法注册“工具与插件”页面无法正常使用Codex 启动后长时间停留在 Logo 页面重启 Codex 后问题依旧本地插件目录存在但配置状态显示“未注册”。此时通常不是插件目录本身损坏而是 Codex 的配置文件C:\Users\你的用户名\.codex\config.toml存在 TOML 语法错误导致 Codex 无法读取和修改配置。二、问题原因config.toml是 Codex 使用的 TOML 配置文件。常见错误包括1. 重复定义配置段例如[mcp_servers.test] command node [mcp_servers.test] command python同一个配置段不能重复声明。2. 把 JSON 内容直接写进 TOML错误示例{model:deepseek-v4-flash}正确的 TOML 写法应为model deepseek-v4-flash3. Windows 路径中的反斜杠转义错误可能出错的写法command C:\Users\23670\test.exe推荐改成command C:/Users/23670/test.exe或者使用 TOML 单引号字符串command C:\Users\23670\test.exe4. 字符串缺少引号错误base_url https://api.example.com/v1正确base_url https://api.example.com/v15. 手动修改配置时漏写括号、引号或换行格式错误只要config.toml中有一处语法错误Codex 就可能无法继续注册插件市场。三、解决思路处理流程如下关闭 Codex 和 Codex备份原来的config.toml将损坏配置移走创建一个最小且合法的 TOML 配置重新启动 Codex再次执行插件市场修复修复成功后逐段恢复原配置。这样既能恢复 Codex也不会直接丢失原有配置。四、一键修复 PowerShell 脚本打开 Windows PowerShell复制并执行以下完整脚本$CodexHome$env:USERPROFILE\.codex$ConfigJoin-Path$CodexHomeconfig.toml$StampGet-Date-FormatyyyyMMdd-HHmmss# 1. 关闭 Codex 和 CodexGet-Process-ErrorAction SilentlyContinue|Where-Object{$_.ProcessName-matchCodex|codex-plus-plus}|Stop-Process-Force-ErrorAction SilentlyContinueStart-Sleep-Seconds 2# 2. 确保 .codex 目录存在New-Item-ItemType Directory-Path$CodexHome-Force|Out-Null# 3. 备份并移走损坏的配置if(Test-Path$Config){$BackupJoin-Path$CodexHomeconfig.toml.bad-$StampMove-Item-Path$Config-Destination$Backup-ForceWrite-Host旧配置已备份到$Backup-ForegroundColor Yellow}# 4. 创建最小、合法、无 BOM 的 TOML 文件$Utf8NoBomNew-ObjectSystem.Text.UTF8Encoding($false)[System.IO.File]::WriteAllText($Config,# Temporary clean Codex configurationrn,$Utf8NoBom)Write-Hostn当前配置内容-ForegroundColor GreenGet-Content$ConfigWrite-Hostn配置文件信息-ForegroundColor GreenGet-Item$Config|Select-ObjectFullName,Length,LastWriteTime执行成功后会生成新的配置文件C:\Users\你的用户名\.codex\config.toml其内容只有# Temporary clean Codex configuration这是一份合法的最小 TOML 配置。原来的配置不会被删除而是备份为类似config.toml.bad-20260729-225000五、重新启动并修复插件市场完成上面的 PowerShell 操作后重新启动 Codex打开“关于”页面再次点击“插件市场修复”或“一键修复”等待修复完成点击“重启 Codex”打开“工具与插件”检查插件市场是否恢复。如果不再出现config.toml TOML parse failed说明配置文件问题已经解决。六、如何验证问题是否来自config.toml若系统已安装 Python 3.11 或更高版本可以使用内置的tomllib检查 TOML 语法。在 PowerShell 中执行 import pathlib import tomllib path pathlib.Path.home() / .codex / config.toml try: with path.open(rb) as f: tomllib.load(f) print(config.toml 语法正常) except Exception as e: print(config.toml 语法错误) print(e) |py-如果配置有问题通常会显示Invalid value at line xx, column xx或者Cannot declare (...) twice根据提示的行号检查原配置即可。七、恢复原有模型或 MCP 配置修复成功后不建议直接把整个备份文件覆盖回去否则原来的 TOML 错误也会一起恢复。建议使用记事本或 VS Code 打开备份文件notepad$env:USERPROFILE\.codex\config.toml.bad-时间然后逐段复制以下配置到新的config.toml模型名称模型供应商API Base URLMCP 服务项目信任配置其他自定义选项。每恢复一部分就重启一次 Codex 验证。这样可以快速定位到底是哪一段配置有问题。八、不要直接删除整个.codex目录不建议执行Remove-Item$env:USERPROFILE\.codex-Recurse-Force因为.codex目录中可能还包含用户配置模型供应商信息MCP 配置会话相关数据插件市场信息其他 Codex 本地状态。本次问题只需要处理C:\Users\你的用户名\.codex\config.toml即可。九、最终结论当 Codex 出现插件市场修复失败config.toml TOML parse failed并且 Codex 长时间停留在启动 Logo 页面时应优先检查%USERPROFILE%\.codex\config.toml最稳妥的处理方式是关闭进程 → 备份损坏配置 → 创建最小合法配置 → 重启 Codex → 修复插件市场 → 逐段恢复旧配置本次实际问题通过重置config.toml后已成功解决。