Ошибка Rust E0405: cannot find trait in this scope (трейт не найден)

E0405 значит: ты назвал трейт, которого Rust не видит из этого места. Классический случай: ты пишешь impl Display for Point, чтобы структуру можно было выводить, но не импортировал Display. Опечатка в имени трейта или трейт из другого модуля дают ту же ошибку. Это одна из самых простых ошибок, потому что rustc обычно сам печатает нужную строку use. В отличие от E0412 («cannot find type»), которая в Rust 1.93 превратилась в E0425, этот код не менялся: rustc 1.97 по-прежнему выводит E0405 для трейтов. Страница входит в раздел Ошибки компилятора Rust с объяснениями.

Сообщение об ошибке

error[E0405]: cannot find trait `Display` in this scope
 --> src/main.rs:6:6
  |
6 | impl Display for Point { // ❌ `Display` was never imported
  |      ^^^^^^^ not found in this scope
  |
help: consider importing this trait
  |
1 + use std::fmt::Display;
  |

По-русски: «не найден трейт Display в этой области видимости». В help rustc предлагает импортировать этот трейт.

Вот программа, которая её вызывает (комментарий // ❌ оставлен на английском, потому что rustc цитирует эту строку; он значит «Display так и не импортировали»):

struct Point {
    x: i32,
    y: i32,
}

impl Display for Point { // ❌ `Display` was never imported
    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
        write!(f, "({}, {})", self.x, self.y)
    }
}

fn main() {
    let p = Point { x: 3, y: 4 };
    println!("{}", p);
}

Что это значит

^^^^^^^ указывает на Display в строке 6 с пометкой «not found in this scope» («не найдено в этой области видимости»). Rust просмотрел все трейты, видимые оттуда: определённые в этом модуле, принесённые твоими строками use и небольшой набор из прелюдии (prelude). Ни один из них не называется Display.

help: подсказывает, где он: use std::fmt::Display;. 1 + значит «добавь это новой строкой 1», то есть в начало файла.

Почему Display не хватает, если println! пользуется им постоянно? Прелюдия — список имён, который каждый файл на Rust получает бесплатно, — включает Clone, Iterator, From, Default и другие повседневные трейты, но не Display, Error, Hash или Write. Они живут в своих модулях (std::fmt, std::error, std::hash, std::io), и ты импортируешь их, когда реализуешь.

Это как рецепт, где написано «возьми сковородку Display». Повар знает сковородки на плите, но эта лежит в шкафу, а рецепт не сказал, в каком.

Почему Rust так делает

Rust никогда не ищет имя по всей стандартной библиотеке или по всему проекту. Он смотрит только на то, что в области видимости: твои элементы, твои строки use и прелюдию. Так имена остаются предсказуемыми. Только в std есть несколько трейтов с именами Write и Error, а крейт, который ты добавишь позже, может принести ещё. Если бы Rust выбирал сам, новая зависимость могла бы тихо изменить смысл твоего кода.

Поэтому ты один раз, в начале файла, говоришь, какой трейт имеешь в виду. Строка help делает поиск за тебя и предлагает найденный трейт. Как работает use, рассказано в уроке Модули, а про Display — в уроке Распространённые трейты.

Как исправить

Исправление 1: Добавь строку use, которую предлагает rustc

Выбирай этот вариант, когда в help написано consider importing this trait — то есть почти всегда. Скопируй строку в начало файла:

use std::fmt::Display;

struct Point {
    x: i32,
    y: i32,
}

impl Display for Point {
    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
        write!(f, "({}, {})", self.x, self.y)
    }
}

fn main() {
    let p = Point { x: 3, y: 4 };
    println!("{}", p);
    println!("Феррис в точке {}", Point { x: -1, y: 7 });
}

Вывод:

(3, 4)
Феррис в точке (-1, 7)

▶ Попробуй сам

Если rustc предлагает несколько импортов, прочитай их, прежде чем выбирать. Это разные трейты, у которых просто совпадает имя, например std::fmt::Write и std::io::Write.

Исправление 2: Импортируй модуль и пиши fmt::Display

Выбирай этот вариант, когда реализуешь Display: тебе всё равно нужны Formatter и Result из того же модуля. Импортируй std::fmt один раз и пиши fmt:: перед всеми тремя. Именно такой стиль чаще всего встречается в настоящем коде на Rust:

use std::fmt;

struct Point {
    x: i32,
    y: i32,
}

impl fmt::Display for Point {
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        write!(f, "({}, {})", self.x, self.y)
    }
}

fn main() {
    let p = Point { x: 3, y: 4 };
    let label = p.to_string();
    println!("{} — символов: {}", label, label.len());
}

Вывод:

(3, 4) — символов: 6

▶ Попробуй сам

Реализация Display заодно бесплатно даёт .to_string(). Можно вообще обойтись без use и написать impl std::fmt::Display for Point — для разового случая это нормально.

Исправление 3: Исправь написание имени трейта

Выбирай этот вариант, когда rustc пишет a trait with a similar name exists («есть трейт с похожим именем»). Имена трейтов чувствительны к регистру, поэтому shape, Shap и Shape — три разных имени:

error[E0405]: cannot find trait `Shap` in this scope
 --> src/main.rs:9:6
  |
