Komentarze wieloliniowe w języku Java zapisuje się właśnie w taki sposób: /* ... */. Taki zapis pozwala na umieszczenie kilku linii tekstu między znakami otwierającym /* i zamykającym */, które kompilator całkowicie ignoruje podczas tłumaczenia kodu. Z mojego doświadczenia to jest najwygodniejsza forma, kiedy trzeba wyłączyć większy fragment kodu – np. część algorytmu, której chwilowo nie chcemy wykonywać lub większy blok dokumentacji. Bardzo często używa się komentarzy wieloliniowych przy pisaniu tzw. docstringów, choć w Javie do dokumentacji API lepiej stosować komentarze JavaDoc z podwójnym ukośnikiem i gwiazdką (/** ... */), ale zwykłe /* ... */ są super uniwersalne – czy to na zajęciach, czy w dużych projektach zespołowych. Moim zdaniem, jeśli uczysz się Javy, warto pamiętać, żeby nie mieszać komentarzy wieloliniowych z jednoliniowymi (// ...), bo to czasem prowadzi do zamieszania, szczególnie przy większych refaktoryzacjach. Co ciekawe, takie same komentarze znajdziesz też w C czy C++, więc jak ktoś zna te języki, to szybko się odnajdzie. W sumie to prosta sprawa, ale zdziwiłbyś się ile osób próbuje stosować inne formaty, które działają w zupełnie innych technologiach. No i jeszcze taka drobna uwaga z praktyki: nigdy nie wstawiaj komentarza wieloliniowego wewnątrz innego; Java tego nie obsługuje i kompilator się pogubi.
Wielu początkujących programistów myli składnię komentarzy w różnych językach programowania, co jest całkiem naturalne – szczególnie jeśli ktoś ma styczność z wieloma technologiami naraz albo przechodzi z jednego języka na drugi. W przypadku Javy tylko zapis /* ... */ pozwala na tworzenie komentarzy wieloliniowych, czyli takich, które rozciągają się na kilka kolejnych wierszy kodu. Zapis <!-- ... --> jest charakterystyczny dla języków znaczników, takich jak HTML czy XML. Java nie rozpoznaje tego typu komentarza – jeśli spróbujesz go użyć, kompilator po prostu się „zgubi” i potraktuje to jako błąd składni, a nie komentarz. Z kolei // ... // to pomieszanie dwóch różnych rzeczy: w Java używamy podwójnego ukośnika (//) do komentarzy jednoliniowych, czyli takich, które kończą się na końcu danej linii. Powielenie ukośników po obu stronach nie ma żadnego znaczenia dla interpretera Javy i nie działa w praktyce. Natomiast zapis z trzema cudzysłowami """ ... """, choć jest popularny np. w Pythonie do komentowania bloków tekstu lub docstringów, w języku Java nie jest rozpoznawany nawet jako komentarz – kompilator potraktuje taki fragment jako błąd składni lub nieoczekiwany string w kodzie. Niestety, takie błędy wynikają często z przyzwyczajeń wyniesionych z innych języków, co jest typowym problemem przy nauce nowych technologii. Z mojego punktu widzenia warto od początku rozróżniać te różnice, bo potem przychodzi mniej przykrych niespodzianek na etapie kompilowania czy wdrażania aplikacji. Praktyka pokazuje, że nawet doświadczeni programiści czasami odruchowo stosują nieprawidłową notację, szczególnie gdy edytują kod w różnych językach. W Javie zawsze trzymaj się więc zapisu /* ... */ dla komentarzy wieloliniowych i nie próbuj używać formatów z innych ekosystemów – to po prostu tutaj nie zadziała.