SeitenMögliche Fehler · 29 / 29
Mögliche Fehler und Lösungen
Häufige Fehler, auf die Sie in der QuantCraft-IDE stoßen können, und wie Sie sie beheben. Diese Seite wächst, sobald weitere Probleme dokumentiert werden. Zur Paketinstallation allgemein siehe Abhängigkeiten.
Fehlerindex
- Paketinstallation: „a file it ships is in use“
- Paketinstallation: „pip metadata is missing“ / „broken install“
- Backtest: „User script must define callable: …“
- Backtest: „No bars in the selected date range after warmup filter …“
- Backtest: „A screener symbol source needs an explicit start and end date …“
- Debug Test: „Debug test doesn't support a Screener symbol source …“
Paketinstallation: „a file it ships is in use“
Was Sie sehen
Die Installation eines Pakets über IDE Packages schlägt fehl mit:
Package install failed (polars): Could not install 'polars' — a file it ships is in use
(a compiled extension like this is loaded by the editor's background workers, so pip
can't replace it). Quit QuantCraft to release the file, reopen it, and install again.
Pinning an exact version that is already installed avoids the overwrite.Dahinter ist pip unter Windows auf [WinError 5] Access is denied (bzw. unter macOS / Linux auf [Errno 13] Permission denied) bei einer kompilierten Erweiterung gestoßen — einer .pyd-, .so- oder .dll-Datei wie _polars_runtime.pyd in der Python-Umgebung der IDE.
Warum das passiert
Manche Pakete (polars, numpy, pyarrow und andere native Bibliotheken) liefern eine kompilierte Erweiterung mit, die beim Import des Pakets in den Speicher geladen wird. Die Hintergrundprozesse der IDE importieren Ihre installierten Pakete, um Autovervollständigung und Analyse zu ermöglichen, und laden dabei diese Datei. Eine aktuell geladene Datei lässt sich nicht überschreiben; versucht pip also, sie bei einer Installation oder einem Upgrade zu ersetzen, blockiert das Betriebssystem dies.
Deshalb tritt es beim Installieren der neuesten Version auf (pip muss die geladene Datei überschreiben), nicht aber beim Fixieren einer bereits installierten Version (pip sieht nichts zu ändern und überspringt die Datei vollständig).
So beheben Sie es
- Beenden Sie QuantCraft vollständig — dadurch enden die Python-Hintergrundprozesse, die die Datei offen halten.
- Öffnen Sie QuantCraft erneut.
- Installieren Sie das Paket erneut, idealerweise bevor Sie ein Skript öffnen oder ausführen, das es importiert.
Tipps:
- Ist das Paket bereits installiert und funktioniert, müssen Sie es oft gar nicht neu installieren.
- Das Fixieren einer exakten, bereits installierten Version (z. B.
polars==1.41.2) vermeidet das Überschreiben und gelingt ohne Neustart.
Paketinstallation: „pip metadata is missing“ / „broken install“
Was Sie sehen
Could not install 'somepkg' (pip metadata is missing). Try installing again to force a
clean copy, or quit QuantCraft, delete the ide-venv folder, and restart the app.oder Could not install 'somepkg' (broken install).
Warum das passiert
Eine frühere Installation oder Deinstallation wurde unterbrochen und hat das Paket halb installiert hinterlassen, sodass pip den Eintrag, welche Dateien dem Paket gehören, nicht findet.
So beheben Sie es
- Installieren Sie das Paket erneut über IDE Packages — das erzwingt in der Regel eine saubere Kopie.
- Schlägt das weiterhin fehl, beenden Sie QuantCraft, löschen den in der Meldung genannten Ordner
ide-venvund starten neu. Die App erstellt die Umgebung neu; installieren Sie danach Ihre zusätzlichen Pakete erneut.
Backtest: „User script must define callable: …“
In der Strategiedatei fehlt einer der erforderlichen Callbacks — on_init, on_bar, on_tick oder on_finish — oder er ist keine Funktion. Die Schaltfläche Test prüft nur on_init / on_bar / on_finish, daher ist ein fehlender on_tick die übliche Ursache. Fügen Sie dies hinzu, falls Sie ihn nicht benötigen:
def on_tick(bar_index, tick_in_bar, price, bar, symbol=None):
passSiehe Strategie-Lebenszyklus.
Backtest: „No bars in the selected date range after warmup filter …“
Ihre Start-/Enddaten enthalten keine Kerzen für das Taktsymbol — zum Beispiel ein Zeitraum nur über ein Wochenende, Daten vor Handelsbeginn des Symbols oder ein Zeitraum jenseits der verfügbaren Daten. Erweitern Sie die Daten oder prüfen Sie das Symbol. Ein QuantCraft-(B2-)Feed meldet stattdessen möglicherweise No AAPL bars (d) between … Available range is … to …, was den gültigen Zeitraum nennt. Siehe OHLCV- und Balkendaten.
Backtest: „A screener symbol source needs an explicit start and end date …“
Ein Backtest, dessen Symbol source Screener ist, ermittelt seinen Rebalancing-Zeitplan aus dem Zeitraum, bevor Balken geladen werden; daher sind beide Daten erforderlich. Legen Sie Start und End auf dem Tab Simulation fest. Siehe Screener.
Debug Test: „Debug test doesn't support a Screener symbol source …“
Debug Test führt eine feste Liste von Symbolen aus. Stellen Sie Symbol source auf Selected symbols, wählen Sie ein oder zwei der von Ihrem Screen zurückgegebenen Ticker und debuggen Sie damit. Siehe Debugging.