常见问题

Windows 引号处理

本文示例按 macOS 与 Linux 语法书写，Windows 的两种 shell 均会移除其中的引号：

mexc spot trade place --data '{"symbol":"BTC_USDT"}'

三种处理方式，推荐第一种，各系统写法一致：

# 写入文件
mexc spot trade place --data "@body.json"

# PowerShell 转义
mexc spot trade place --data '{\"symbol\":\"BTC_USDT\"}'

# 命令提示符转义
mexc spot trade place --data "{\"symbol\":\"BTC_USDT\"}"

未做处理时，工具会提示引号已被 shell 移除，并建议改用文件。

文件编码

Windows 记事本默认以 ANSI 保存，需在「另存为」中将编码改为 UTF-8。VS Code 等编辑器默认使用 UTF-8。

升级与卸载

mexc update --check              # 检查新版本
mexc update                      # 升级
mexc skills update               # 升级后执行，同步 agent 说明文档
npm uninstall -g @mexc-ai/cli    # 卸载

数据目录

macOS 与 Linux 位于 ~/.mexc，Windows 位于 C:\Users\你的用户名\.mexc，存放账号与配置。删除该目录将同时删除全部密钥，需要重新配置。

错误处理

先执行 mexc doctor。单条命令的错误以 JSON 返回，hint 字段说明处理方式：

{
  "error": {
    "type": "validation",
    "subtype": "invalid_argument",
    "message": "--symbol value \"NOTACOIN\" does not match the required pattern",
    "param": "--symbol",
    "hint": "Trading pair in BASE_QUOTE form, e.g. BTC_USDT — required unless symbolId is given"
  }
}

按 hint 处理，不要更换写法反复重试。下单类命令重试可能造成重复下单。

反馈问题时请提供：完整的错误 JSON、mexc --version 输出、mexc doctor 输出。