Guida di stile F#

Gli articoli seguenti descrivono le linee guida per la formattazione del codice F# e linee guida di argomento per le funzionalità del linguaggio e il modo in cui devono essere usati.

Queste linee guida sono state formulate in base all'uso di F# in codebase di grandi dimensioni con un gruppo diversificato di programmatori. Queste indicazioni in genere portano a un uso corretto di F# e riducono al minimo le frustrazioni quando i requisiti per i programmi cambiano nel tempo.

Cinque principi di codice F# valido

Tenere presenti i principi seguenti ogni volta che si scrive codice F#, in particolare nei sistemi che cambieranno nel tempo. Ogni indicazione dei successivi articoli deriva da questi cinque punti.

1. Il codice F# valido è conciso, espressivo e componibile

   F# offre molte funzionalità che consentono di esprimere azioni in un minor numero di righe di codice e riutilizzare funzionalità generiche. La libreria principale F# contiene anche molti tipi e funzioni utili per lavorare con raccolte comuni di dati. La composizione delle tue funzioni e quelle nella libreria principale F# (o altre librerie) fa parte della programmazione idiomatica di routine in F#. Come regola generale, se è possibile esprimere una soluzione a un problema in meno righe di codice, altri sviluppatori (o il tuo futuro sé) apprezzeranno. Si consiglia vivamente di utilizzare una libreria come FSharp.Core, le vaste librerie .NET su cui si basa F#, o un pacchetto di terze parti su NuGet quando è necessario eseguire un compito complesso.

2. Il codice F# valido è interoperabile

   L'interoperabilità può assumere più forme, tra cui l'utilizzo di codice in linguaggi diversi. I confini del codice con cui interagiscono altri chiamanti sono elementi cruciali da gestire correttamente, anche se i chiamanti si trovano anche in F#. Quando si scrive F#, è sempre consigliabile pensare a come un altro codice chiamerà il codice che si sta scrivendo, incluso se lo fanno da un altro linguaggio come C#. Le linee guida per la progettazione dei componenti F# descrivono in dettaglio l'interoperabilità.

3. Un buon codice F# usa la programmazione degli oggetti, non l'orientamento degli oggetti

   F# offre il supporto completo per la programmazione con oggetti in .NET, tra cui classi, interfacce, modificatori di accesso, classi astratte e così via. Per codice funzionale più complesso, come le funzioni che devono essere consapevoli del contesto in cui operano, gli oggetti possono facilmente incapsulare le informazioni contestuali in modi che le funzioni non possono. Funzionalità come i parametri facoltativi e l'uso attento dell'overload possono rendere più semplice l'utilizzo di questa funzionalità per i chiamanti.

4. Il buon codice F# funziona bene senza esporre la mutazione

   Non è un segreto che scrivere codice ad alte prestazioni, è necessario usare la mutazione. È come funzionano i computer, dopo tutto. Questo codice è spesso soggetto a errori e difficile da risolvere. Evitare di esporre la mutazione ai chiamanti. Creare invece un'interfaccia funzionale che nasconde un'implementazione basata su mutazione quando le prestazioni sono critiche.

5. Il codice F# valido è utilizzabile

   Gli strumenti sono preziosi per lavorare in codebase di grandi dimensioni ed è possibile scrivere codice F# in modo che possa essere usato in modo più efficace con gli strumenti del linguaggio F#. Un esempio è assicurarsi di non esagerare con uno stile di programmazione senza punti, in modo che i valori intermedi possano essere controllati con un debugger. Un altro esempio consiste nell'usare commenti della documentazione XML che descrivono costrutti in modo che i suggerimenti negli editor possano visualizzare tali commenti nella posizione di chiamata. Pensa sempre al modo in cui il codice verrà letto, spostato, sottoposto a debug e modificato da altri programmatori con i relativi strumenti.

Passaggi successivi

Le linee guida per la formattazione del codice F# forniscono indicazioni su come formattare il codice in modo che sia facile da leggere.

Le convenzioni di codifica F# forniscono indicazioni per i linguaggi di programmazione F# che consentiranno la manutenzione a lungo termine di codebase F# più grandi.

Le linee guida per la progettazione dei componenti F# forniscono indicazioni per la creazione di componenti F#, ad esempio librerie.