Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Crystal
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Crystal ist eine übersetzte Programmiersprache mit einer Schreibweise, die stark an Ruby erinnert. Anders als Ruby prüft Crystal alle Typen schon beim Übersetzen, erkennt sie aber fast immer selbst, sodass man sie selten hinschreiben muss. Heraus kommen schnelle Programme in Maschinencode, gebaut mit LLVM.
Vorbemerkungen
- Installation über apt: Ubuntu 26.04 liefert Crystal 1.18. Mit den empfohlenen Entwicklerbibliotheken, die Teile der Standardbibliothek brauchen (z. B. für XML, YAML oder verschlüsselte Verbindungen), sind das 14 Pakete.
- Ohne shards: Der Paketmanager
shards, mit dem man fremde Bibliotheken einbindet, ist nicht in den Ubuntu-Paketquellen. Diese Anleitung kommt ohne ihn aus, weil sie nur die Standardbibliothek verwendet. Sie enthält schon vieles, etwa JSON, HTTP und Tests. - Version: Getestet mit Crystal 1.18.2 aus Ubuntu 26.04.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Crystal installieren
sudo apt install crystal
Prüfen: Die erste Zeile lautet Crystal 1.18.2 (2025-11-25).
crystal --version
Ein einzelnes Programm
3. Übungsordner anlegen
mkdir ~/crystal-uebung
4. In den Ordner wechseln
cd ~/crystal-uebung
5. Quelltext anlegen
nano lager.cr
Füge diesen Inhalt ein (Strg+Umschalt+V):
record Fahrrad, modell : String, preis : Int32, anzahl : Int32 do
def status
anzahl > 0 ? "#{anzahl} auf Lager" : "ausverkauft"
end
end
bestand = [
Fahrrad.new("Citybike", 699, 4),
Fahrrad.new("Trekkingrad", 899, 0),
Fahrrad.new("Lastenrad", 3490, 1),
]
bestand.each_with_index(1) do |rad, nummer|
puts "#{nummer}. #{rad.modell.ljust(12)} #{rad.preis.to_s.rjust(5)} Euro, #{rad.status}"
end
lieferbar = bestand.select { |rad| rad.anzahl > 0 }.map(&.modell)
puts "Sofort lieferbar: #{lieferbar.join(", ")}"
puts "Lagerwert: #{bestand.sum { |rad| rad.preis * rad.anzahl }} Euro"
record– legt kurz einen unveränderlichen Datentyp mit festen Feldern an.StringundInt32sind die Typen der Felder. Imdo-Block stehen eigene Methoden.def status– eine Methode ohne Klammern. Der letzte Ausdruck ist das Ergebnis."#{…}"– setzt Werte in einen Text ein.ljustundrjustfüllen auf eine feste Breite auf.each_with_index(1)– geht die Liste durch und zählt dabei ab 1.select,map,sum– filtern, umformen, zusammenzählen.&.modellist die Kurzform für{ |rad| rad.modell }.- Typen erkennen –
bestandist ohne Angabe einArray(Fahrrad). Crystal weiß das und prüft jeden Zugriff.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
6. Programm übersetzen und starten
crystal run übersetzt und startet in einem Schritt.
crystal run lager.cr
Prüfen: Die Ausgabe lautet:
1. Citybike 699 Euro, 4 auf Lager
2. Trekkingrad 899 Euro, ausverkauft
3. Lastenrad 3490 Euro, 1 auf Lager
Sofort lieferbar: Citybike, Lastenrad
Lagerwert: 6286 Euro
7. Eigenständiges Programm erzeugen
--release schaltet die Optimierungen ein. Das Übersetzen dauert dadurch etwas länger.
crystal build --release lager.cr
Prüfen: Im Ordner liegt das Programm lager, knapp 1 MB groß. Es liefert dieselbe Ausgabe wie in Schritt 6.
./lager
Ein Projekt mit Tests
8. In das Home-Verzeichnis wechseln
cd ~
9. Projekt anlegen
crystal init app legt den Ordner umsatz mit der Projektbeschreibung shard.yml, dem Quelltext in src und Tests in spec an. Außerdem richtet es ein Git-Repository ein und übernimmt Name und E-Mail aus den Git-Einstellungen.
crystal init app umsatz
Prüfen: Die Meldungen nennen unter anderem create … src/umsatz.cr und create … spec/umsatz_spec.cr.
10. In den Projektordner wechseln
cd ~/umsatz
11. Modul schreiben
Das Modul enthält die eigentliche Rechnung. Das Programm, das Dateien liest, kommt in eine eigene Datei. So können die Tests das Modul laden, ohne das Programm zu starten.
nano src/umsatz.cr
Lösche den bisherigen Inhalt (mehrmals Strg+K) und füge diesen ein:
require "json"
module Umsatz
VERSION = "0.1.0"
# Zählt den Umsatz je Modell zusammen.
# Jede Zeile hat die Form "Modell;Anzahl;Preis".
def self.summen(zeilen : Array(String)) : Hash(String, Int32)
ergebnis = Hash(String, Int32).new(0)
zeilen.each do |zeile|
modell, anzahl, preis = zeile.split(';')
ergebnis[modell] += anzahl.to_i * preis.to_i
end
ergebnis
end
end
def self.summen– eine Methode des Moduls, aufrufbar alsUmsatz.summen.- Typangaben –
zeilen : Array(String)und: Hash(String, Int32)legen Parameter und Ergebnis fest. Hier sind sie zur Dokumentation hingeschrieben, Crystal prüft sie beim Übersetzen. Hash(String, Int32).new(0)– ein Wörterbuch, das für fehlende Schlüssel 0 liefert. Deshalb funktioniert+=sofort.modell, anzahl, preis = …– verteilt die drei Teile der Zeile auf drei Variablen.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
12. Programm schreiben
nano src/cli.cr
Die Datei ist neu. Füge diesen Inhalt ein:
require "./umsatz"
if ARGV.size != 1
STDERR.puts "Aufruf: umsatz DATEI"
exit 1
end
tabelle = Umsatz.summen(File.read_lines(ARGV[0]))
tabelle.to_a.sort_by { |_, betrag| -betrag }.each do |modell, betrag|
puts "#{modell.ljust(12)} #{betrag.to_s.rjust(5)} Euro"
end
File.write("umsatz.json", tabelle.to_json)
puts "Gespeichert: umsatz.json"
ARGV– die Argumente beim Aufruf.exit 1beendet mit dem Rückgabewert 1.File.read_lines– liest eine Datei als Liste von Zeilen.sort_by { |_, betrag| -betrag }– sortiert nach dem Umsatz, das Minus kehrt die Reihenfolge um.to_json– kommt ausrequire "json"im Modul und schreibt das Wörterbuch als JSON.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
13. Test schreiben
nano spec/umsatz_spec.cr
Lösche den bisherigen Inhalt und füge diesen ein:
require "./spec_helper"
describe Umsatz do
it "zählt den Umsatz je Modell zusammen" do
summen = Umsatz.summen(["A;2;10", "B;1;50", "A;1;10"])
summen["A"].should eq(30)
summen["B"].should eq(50)
summen.size.should eq(2)
end
end
describe fasst Tests zusammen, it beschreibt einen Test, should eq prüft einen Wert. Die Datei spec_helper.cr aus der Vorlage lädt das Modul.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
14. Tests ausführen
crystal spec
Prüfen: Die letzte Zeile lautet 1 examples, 0 failures, 0 errors, 0 pending.
15. Datei mit Verkäufen anlegen
nano verkauf.csv
Füge diesen Inhalt ein:
Citybike;2;699
Lastenrad;1;3490
Citybike;3;699
Trekkingrad;1;899
Citybike;1;649
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
16. Programm bauen
-o umsatz legt den Namen des Programms fest.
crystal build --release src/cli.cr -o umsatz
17. Programm starten
./umsatz verkauf.csv
Prüfen: Die Ausgabe lautet:
Citybike 4144 Euro
Lastenrad 3490 Euro
Trekkingrad 899 Euro
Gespeichert: umsatz.json
Die Datei umsatz.json enthält {"Citybike":4144,"Lastenrad":3490,"Trekkingrad":899}.
18. Typprüfung ausprobieren (optional)
Ändere in src/cli.cr den Aufruf Umsatz.summen(File.read_lines(ARGV[0])) in Umsatz.summen(File.read(ARGV[0])). File.read liefert einen einzigen Text statt einer Liste von Zeilen. Übersetze dann neu wie in Schritt 16.
Prüfen: Crystal bricht ab mit Error: expected argument #1 to 'Umsatz.summen' to be Array(String), not String. Der Fehler fällt also schon beim Übersetzen auf, nicht erst, wenn das Programm läuft. Mache die Änderung danach wieder rückgängig.
Wie geht es weiter?
- Code formatieren:
crystal tool formatbringt alle Dateien in die übliche Form,crystal tool format --checkprüft nur. - Webserver: Die Standardbibliothek enthält
HTTP::Server. Ein kleiner Webdienst braucht damit keine fremden Bibliotheken. - Fremde Bibliotheken: Dafür braucht man
shards. Es ist nicht bei Ubuntu enthalten, lässt sich aber aus dem Quelltext unter https://github.com/crystal-lang/shards bauen. Bibliotheken trägt man dann inshard.ymlunterdependenciesein. - Dokumentation: Sprachbeschreibung und Referenz unter https://crystal-lang.org/reference/, die Standardbibliothek unter https://crystal-lang.org/api/.
Deinstallieren
1. Übungsordner und Projekt entfernen
rm -rf ~/crystal-uebung ~/umsatz
2. Zwischenspeicher entfernen
Crystal legt übersetzte Zwischenstände in ~/.cache/crystal ab.
rm -rf ~/.cache/crystal
3. Crystal entfernen
sudo apt purge crystal
4. Nicht mehr benötigte Abhängigkeiten entfernen
Entfernt die Pakete, die nur für Crystal mitinstalliert wurden, z. B. LLVM 19 und die Entwicklerbibliotheken. apt zeigt vorher die Liste an und fragt nach. Stehen dort Pakete, die du noch brauchst, mit n abbrechen.
sudo apt autoremove --purge
Prüfen: Der Befehl crystal wird nicht mehr gefunden.
crystal --version
Quellen und Lizenz
- Offizielle Dokumentation: https://crystal-lang.org/reference/
- Lizenz: Crystal steht unter der Apache-2.0.
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Open Knowledge (Freies Wissen): Alle Texte stehen unter der freien Lizenz Creative Commons Namensnennung – Weitergabe unter gleichen Bedingungen 4.0 International (CC BY-SA 4.0) und können frei gelesen, geteilt und weiterverarbeitet werden.