1 | trait Shape {
  | ----------- similarly named trait `Shape` defined here
...
9 | impl Shap for Square { // ❌ typo: Shap
  |      ^^^^
  |
help: a trait with a similar name exists
  |
9 | impl Shape for Square { // ❌ typo: Shap
  |          +

Программа с ошибкой (комментарий значит «опечатка: Shap»):

trait Shape {
    fn area(&self) -> f64;
}

struct Square {
    side: f64,
}

impl Shap for Square { // ❌ typo: Shap
    fn area(&self) -> f64 {
        self.side * self.side
    }
}

fn main() {
    let s = Square { side: 3.0 };
    println!("{}", s.area());
}

+ под строкой 9 показывает пропущенную букву. Добавь её:

trait Shape {
    fn area(&self) -> f64;
}

struct Square {
    side: f64,
}

impl Shape for Square {
    fn area(&self) -> f64 {
        self.side * self.side
    }
}

fn main() {
    let s = Square { side: 3.0 };
    println!("{}", s.area());
}

Вывод:

9

▶ Попробуй сам

Если похожего имени нет и импорт не предлагается, значит, такого трейта ещё не существует. Сначала определи его через trait Shape { ... }. Подробнее — в уроке Трейты.

Исправление 4: Импортируй свой трейт из его модуля

Выбирай этот вариант, когда трейт твой, но живёт в другом модуле. У каждого модуля своя область видимости, поэтому трейт из mod shapes не виден в начале main.rs, пока ты его не импортируешь:

error[E0405]: cannot find trait `Shape` in this scope
  --> src/main.rs:11:6
   |
11 | impl Shape for Square { // ❌ `Shape` lives in `mod shapes`
   |      ^^^^^ not found in this scope
   |
help: consider importing this trait
   |
 1 + use crate::shapes::Shape;
   |

Программа с ошибкой (комментарий значит «Shape живёт в mod shapes»):

mod shapes {
    pub trait Shape {
        fn area(&self) -> f64;
    }
}

struct Square {
    side: f64,
}

impl Shape for Square { // ❌ `Shape` lives in `mod shapes`
    fn area(&self) -> f64 {
        self.side * self.side
    }
}

fn main() {
    println!("{}", Square { side: 2.0 }.area());
}

Добавь строку use и проверь, что трейт объявлен как pub. Без pub сам импорт упадёт с ошибкой E0603, «trait is private» («трейт приватный»):

mod shapes {
    pub trait Shape {
        fn area(&self) -> f64;
    }
}

use crate::shapes::Shape;

struct Square {
    side: f64,
}

impl Shape for Square {
    fn area(&self) -> f64 {
        self.side * self.side
    }
}

fn main() {
    println!("{}", Square { side: 2.0 }.area());
}

Вывод:

4

▶ Попробуй сам

То же самое с трейтами из крейтов: для impl Serialize for User сначала нужен use serde::Serialize;. Подробнее — в уроке Модули.

Где это обычно встречается

Box<dyn Error> в main или во вспомогательной функции. fn run() -> Result<(), Box<dyn Error>> без импорта даёт cannot find trait `Error` in this scope с подсказкой help: consider importing this trait и строкой use std::error::Error;. Исправление: добавь эту строку или пиши Box<dyn std::error::Error>. Подробнее — в уроке Свои типы ошибок.

Ограничения трейтов у обобщений. fn print_all<T: Display>(items: &[T]) даёт ту же E0405 для Display и указывает на ограничение. Исправление: use std::fmt::Display;. Подробнее — в уроке Обобщения.

Debug даёт другой код. impl Debug for Point или T: Debug без импорта — это не E0405, а E0404: expected trait, found derive macro `Debug` («ожидался трейт, найден derive-макрос Debug»). В прелюдии есть макрос #[derive(Debug)], но нет трейта Debug. Исправление: use std::fmt::Debug; (rustc его предлагает) или просто #[derive(Debug)], если особый формат тебе не нужен.

Связанные ошибки

• E0425: в области видимости не найдено значение, функция или (начиная с Rust 1.93) тип.
• E0412: старый код для «cannot find type», теперь сообщается как E0425.
• E0433: не найдена первая часть пути, например fmt::Display без use std::fmt;.
• E0599: метод не найден — часто потому, что трейт, который его даёт, не импортирован.
• E0277: трейт найден, но твой тип его не реализует.
• E0404: имя существует, но это не трейт (как макрос Debug), см. выше.
• Все ошибки компилятора: полный список страниц об ошибках.

Проверь себя

Проверь себя

1. Ты пишешь impl Display for Invoice и получаешь E0405. Чего не хватает?

#[derive(Display)] у структуры Строки use std::fmt::Display; (или записи fmt::Display) pub перед impl

2. Какой из этих трейтов можно использовать без строки use?

Clone Display std::error::Error

3. Твой трейт Shape определён в mod shapes, а impl Shape for Square — в main.rs. Что нужно?

Ничего, трейты глобальные Переименовать трейт в shapes pub trait Shape и use crate::shapes::Shape;

Результат: 0 / 3

Что почитать

• E0405 — Rust error codes index (на английском): официальное объяснение с двумя исправлениями — импортировать трейт или определить его.
• Реализация типажа у типа — книга «Язык программирования Rust» (перевод на русский): как работает impl Trait for Type и почему трейт должен быть в области видимости.
• std::fmt::Display — документация стандартной библиотеки (на английском): трейт с этой страницы и полный пример impl fmt::Display.
• Display — Rust на примерах (перевод на русский): реализация Display шаг за шагом, с use std::fmt;.
• std::prelude — документация стандартной библиотеки (на английском): список трейтов и типов, которыми можно пользоваться без импорта.