가져오는 동안 경고가 발생했습니다.

이 경고 범주의 철자는 [import] 입니다.

모듈 가져오기에 실패했습니다.

무슨 일이 일어났나요?

가져오기 문을 통해 가져온 모듈을 찾을 수 없습니다.

예를 들어 다음과 같은 이유로 발생할 수 있습니다.

왜 이런 문제가 발생하나요?

애플리케이션이 의존하는 모듈을 찾을 수 없기 때문에 실행할 수 없습니다.

예시

가져오기 문에 오타가 있습니다.

import QtQuicky // not ok: typo in module name

Item {
}

이 경고를 수정하려면 오타를 수정하세요:

import QtQuick // ok: no typo in module name

Item {
}

빌드되지 않은 사용자 정의 모듈

다음과 같은 일부 도구 QML Language Server 또는 qmllint와 같은 일부 도구는 사용자 정의 모듈이 빌드되지 않은 경우 이를 찾을 수 없습니다. 프로젝트에서 가져오려는 QML 모듈을 정의한 경우, 해당 모듈을 빌드할 때까지 QML 도구가 해당 모듈을 찾지 못합니다.

참고: 모듈을 빌드해도 도움이 되지 않는 경우 QML Language Server의 지침을 따르고 QML Language Server 설정 지침에 따라 올바른 빌드 폴더를 QML Language Server 으로 전달했는지 확인하세요.

잘못된 가져오기 경로

가져오기 경로에 대한 자세한 내용은 QML 가져오기 경로 문서와 디버깅 모듈 가져오기 문서를 참조하세요.

QT_QML_GENERATE_QMLLS_INI가 서트되지 않음

해당 CMake 변수를 설정하는 방법에 대한 자세한 내용은 QT_QML_GENERATE_QMLLS_INI 설명서를 참조하세요.

누락된 모듈

이전 섹션에서 가져온 모듈을 찾는 데 도움이 되지 않았다면 모듈이 누락되었을 수 있습니다. 이는 종속성이 누락되었기 때문일 수 있습니다. 외부 라이브러리를 사용하는 경우 해당 라이브러리가 실제로 설치되어 있고 해당 모듈이 가져오기 경로에 있는지 확인하세요.

컴포넌트를 찾을 수 없습니다.

무슨 일이 일어났나요?

일부 구성 요소를 찾을 수 없습니다.

왜 이런 문제가 발생하나요?

찾을 수 없는 컴포넌트를 인스턴스화할 수 없기 때문에 애플리케이션을 실행할 수 없습니다.

예시

컴포넌트 이름에 오타가 있습니다.

import QtQuick

Item {
    Itemy {} // not ok: typo in name
}

이 경고를 수정하려면 오타를 수정하세요:

import QtQuick

Item {
    Item {} // ok: no typo in name
}

누락된 가져오기 문

Item { // not ok: must be imported from QtQuick first
}

이 경고를 수정하려면 누락된 모듈 가져오기를 추가하세요:

import QtQuick

Item { // ok: was imported from QtQuick
}

가져오기 한정자는 대문자로 시작해야 합니다.

무슨 일이 있었나요?

가져온 일부 모듈에 잘못된 한정자가 있습니다.

왜 이런 문제가 발생하나요?

이 잘못된 한정자를 사용하여 가져온 모듈은 사용할 수 없습니다.

예시

import QtQuick as qq

qq.Item {
}

이 경고를 수정하려면 가져오기 한정자를 대문자로 시작하도록 하세요:

import QtQuick as Qq

Qq.Item {
}

알 수 없는 가져오기 구문

무슨 일인가요?

가져오기 문에서 잘못된 가져오기 구문을 사용하고 있습니다.

왜 이런 문제가 발생하나요?

의존하는 모듈을 가져올 수 없기 때문에 애플리케이션을 실행할 수 없습니다.

예시

import "¯\(ツ)/¯:/path/to/Module"
import QtQuick

Item {
}

이 경고를 해결하려면 허용된 체계가 있는 URL을 사용하세요:

import "qrc:/path/to/Module"
import QtQuick

Item {
}

참고: 이 예에서는 URL handlers 을 사용하지 않는다고 가정합니다.

가져오기 문도참조하세요 .

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.