Creazione di un progetto in JetBrains Rider

1. Introduzione

Nel mondo C# il codice non si tiene mai sparso in giro come nella cartella “Downloads”. È sempre tutto raggruppato in progetti. Un progetto è un contenitore speciale che include file di codice, impostazioni, riferimenti a librerie esterne e altre cose importanti. Quando lanci il programma o lo compili in un eseguibile, è proprio il progetto che si occupa di mettere tutto insieme.

Un progetto sta dentro una Solution, e in una soluzione puoi avere più progetti (tipo il progetto principale dell’app + uno separato per i test).

2. Creazione passo-passo di un nuovo progetto in Rider

Passo 1. Creazione del progetto

Nella schermata iniziale clicca sul grande pulsante blu "New Solution"

Ti si aprirà una finestra per scegliere il template. Per iniziare, creiamo una "Console Application" in C#. Questa opzione è perfetta per fare pratica, perché non devi pensare subito a interfacce grafiche o web server — solo tu, il codice e la console.

A destra devi compilare i dettagli del progetto:

• Solution Name: il nome del tuo “contenitore”. Chiamalo MyConsoleApp.
• Project Name: il nome vero e proprio del progetto. Rider ti propone lo stesso nome, e va benissimo così.
• Location: la posizione sul disco dove vivrà il tuo codice.
• Framework: qui scegli la versione di .NET, lascia pure l’ultima disponibile. Se sul tuo PC manca il .NET SDK giusto, Rider se ne accorge e ti propone di scaricarlo e installarlo — conferma e via.
• Language: C#
• Do not use top-level statements: questa è una cosa importante per noi! Metti la spunta qui.

Quando è tutto pronto, premi il pulsante blu Create.

Dopo che Rider ha creato il progetto, scriveremo il codice usando la struttura classica di un programma C#. Non spaventarti se vedi parole nuove come namespace, class e Main — sono i “mattoncini” standard di ogni programma console.

Notifica di Windows Defender. L’antivirus può rallentare Rider controllando i suoi file. Per velocizzare, l’IDE ti chiederà di aggiungere le sue cartelle alle eccezioni. Accetta pure nella finestra di dialogo.

3. Impariamo a orientarci nella struttura del progetto

Prima di scrivere codice, dai un’occhiata alla parte sinistra dello schermo — è la finestra Solution Explorer. Funziona come un file manager, ma mostra non solo i file, bensì la struttura logica della tua app. All’inizio ci sono pochi elementi, ma è importante capire cosa rappresentano.

• MyConsoleApp (il livello più alto) - questa è la tua Soluzione (Solution), il “contenitore” di cui parlavamo.
• MyConsoleApp (annidato, con l’icona C#) - questo è il tuo Progetto (Project). Qui vivono tutti i file che riguardano il tuo programma.
• Dependencies (Dipendenze) - è come la lista degli ingredienti della tua app. In futuro, quando aggiungerai librerie esterne, le troverai qui.
• Program.cs - il file principale. È un file di testo con codice C#.

Quello che vedi nel Solution Explorer è una rappresentazione logica comoda. Sul disco, nella cartella del progetto, la struttura fisica è un po’ più complicata, ma è utile capirla. Ecco come appare se scegli la scheda Files:

4. Avvio del codice

Avvia il progetto: clicca il pulsante verde ▶️ Run (di solito in alto a sinistra — se non lo trovi, prova il menu Run → Run 'MyConsoleApp').

Se tutto è andato bene, in basso apparirà la scheda Run. Vedrai che il programma è partito, ha stampato del testo e si è chiuso con successo. Process finished with exit code 0 — è il rapporto finale del tuo programma, e significa: “Missione compiuta, nessun errore!”.

Magari hai notato che il codice è diverso da quello che hai visto nelle lezioni e negli esercizi. Il motivo è che nelle lezioni, per semplicità, spesso si usano i cosiddetti Top-level statements — cioè puoi scrivere codice direttamente. Qui invece vediamo la struttura classica e completa di un programma C#, ed è così che sono fatti quasi tutti i programmi veri.

Analizzeremo in dettaglio ognuno di questi “mattoncini” più avanti.

5. Scorciatoie da tastiera Rider

Analisi del codice ed errori in tempo reale.

Rider analizza il tuo codice in tempo reale. Se fai un errore, tipo sbagliare il nome di una variabile, lo sottolinea subito con una riga rossa ondulata e, passando il mouse, ti suggerisce come correggere.

Completamento automatico Windows/Linux: Ctrl+Space | macOS: ⌃Space

Quando inizi a scrivere il nome di una classe o di un metodo, tipo Con..., Rider ti propone le opzioni di completamento, come Console. Così scrivi più veloce e riduci gli errori di battitura.

Azioni contestuali Windows/Linux: Alt+Enter | macOS: ⌥Enter

Questa è una delle funzioni più potenti. Metti il cursore su una parola nel codice e premi questa combinazione. Rider ti suggerisce azioni adatte: dalla semplificazione del codice alla correzione di errori o generazione di costruttori.

Vai alla definizione Windows/Linux: Ctrl+Click o F12 | macOS: ⌘Click o F12

Per andare subito al punto dove è dichiarata una variabile o un metodo, tieni premuto Ctrl (o ⌘ su Mac) e clicca sul nome. Rider ti porta subito alla riga giusta.

Rinomina sicura Windows/Linux: Ctrl+R | macOS: ⌘+R

Se devi rinominare una variabile o un metodo, non farlo a mano. Metti il cursore sul nome, premi la combinazione, e Rider trova tutti gli usi nel progetto e li aggiorna in sicurezza.

Commenta il codice Windows/Linux: Ctrl+/ | macOS: ⌘/

Per “spegnere” temporaneamente una riga o un blocco di codice senza cancellarlo, seleziona la parte che vuoi e premi la combinazione. Premendo di nuovo, togli il commento.

Autoformattazione del codice Windows/Linux: Ctrl+Alt+L | macOS: ⌥⌘L

Se i rientri del codice sono sballati e non si legge bene, basta questa combinazione per sistemare tutto il file secondo gli standard.

Questo è il kit base di strumenti che ti semplifica la vita. La lista completa delle scorciatoie da tastiera la trovi nella documentazione ufficiale. Oppure in Rider, vai su Main Menu | Help | Keyboard Shortcuts PDF

6. Consigli pratici ed errori comuni

Ogni sviluppatore, dallo stagista al senior, si scontra ogni giorno con errori. È normalissimo. L’importante è non averne paura, ma imparare a leggerli e correggerli.

• Il progetto non compila: forse non hai scelto la versione giusta di .NET o hai rinominato per sbaglio file importanti. Controlla in Solution Explorer che la struttura sia quella giusta.
• Non c’è il pulsante di avvio: a volte Rider vuole che tu scelga manualmente il progetto da avviare. Clicca col destro sul progetto e scegli Set as Startup Project.
• Le cartelle bin e obj sono vuote o non ci sono: appaiono solo dopo la prima compilazione riuscita (Run o Build).
• Errore “.NET SDK not found”: di solito significa che .NET non è installato o Rider non lo trova. Vai al link, scarica l’SDK da qui: pagina ufficiale .NET e reinstallalo.