Как использовать локальный неопубликованный крейт в Rust?

Решение: используйте атрибут path в Cargo.toml

Вы почти всё сделали правильно. Ошибка возникает из-за того, что Cargo ожидает, что локальный крейт имеет указанную версию в своём Cargo.toml, но при использовании path версия не обязательна для совпадения. Проблема в том, что Cargo пытается разрешить версию, а у локального крейта может быть несовместимая версия или она не указана. Давайте исправим это.

Пошаговая инструкция

1. Убедитесь, что в my_lib/Cargo.toml есть поле version
   Откройте my_lib/Cargo.toml и добавьте версию, например:

[package]
name = "my_lib"
version = "0.1.0"
edition = "2021"

2. Укажите зависимость в основном проекте с помощью path
   В main_project/Cargo.toml напишите:

[dependencies]
my_lib = { path = "../my_lib" }

Обратите внимание: путь указывается относительно файла Cargo.toml основного проекта. Если ваш проект находится в /workspace/main_project, а крейт — в /workspace/my_lib, то путь ../my_lib корректен.

3. Соберите проект
   Выполните cargo build в папке main_project. Cargo автоматически найдёт локальный крейт и соберёт его как часть зависимостей.

Проверка работоспособности

В my_lib/src/lib.rs определите простую функцию:

pub fn greet(name: &str) -> String {
    format!("Hello, {}!", name)
}

В main_project/src/main.rs используйте её:

use my_lib::greet;

fn main() {
    println!("{}", greet("Rust developer"));
}

После cargo run вы увидите Hello, Rust developer!.

Важные замечания

• Версия не обязана совпадать — при использовании path Cargo игнорирует версию в секции [dependencies]. Убедитесь только, что версия указана в самом крейте.
• Обновление кода крейта — если вы измените код в my_lib, просто пересоберите основной проект командой cargo build. Cargo сам перекомпилирует зависимость. Никаких дополнительных действий не требуется.
• Рабочее пространство (workspace) — если вы планируете разрабатывать несколько крейтов вместе, рассмотрите использование Cargo Workspaces. Это упростит управление зависимостями и сборкой.
• Отладка ошибок — если Cargo всё равно ругается, проверьте:
  • Правильность пути (используйте абсолютные пути для теста: path = "/home/user/workspace/my_lib").
  • Наличие Cargo.toml в папке крейта.
  • Отсутствие циклических зависимостей.

Таким образом, локальный неопубликованный крейт подключается просто и гибко. Вы можете свободно редактировать его код и сразу видеть изменения в основном проекте. Это идеально для разработки внутренних библиотек до их публикации.

[workspace]
members = [
    "main_project",
    "my_lib",
]

[dependencies]
my_lib = { path = "../my_lib" }