HOWTO · R
So überprüfen Sie die Version von R
Erfahren Sie, wie Sie die R-Version in der R-Konsole, von einem Terminal aus und in einem R-Skript prüfen und verstehen, welche Sitzung oder ausführbare Datei jede Methode meldet.
Auf dieser Seite
Verwenden Sie R.version.string innerhalb von R für eine kompakte Versionsbezeichnung, oder führen Sie R --version in einem Terminal aus, um die ausführbare Datei zu prüfen, die im PATH dieses Terminals gefunden wird. Der Konsolenausdruck beschreibt die R-Sitzung, die Sie geöffnet haben; der Terminalbefehl kann auf eine andere Installation verweisen als die von einer IDE ausgewählte.
Die R-Version in der R-Konsole prüfen
Werten Sie an der R-Eingabeaufforderung R.version.string aus, um eine kurze Bezeichnung auszugeben, die die Release-Nummer und etwaige Build-Details enthält. Dies ist in der Regel der schnellste Weg, die von der aktuellen Konsole oder RStudio-Sitzung verwendete Version zu identifizieren. Der Ausdruck liest einen Wert; er ruft keine Funktion auf.
cat(R.version.string, "\n")
Ausgabe:
R version 4.2.2 Patched (2022-11-10 r83330)
Für strukturierte Details prüfen Sie R.version. Es ist ein eingebautes Objekt, keine Funktion, und seine Felder beschreiben den R-Build, einschließlich der Haupt- und Nebenkomponenten, der Plattform und der Versionszeichenfolge. Verwenden Sie $, um ein bestimmtes Feld zu lesen, etwa R.version$major, oder zeigen Sie das gesamte Objekt an, wenn Sie Unterschiede zwischen Builds diagnostizieren. Die genauen Felder und Werte hängen von der R-Installation ab, vergleichen Sie daher die Versionszeichenfolge und die relevanten Komponenten, statt sich auf ein Beispiel zu verlassen, das an einen anderen Computer gebunden ist.
sessionInfo() beantwortet eine weiter gefasste Frage zur Fehlerbehebung. Es meldet die R-Version zusammen mit dem Betriebssystem, der Gebietsschema-Einstellung und Informationen zu angehängten oder geladenen Paketen. Verwenden Sie es, wenn ein Problem von Paketen oder der Sitzungseinrichtung abhängen kann; verwenden Sie R.version.string, wenn Sie nur die Versionsbezeichnung benötigen.
Die R-Version von der Befehlszeile aus prüfen
Führen Sie in einem Terminal R --version aus. Dadurch wird die aus dem aktuellen PATH aufgelöste ausführbare Datei R aufgefordert, ihre Versionsinformationen auszugeben. Der Befehl ist auf einem Server oder in einer Shell nützlich, in der Sie die grafische Konsole nicht öffnen. Sein Ergebnis identifiziert diese ausführbare Datei, nicht notwendigerweise jede R-Installation auf dem Computer.
Wenn die im Terminal ausgegebene Version von R.version.string in RStudio oder einer anderen IDE abweicht, verwenden die beiden Umgebungen unterschiedliche R-Programme. Prüfen Sie, welche ausführbare Datei das Terminal auflöst und welche Installation die IDE zu verwenden konfiguriert ist. Eine Versionsprüfung kann helfen, die Paketkompatibilität zu diagnostizieren, legt aber für sich genommen nicht fest, welche R-Version ein Projekt erfordert; ziehen Sie die Einrichtungsanweisungen und Paketanforderungen des Projekts zu Rate, bevor Sie Installationen ändern.
Die R-Version in einem R-Skript prüfen
Ein R-Skript kann die Version ausgeben, die es ausführt, und Release-Komponenten mit einem Minimum vergleichen. getRversion() gibt einen Versionswert zurück, der für Vergleiche ausgelegt ist, sodass Versionsbezeichnungen nicht als gewöhnlicher Text behandelt werden. Beispielsweise kann eine Textsortierung Releases wie 4.10 und 4.9 in die falsche Reihenfolge bringen; verwenden Sie stattdessen einen versionsbewussten Vergleich.
cat(R.version.string, "\n")
required_version <- "4.0.0"
current_version <- getRversion()
if (current_version >= required_version) {
cat("The required R version is available.\n")
} else {
cat("This script expects R ", required_version, " or later.\n", sep = "")
}
Ausgabe:
R version 4.2.2 Patched (2022-11-10 r83330)
The required R version is available.
Das erforderliche Release ist ein Beispielwert; ersetzen Sie es durch das Minimum, das Ihr Code oder Projekt unterstützt. Das Skript gibt die aktive R-Version aus und meldet, ob dieses R die Anforderung erfüllt, und überlässt die Entscheidung, wie R installiert oder ausgewählt wird, der Umgebungseinrichtung des Projekts. Fügen Sie für einen reproduzierbaren Fehlerbericht neben der Versionsbezeichnung auch sessionInfo() bei, da Paketversionen und Plattformdetails das Verhalten beeinflussen können.