Mac上使用maturin时遇到Syn依赖版本不匹配问题

问题描述 #

我正在跟着maturin的快速入门教程操作，创建项目并复制Cargo.toml文件后，运行cargo build时总是遇到下面的错误：

> cargo build
warning: unused manifest key: build-system
warning: unused manifest key: tool
    Updating crates.io index
error: failed to select a version for the requirement `syn = "^2.0.59"`
candidate versions found which didn't match: 2.0.56, 2.0.55, 2.0.54, ...
location searched: crates.io index
required by package `pyo3-macros-backend v0.23.1`
    ... which is depended on by `pyo3-macros v0.23.1`
    ... which is depended on by `pyo3 v0.23.1`
    ... which is depended on by `guessing-game v0.1.0 (/Users/vincent/Development/guessing-game)`

我尝试过重新安装Rust（之前本地的版本已经好几年了），但没有解决问题。谷歌搜索也没找到有用的信息，有人知道怎么解决吗？

解决方案 #

别担心，这个问题是典型的依赖版本索引或缓存冲突问题，试试下面几个步骤：

• 强制指定syn的匹配版本
  直接让cargo下载并使用pyo3所需的syn 2.0.59版本，执行以下命令：

  cargo update -p syn --precise 2.0.59
  

  这个命令会更新你的Cargo.lock文件，把syn的版本锁定到2.0.59，刚好满足pyo3-macros-backend v0.23.1的依赖要求。

• 清除Cargo缓存后重新构建
  如果本地缓存的旧依赖文件干扰了版本匹配，先清除缓存：

  cargo clean
  

  然后再运行cargo build，让cargo重新从crates.io拉取最新的依赖版本。

• 检查并调整pyo3的版本范围
  打开你的Cargo.toml文件，看看pyo3的版本是不是写死了某个特定版本。如果是，改成版本范围（比如pyo3 = "^0.23"），这样cargo会自动选择和syn版本兼容的pyo3版本，避免版本冲突。

原因分析 #

这个问题的核心是pyo3 v0.23.1依赖的syn版本必须是2.0.59，但你的本地crates.io索引可能没有同步到最新状态，或者之前的缓存里没有这个版本，导致cargo找不到对应的匹配版本。更新索引、强制指定版本或者调整依赖范围都能解决这个问题。

备注：内容来源于stack exchange，提问作者cantdutchthis