Swift项目导入CCUDD模块失败：VSCode依赖识别问题求助

问题场景 #

在Ubuntu 22.04的VSCode环境中运行Swift 5.10项目，尝试从Git仓库导入CCUDD包时，执行import CCUDD始终报错：no such module 'CCUDD'sourcekitd。已尝试重命名依赖、调整版本范围，问题仍未解决。

本地项目的Package.swift #

// swift-tools-version: 5.10
import PackageDescription

let package = Package(
    name: "CUDD",
    products: [ .library(name: "CUDD", targets: ["CUDD"]),],
    dependencies: [
        .package(url: "https://github.com/danielaisen/CCUDD.git", from: "1.1.0")
    ],
    targets: [        
        .target(
            name: "CUDD", 
            dependencies: ["CCUDD"],
            path: "Sources"),
        .testTarget(
            name: "CUDDTests", 
            dependencies: ["CUDD"])]
)

CCUDD仓库的Package.swift #

// swift-tools-version:5.3
import PackageDescription

let package: Package  = Package(
    name: "CCUDD",
        products: [ .library(name: "CCUDD", targets: ["CCUDD"]),],
    targets: [
        .target(
            name: "CCUDD", 
            dependencies: [], 
            path: "Sources"),
    ]
)

解决步骤 #

• 清理包缓存并更新依赖
  执行以下命令重置本地依赖状态：

  swift package clean
  rm -rf .build
  swift package update
  

• 明确依赖引用方式
  将target的依赖声明改为完整的product引用格式，避免歧义：

  .target(
      name: "CUDD", 
      dependencies: [.product(name: "CCUDD", package: "CCUDD")],
      path: "Sources"),
  

• 验证Swift版本兼容性
  虽然Swift 5.10兼容5.3的工具版本，但可尝试在本地依赖中指定更明确的版本范围，或fork CCUDD仓库将其swift-tools-version改为5.10后重新引用。

• 重置VSCode语言服务
  执行以下操作刷新sourcekitd缓存：

  1. 按Ctrl+Shift+P调出命令面板，选择Reload Window
  2. 若问题依旧，卸载并重新安装VSCode的Swift插件

• 手动编译排查
  执行swift build命令，若编译成功则为VSCode语言服务缓存问题；若编译失败，根据报错检查是否缺失系统依赖（如CCUDD可能依赖的libcudd-dev，可通过sudo apt install libcudd-dev安装）

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