Spiegazione della somiglianza del coseno: Formula, esempio pratico e codice Python
La somiglianza del coseno misura quanto due vettori puntano nella stessa direzione, da -1 (opposto) a 1 (direzione identica), ignorando la loro lunghezza. Impara la formula, lavora un esempio a mano, eseguilo in Python e NumPy e scopri perché la ricerca AI e RAG dipendono da essa.
- Somiglianza del coseno = prodotto scalare ÷ (lunghezza di A × lunghezza di B). Confronta la direzione, non le dimensioni.
- Per [3, 4] e [6, 8] è esattamente 1.0, anche se un vettore è lungo il doppio; i vettori perpendicolari danno 0 e quelli opposti danno -1.
- Nel nostro test sul conteggio delle parole, il coseno ha classificato un documento lungo e ripetitivo al secondo posto, mentre la distanza euclidea lo ha classificato all’ultimo posto.
- Con i vettori normalizzati alla lunghezza 1, la somiglianza del coseno equivale a un semplice prodotto scalare, motivo per cui i database vettoriali spesso si normalizzano prima.
Ogni volta che un motore di ricerca trova documenti “simili” alla tua query, o un chatbot recupera il paragrafo giusto dai tuoi file, c’è una buona probabilità che sia la somiglianza coseno a fare il confronto. È una delle idee più utili nell’apprendimento automatico, ma richiede solo la matematica scolastica. Tutti i numeri seguenti provengono dal codice che abbiamo eseguito su Python 3.13.6, con NumPy 2.5.4 per la versione vettorizzata.
La formula di similarità del coseno
cos(A, B) = (A · B) / (‖A‖ × ‖B‖)
A · B = a1×b1 + a2×b2 + ... + an×bn (dot product)
‖A‖ = √(a1² + a2² + ... + an²) (length, or norm)
Il risultato è il coseno dell’angolo tra i due vettori. Due frecce che puntano nella stessa direzione hanno un angolo di 0° e cos 0° = 1. Le frecce ad angolo retto hanno cos 90° = 0. Le frecce che puntano in direzioni opposte hanno cos 180° = -1. Poiché le lunghezze sono divise, conta solo la direzione.
Un esempio lavorato a mano
Prendiamo A = [3, 4] e B = [6, 8]:
- Prodotto scalare: 3×6 + 4×8 = 18 + 32 = 50.
- Lunghezza di A: √(9 + 16) = 5. Lunghezza di B: √(36 + 64) = 10.
- Somiglianza coseno: 50 ÷ (5 × 10) = 1.0.
B è semplicemente A raddoppiato, quindi puntano esattamente nella stessa direzione. Il nostro codice concordava: cos(A,B) = 1.000. La distanza euclidea tra loro, tuttavia, era 5,0, quindi una misura basata sulla distanza li definirebbe piuttosto diversi.
Cosa significano i valori
| Coppia | Vettori | Coseno | Significato |
|---|---|---|---|
| Stessa direzione | [3, 4] e [6, 8] | 1.000 | Direzione identica |
| Perpendicolare | [3, 4] e [4, -3] | 0.000 | Non correlato |
| Di fronte | [3, 4] e [-3, -4] | -1.000 | Direzione opposta |
Con i conteggi delle parole, che non sono mai negativi, i punteggi rimangono compresi tra 0 e 1. Con gli incorporamenti, sono possibili valori negativi, ma in pratica la maggior parte dei testi correlati ottiene punteggi ben superiori a 0. Distanza coseno è semplicemente 1 meno la somiglianza coseno, utilizzata quando una biblioteca si aspetta che “più piccolo è più vicino”.
Calcolalo in puro Python
import math
def cos(a, b):
dot = sum(x * y for x, y in zip(a, b))
na = math.sqrt(sum(x * x for x in a))
nb = math.sqrt(sum(y * y for y in b))
return dot / (na * nb)
print(cos([3, 4], [6, 8])) # 1.0
Dieci righe, nessuna biblioteca. È perfetto per l’apprendimento e i piccoli lavori. Nota cosa succede con un vettore zero: cos([0, 0], [1, 2]) sollevato ZeroDivisionError: float division by zero nella nostra corsa, perché un vettore senza lunghezza non ha direzione. Proteggilo nel codice reale.
Versione veloce con NumPy
import numpy as np
A, B = np.array([3, 4]), np.array([6, 8])
print(np.dot(A, B) / (np.linalg.norm(A) * np.linalg.norm(B))) # 1.0
Per molti vettori contemporaneamente, normalizza ciascuna riga e utilizza una moltiplicazione di matrici. Abbiamo creato 10.000 vettori casuali di 384 dimensioni (384 è una dimensione di incorporamento comune) e li abbiamo confrontati tutti con un vettore di query:
Mn = M / np.linalg.norm(M, axis=1, keepdims=True)
scores = Mn @ (q / np.linalg.norm(q))
top = np.argsort(-scores)[:3]
Il confronto completo e la classifica hanno richiesto 25,5 ms. Il risultato migliore è stata la query stessa con un punteggio di 1,0, mentre i successivi migliori vettori casuali hanno ottenuto solo circa 0,18, come ci si aspetterebbe da dati casuali non correlati. scikit-learn offre lo stesso calcolo di sklearn.metrics.pairwise.cosine_similarity, che non abbiamo eseguito qui.
Suggerimento: normalizza i vettori una volta quando li memorizzi. Dopodiché, la somiglianza del coseno è solo un prodotto scalare. Nel nostro test a 768 dimensioni, il prodotto scalare dei vettori normalizzati corrispondeva alla formula completa fino a sei cifre decimali (0,885104 in entrambe le direzioni).
Un esempio di testo: le parole contano
Trasforma ogni documento in conteggi su un piccolo vocabolario: python, errore, installazione, serpente, morso, pip. Quindi confronta ciascuno con la query “errore di installazione pip python”:
| Dott | Testo | Coseno | Distanza euclidea |
|---|---|---|---|
| d1 | errore di installazione di Python pip | 1.000 | 0.00 |
| d4 | errore python errore errore installazione pip pip | 0.904 | 2.24 |
| d2 | pip installa python python | 0.816 | 1.41 |
| d3 | pitone morso di serpente | 0.289 | 2.24 |
Il coseno si è classificato d4 al secondo posto: tratta esattamente dello stesso argomento, solo più lungo e ripetitivo. La distanza euclidea lo legava a d3, il documento serpente, perché le parole extra aumentano la distanza qualunque cosa significhino. Questo è il motivo principale per cui la ricerca testuale preferisce il coseno: la lunghezza del documento non dovrebbe decidere la pertinenza. I sistemi reali utilizzano incorporamenti anziché conteggi grezzi, quindi “installazione non riuscita” può corrispondere a “errore di installazione” anche senza parole condivise; vedi cosa sono gli incorporamenti.
Somiglianza coseno vs distanza euclidea
| Aspetto | Somiglianza del coseno | Distanza euclidea |
|---|---|---|
| Misure | Angolo (direzione) | Divario in linea retta |
| Influenzato dalla lunghezza | No | Sì |
| Gamma | -1 a 1 | 0 all’infinito |
| Meglio per | Testo, incorporamenti, raccomandazioni | Coordinate, letture dei sensori, raggruppamento di misurazioni grezze |
Per i vettori normalizzati alla lunghezza 1, i due danno la stessa classificazione, quindi la scelta è più importante per i dati grezzi e non normalizzati.
Perché la ricerca AI e RAG lo utilizzano
Nella generazione aumentata con recupero, il modello che consente a un modello linguistico di grandi dimensioni di rispondere dai tuoi documenti, ogni blocco di documento viene trasformato in un incorporamento e archiviato. Una domanda viene incorporata allo stesso modo e il sistema restituisce i blocchi con la massima somiglianza del coseno. Abbiamo simulato questo con vettori a 768 dimensioni: un vettore creato aggiungendo rumore casuale (metà della forza del segnale) a un altro ha ottenuto 0,885 contro di esso, mentre un vettore casuale non correlato ha ottenuto 0,011. I significati correlati sono vicini nella direzione; quelli non correlati sono vicini a 0. I database vettoriali accelerano questo processo con indici approssimativi dei vicini più vicini; consulta la nostra guida al database vettoriale e cos’è RAG. Anche il modo in cui dividi inizialmente i documenti è importante, come ha dimostrato il nostro test sulle strategie di suddivisione in blocchi RAG.
Dalla partitura all’angolo
Poiché il punteggio è un coseno, puoi trasformarlo nuovamente in un angolo con math.degrees(math.acos(score)). Per il nostro esempio di testo, d4 a 0,904 si trovava a circa 25,3° dalla query, d2 a 0,816 a 35,3° e il documento serpente a 0,289 a 73,2°. Gli angoli rendono concreta l’intuizione: angoli piccoli significano lo stesso argomento, angoli vicini a 90° significano poco in comune.
Come scegliere una soglia di somiglianza
Molti sistemi mantengono solo le corrispondenze superiori a un valore limite, ad esempio 0,75. Non esiste un numero giusto universale, perché ciascun modello di incorporamento distribuisce i propri punteggi in modo diverso. Un processo pratico:
- Raccogli da 30 a 50 domande reali e indica quali documenti sono veramente rilevanti.
- Calcola i punteggi del coseno per tutte le coppie di query e documenti.
- Guarda gli intervalli di punteggio delle coppie rilevanti e irrilevanti; di solito si sovrappongono leggermente.
- Scegli la soglia che bilancia le risposte mancate con quelle errate per il tuo caso d’uso, quindi ricontrollala ogni volta che cambi modello.
Spesso è più sicuro restituire le prime corrispondenze in base al punteggio e lasciare che sia l’applicazione o il modello linguistico a decidere, invece di fidarsi di un limite fisso.
Insidie da evitare
- Vettori zero: provocano la divisione per zero; saltarli o gestirli.
- Modelli misti: gli incorporamenti di modelli diversi vivono in spazi diversi, quindi i loro punteggi di coseno insieme non hanno significato.
- Trattare i punteggi come percentuali: 0,8 non è “simile all’80%” e le soglie valide differiscono in base al modello. Calibra sui tuoi dati.
- Ignorando la grandezza quando conta: se la dimensione ha un significato, come l’importo dell’acquisto, il coseno butta via quell’informazione.
- Overflow o precisione di numeri interi: utilizza la virgola mobile e normalizza una volta, non per ogni query.
Riepilogo pronto per l’intervista
“La somiglianza coseno misura l’angolo tra due vettori: il prodotto scalare diviso per il prodotto delle loro lunghezze. Varia da -1 a 1 e ignora la grandezza, il che lo rende ideale per confrontare testo e incorporamenti di lunghezze diverse. La distanza coseno è 1 meno la somiglianza e per i vettori normalizzati la somiglianza coseno è uguale al prodotto scalare, utilizzato dai database vettoriali per la velocità.” Supportalo con l’esempio [3, 4] e [6, 8], che ottiene esattamente 1,0 anche se i vettori differiscono in lunghezza.
Considerazioni finali
La somiglianza del coseno è il prodotto scalare di due vettori diviso per la loro lunghezza e risponde a una domanda: puntano nella stessa direzione? Ciò lo rende ideale per testo e incorporamenti, dove la lunghezza è rumore e la direzione è significato. Imparalo manualmente una volta, usa NumPy o il tuo database vettoriale nella pratica, normalizza presto e calibra le soglie sui tuoi dati.
Domande frequenti
Cos’è la somiglianza del coseno in termini semplici?
È un punteggio da -1 a 1 che mostra quanto due vettori puntano nella stessa direzione. 1 significa la stessa direzione, 0 significa non correlato e -1 significa opposto.
Qual è la formula di similarità del coseno?
La somiglianza del coseno è uguale al prodotto scalare di A e B diviso per il prodotto delle loro lunghezze: (A · B) / (‖A‖ × ‖B‖).
Qual è la differenza tra somiglianza del coseno e distanza del coseno?
La distanza del coseno è 1 meno la somiglianza del coseno. La somiglianza è maggiore per i vettori più vicini, mentre la distanza è inferiore per i vettori più vicini.
Perché viene utilizzata la somiglianza del coseno per il testo e gli incorporamenti?
Ignora la lunghezza del vettore, quindi un documento lungo e uno breve sullo stesso argomento vengono comunque considerati simili. Conta solo la direzione, che riflette il significato.
Come posso calcolare la somiglianza del coseno in Python?
Utilizza np.dot(a, b) / (np.linalg.norm(a) * np.linalg.norm(b)) con NumPy, sklearn.metrics.pairwise.cosine_similarity per i batch o una breve funzione Python pura con math.sqrt.
Continua a imparare
Hai bisogno di aiuto con test, WordPress o SEO?
Aiutiamo i team a fornire software migliore e a far crescere i loro siti. Raccontaci a cosa stai lavorando e ti suggeriremo chiaramente il prossimo passo.
Altre guide su test, intelligenza artificiale e sviluppo moderno
Ti è piaciuto questo articolo? Scegli un argomento e passa direttamente ai nostri tutorial più recenti.
Spiegazione di BM25: come la ricerca per parole chiave classifica i risultati, con codice Python e ricerca ibrida
BM25 ha spiegato con un'implementazione Python pura che abbiamo eseguito: la formula, IDF, la saturazione dei termini, i parametri k1 e b, perché ba…
Leggi l'articolo →Sviluppo softwareSpiegazione dei metodi HTTP: GET, POST, PUT, PATCH, DELETE, testati su un server live
Metodi HTTP spiegati con un piccolo server che abbiamo eseguito: GET, POST, PUT, PATCH, DELETE, HEAD e OPTIONS, sicuro vs idempotente, PUT vs PATCH,…
Leggi l'articolo →DevOpsSpiegazione di Git Bisect: trova il commit che ha violato il tuo codice, manualmente o automaticamente
Git bisect spiegato con un repository testato: trova l'unico commit errato tra 41 in 5 esecuzioni di test, automatizzalo con git bisect run, salta c…
Leggi l'articolo →Automazione dei testSpiegazione dei marcatori pytest: segni personalizzati, skip, skipif, xfail e -m filtri
marcatori pytest spiegati con una suite testata: registra segni personalizzati, esegui solo test del fumo con -m, combina filtri con e, oppure no, u…
Leggi l'articolo →Test del softwareTest positivi e negativi: differenze, 24 casi di test reali e una lista di controllo
Test positivi e negativi spiegati con un vero modulo di iscrizione: 6 casi di test positivi e 18 negativi eseguiti in pytest, la guardia mancante, u…
Leggi l'articolo →Database e SQLSQL ORDER BY Colonne multiple: ASC, DESC, NULLS LAST, Case e ordine personalizzato
SQL ORDER BY con più colonne spiegate con query testate: ASC e DESC misti, tie-breaker, NULLS FIRST e LAST, ordinamento senza distinzione tra maiusc…
Leggi l'articolo →Database e SQLTotale parziale SQL: SUM OVER, totali per gruppo, somme mobili e RANGE Trap
Come calcolare un totale parziale SQL con SUM() OVER: totali per gruppo, somme cumulative giornaliere, somme mobili, percentuale del totale, tie tra…
Leggi l'articolo →Sviluppo softwareArray di ordinamento JavaScript: numeri, oggetti, stringhe e perché 10 viene prima di 5
Come ordinare correttamente un array in JavaScript: numeri con una funzione di confronto, oggetti per uno o più campi, stringhe con localeCompare, d…
Leggi l'articolo →Sviluppo softwareMetodi per stringhe Python: Cheat Sheet, esempi reali e la trappola strip()
Metodi di stringhe Python con esempi testati: split, join, strip, replace, find, Startswith, is-methods, casefold, Partition e Translate, oltre alla…
Leggi l'articolo →Intelligenza artificialeSpiegazione della somiglianza del coseno: formula, esempio pratico e codice Python
La somiglianza del coseno spiegata semplicemente: la formula, un esempio realizzato a mano, codice Python puro e NumPy, distanza coseno vs euclidea …
Leggi l'articolo →Sviluppo softwareSpiegazione della codifica UTF-8: come il testo diventa byte e come correggere il testo confuso
Codifica UTF-8 spiegata con esempi a livello di byte che abbiamo eseguito in Python: come i caratteri diventano da 1 a 4 byte, perché café si trasfo…
Leggi l'articolo →Automazione dei testSpiegazione della parametrizzazione pytest: 7 modelli con esempi testati
parametrizzazione pytest spiegata con 7 modelli testati: casi base, ID leggibili, decoratori impilati, pytest.param con xfail e skip, dispositivi in…
Leggi l'articolo →Test del softwareRipetizione del test e test di regressione: 8 differenze chiave con un esempio reale di correzione di bug
Ripetizione del test e test di regressione spiegati con una vera correzione di bug eseguita in pytest: la ripetizione del test ha confermato la corr…
Leggi l'articolo →Database e SQLElimina righe duplicate in SQL: 5 metodi sicuri, testati passo dopo passo
Come eliminare le righe duplicate in SQL in modo sicuro: trovale, visualizzale in anteprima, quindi rimuovile con ROW_NUMBER, MIN(id), EXISTS, rowid…
Leggi l'articolo →Database e SQLSQL RANK vs DENSE_RANK vs ROW_NUMBER: differenze con esempi testati
SQL RANK vs DENSE_RANK vs ROW_NUMBER in una tabella: come ciascuno gestisce i pareggi, i primi N per gruppo, la trappola del secondo salario più alt…
Leggi l'articolo →Sviluppo softwareJavaScript Facoltativo Concatenamento (?.) Spiegato: 8 esempi, ?? Predefinizioni e trappole
Il concatenamento facoltativo JavaScript interrompe gli errori "Impossibile leggere le proprietà di undefinito". 8 esempi testati per proprietà, arr…
Leggi l'articolo →Sviluppo softwarePython enumerate() spiegato: 7 esempi, start=1 ed errori da evitare
Python enumerate() ti fornisce l'indice e il valore in un ciclo pulito. 7 esempi testati, il trucco start=1, dizionari, file, numeri rapidi e 3 erro…
Leggi l'articolo →Intelligenza artificialeSpiegazione delle strategie di RAG Chunking: fissa, sovrapposta, frase, ricorsiva e intestazioni, misurata
Strategie di suddivisione in blocchi RAG confrontate su un documento con tiktoken 0.14: dimensione fissa, sovrapposizione, compressione delle frasi,…
Leggi l'articolo →Sviluppo softwareSpiegazione dell'idempotenza API: chiavi di idempotenza e tentativi sicuri, testati
L'idempotenza dell'API spiegata con un server e un client Python che abbiamo eseguito: una risposta persa ha causato un doppio addebito senza chiave…
Leggi l'articolo →DevOpsSpiegazione di Git Stash: salva, applica, pop e file non tracciati, testato
Git stash spiegato con i comandi che abbiamo eseguito su Git 2.56: push con un messaggio, file non tracciati, elenca e mostra, applica vs pop, mante…
Leggi l'articolo →Test del softwareSpiegazione del test a coppie: come tutte le coppie riducono 216 test a 13, testati
Test a coppie spiegati con un generatore che abbiamo eseguito in Python 3.13: un checkout con 216 combinazioni coperte da 13 test, copertura verific…
Leggi l'articolo →Automazione dei testSpiegazione dei doppi di test: fittizio, stub, spia, finto e falso, con codice Python testato
I test raddoppiano spiegati con un esempio Python eseguito in pytest 9.2: dummy, stub, spy, mock e fake, quando usarli ciascuno, controlli di stato …
Leggi l'articolo →Database e SQLSpiegazione di SQL COALESCE: impostazioni predefinite, NULLIF, IFNULL rispetto a ISNULL e trap, testate
SQL COALESCE spiegato con le query eseguite in SQLite 3.50: primi valori non nulli, stringhe vuote, NULL in matematica, NULLIF per divisione per zer…
Leggi l'articolo →Database e SQLSpiegazione del self join SQL: dipendente-responsabile, confronti di coppie e righe, testato
Self join SQL spiegato con le query eseguite in SQLite 3.50: dipendente e manager, guadagno più del manager, coppie univoche, modifiche giornaliere,…
Leggi l'articolo →Sviluppo softwareSpiegazione dell'operatore Spread JavaScript: Spread vs Rest, copie e trucchi, testato
L'operatore di diffusione JavaScript spiegato con il codice che abbiamo eseguito sul Nodo 24: array, oggetti, copie superficiali, parametri di ripos…
Leggi l'articolo →Sviluppo softwareSpiegazione delle funzioni Python: lru_cache, partial, reduce, wraps e altro, testato
Functools Python spiegati con il codice che abbiamo eseguito su Python 3.13: lru_cache e cache, partial, reduce, wraps, cached_property, singledispa…
Leggi l'articolo →Sviluppo softwareSpiegazione del modulo Collezioni Python: Counter, defaultdict, deque e altro, testato
Raccolte Python spiegate con il codice che abbiamo eseguito su Python 3.13: Counter, defaultdict, deque, nametuple, OrderedDict e ChainMap, oltre a …
Leggi l'articolo →Intelligenza artificialeSpiegazione della finestra di contesto LLM: token, limiti e come adattarne di più, misurati
La finestra di contesto LLM spiegata con il conteggio dei token che abbiamo misurato utilizzando tiktoken: parole vs token per prosa, codice e hindi…
Leggi l'articolo →Sviluppo softwareSpiegazione dei webhook: come funzionano e come riceverli in modo sicuro
Webhook spiegati con un ricevitore e un mittente che abbiamo eseguito in Python: push vs polling, firme HMAC-SHA256, rifiuto di richieste manomesse …
Leggi l'articolo →DevOpsSpiegazione di Git Cherry-Pick: copia il commit di cui hai bisogno, in modo sicuro e testato
Git cherry-pick spiegato con i comandi che abbiamo eseguito in Git 2.56: copia di un hotfix in un ramo di rilascio, nuovi hash e ID patch, -x, -n, i…
Leggi l'articolo →Automazione dei testSpiegazione del test istantaneo: come funziona, quando aiuta e quando fa male
Il test delle istantanee è stato spiegato con una demo pytest e sciropposa che abbiamo eseguito: creazione di istantanee, lettura delle differenze d…
Leggi l'articolo →Test del softwareSpiegazione dei test di mutazione: perché la copertura del 100% continua a non individuare il nostro bug
I test di mutazione spiegati con un piccolo strumento di mutazione che abbiamo creato ed eseguito: 14 mutanti, una suite di test con copertura di li…
Leggi l'articolo →Database e SQLSpiegazione delle funzioni SQL JSON: query, aggiornamento e indicizzazione JSON in SQL, testate
Funzioni SQL JSON spiegate con le query eseguite in SQLite 3.50: json_extract, gli operatori -> e ->>, json_each, json_set, json_patch, jso…
Leggi l'articolo →Database e SQLSpiegazione di SQL Pivot: trasforma le righe in colonne con CASE, FILTER e PIVOT
Pivot SQL spiegato con le query eseguite in SQLite 3.50: aggregazione condizionale con CASE e SUM, FILTER, NULL vs zero, totali, colonne dinamiche, …
Leggi l'articolo →Intelligenza artificialeSpiegazione della Prompt Injection: come le app AI vengono ingannate e come difenderle
Iniezione rapida spiegata per gli sviluppatori: attacchi diretti e indiretti, perché i filtri delle parole chiave falliscono (il nostro test ne ha b…
Leggi l'articolo →DevOpsSpiegazione dei record DNS: A, AAAA, CNAME, MX, TXT e TTL con ricerche reali
Record DNS spiegati con le ricerche eseguite: come funziona la risoluzione, A e AAAA, regole CNAME, MX e null MX, TXT per SPF e verifica, NS, TTL e …
Leggi l'articolo →DevOpsSpiegazione delle segnalazioni di funzionalità: rilasci sicuri, implementazioni graduali e igiene delle segnalazioni
Flag di funzionalità spiegati con una simulazione di implementazione che abbiamo eseguito: tipi di flag, implementazioni percentuali con hashing sta…
Leggi l'articolo →Automazione dei testTestare la generazione di dati con Python Faker: dati realistici, ripetibili e sicuri
Testa la generazione di dati con Python Faker, esegui e misura: seeding per dati ripetibili, impostazioni locali, valori univoci, record a forma di …
Leggi l'articolo →Test del softwareSpiegazione del test Shift-Left: trova i bug prima senza rallentare il team
Spiegazione del test con spostamento a sinistra: cosa significa, perché i primi difetti sono più economici, pratiche dalle revisioni dei requisiti a…
Leggi l'articolo →Database e SQLSpiegazione delle funzioni della stringa SQL: TRIM, SUBSTR, REPLACE, CONCAT e pulizia dei dati
Funzioni di stringa SQL spiegate con le query che abbiamo eseguito: concatenazione e NULL, TRIM, UPPER e LOWER, SUBSTR e INSTR, REPLACE, riempimento…
Leggi l'articolo →Database e SQLSpiegazione dei trigger SQL: trigger PRIMA e DOPO, registri di controllo e insidie
Trigger SQL spiegati con i trigger che abbiamo eseguito: PRIMA vs DOPO, VECCHIO e NUOVO, registri di controllo, convalida, aggiornamenti delle scort…
Leggi l'articolo →Sviluppo softwareSpiegazione del modulo JSON Python: dump, caricamenti, tipi personalizzati ed errori comuni
Il modulo Python JSON spiegato con il codice che abbiamo eseguito: dump e caricamenti, file, conversioni di tipo, date e decimali, codificatori pers…
Leggi l'articolo →Sviluppo softwareModuli ES vs CommonJS: come funzionano le importazioni JavaScript in Node.js, testato
Moduli ES e CommonJS spiegati con il codice eseguito in Node.js: sintassi di importazione ed esportazione, require, collegamenti attivi, memorizzazi…
Leggi l'articolo →Sviluppo softwareSpiegazione di Python Regex: modelli, gruppi, prospettive e insidie, testati
L'espressione regolare di Python è stata spiegata con i modelli che abbiamo eseguito: ricerca vs corrispondenza, trovatutto, gruppi e gruppi denomin…
Leggi l'articolo →Intelligenza artificialeSpiegazione dell'output strutturato LLM: ottenere JSON affidabile dai modelli AI
Output strutturato LLM spiegato con la convalida eseguita in Pydantic: modalità e schemi JSON, decodifica vincolata, modi in cui l'output del modell…
Leggi l'articolo →DevOpsSpiegazione delle chiavi SSH: come funzionano, ssh-keygen, Ed25519 e abitudini sicure
Chiavi SSH spiegate con le chiavi che abbiamo generato: chiavi pubbliche e private, ssh-keygen, Ed25519 e RSA, impronte digitali, passphrase, ssh-ag…
Leggi l'articolo →DevOpsSpiegazione della memorizzazione nella cache HTTP: controllo della cache, ETag e risposte 304, con un test in tempo reale
Caching HTTP spiegato con un piccolo server che abbiamo eseguito: direttive Cache-Control, max-age, no-cache vs no-store, riconvalida ETag e rispost…
Leggi l'articolo →Automazione dei testSpiegazione del test del contratto API: rileva le modifiche importanti prima della spedizione
I test dei contratti API sono stati spiegati con un controllo dello schema che abbiamo eseguito: cos'è un contratto, contratti orientati al consumat…
Leggi l'articolo →Test del softwareSpiegazione dei test basati sul rischio: valuta i rischi, costruisci una matrice e testa ciò che conta
Test basati sul rischio spiegati passo dopo passo: identificazione dei rischi, valutazione della probabilità e dell'impatto, creazione di una matric…
Leggi l'articolo →Database e SQLSpiegazione dei vincoli SQL: NOT NULL, UNIQUE, CHECK e FOREIGN KEY, testati
Vincoli SQL spiegati con i test che abbiamo eseguito: NOT NULL, UNIQUE, CHECK, DEFAULT, PRIMARY e FOREIGN KEY, le scappatoie NULL, l'impostazione de…
Leggi l'articolo →Database e SQLSpiegazione delle funzioni di data SQL: aggiunta, confronto e raggruppamento di date senza bug
Funzioni di data SQL spiegate con le query che abbiamo eseguito: aggiunta di intervalli, sorprese di fine mese, differenze di data, trappola BETWEEN…
Leggi l'articolo →Sviluppo softwarePython asyncio spiegato: asincrono, attendi, raccogli e TaskGroup con tempi reali
L'asincronismo di Python è stato spiegato con il codice che abbiamo cronometrato: coroutine, attendibilità, raccolta, TaskGroup, gestione degli erro…
Leggi l'articolo →Sviluppo softwareDebounce vs Throttle in JavaScript: come funzionano, quando usarli, testati
Debounce e accelerazione in JavaScript spiegati con i tempi misurati in Node.js: come funziona ciascuno, implementazioni semplici, chiamate iniziali…
Leggi l'articolo →Sviluppo softwareSpiegazione dei gestori di contesto Python: with Statement, contextlib e usi reali
I gestori di contesto Python spiegati con il codice che abbiamo eseguito: come funziona, __enter__ e __exit__, contextlib.contextmanager, soppressio…
Leggi l'articolo →Intelligenza artificialeSpiegazione della temperatura LLM e della top-p: come i modelli di intelligenza artificiale scelgono la parola successiva
La temperatura LLM e la top-p sono spiegate con una simulazione che abbiamo eseguito: come vengono rimodellate le probabilità, cosa mantiene la top-…
Leggi l'articolo →DevOpsSpiegazione di YAML: sintassi, problema della Norvegia e altre trappole che abbiamo testato
YAML spiegato con un parser test: sintassi di base, elenchi e mappe, il problema della Norvegia, versioni trasformate in float, codici postali ottal…
Leggi l'articolo →DevOpsSpiegazione di Cron Jobs: sintassi, programmi reali e errori che li interrompono
Lavori Cron spiegati con pianificazioni da noi verificate: i cinque campi, operatori, esempi reali, la trappola del giorno del mese O del giorno del…
Leggi l'articolo →Intelligenza artificialeSpiegazione delle allucinazioni dell'intelligenza artificiale: perché i modelli linguistici inventano le cose e come ridurle
Spiegazione delle allucinazioni dell'intelligenza artificiale: cosa sono, perché i modelli linguistici le producono, tipi comuni, come ridurle con b…
Leggi l'articolo →DevOpsSpiegazione delle variabili d'ambiente: file .env, segreti e configurazione eseguiti correttamente
Variabili d'ambiente spiegate con esempi Python che abbiamo eseguito: lettura e impostazione, perché ogni valore è una stringa, file .env, ereditari…
Leggi l'articolo →Sviluppo softwareSpiegazione della limitazione della velocità API: algoritmi, intestazioni e gestione degli errori 429
La limitazione della velocità dell'API spiegata con una simulazione che abbiamo eseguito: bucket di token, finestra fissa, finestra scorrevole, risp…
Leggi l'articolo →Automazione dei testDerisione in Python: unittest.mock, patch e gli errori che fanno mentire i test
Mocking in Python con unittest.mock, testato: Mock e return_value, side_effect, patch dove viene utilizzato un nome, specifiche e autospec, date moc…
Leggi l'articolo →Test del softwareSpiegazione della copertura del codice: copertura di linea o di filiale e cosa significa realmente il 100%.
Copertura del codice spiegata con una vera esecuzione di cover.py: copertura di linea, ramo e condizione, lettura di un rapporto, perché la copertur…
Leggi l'articolo →Database e SQLDELETE vs TRUNCATE vs DROP in SQL: differenze, rollback e quando utilizzarli
DELETE vs TRUNCATE vs DROP spiegato con SQL testato: cosa rimuove, rollback, trigger, reimpostazione dell'identità, velocità e come differiscono Pos…
Leggi l'articolo →Database e SQLSpiegazione delle visualizzazioni SQL: crea, utilizza ed evita le insidie, con esempi
Viste SQL spiegate con le query che abbiamo eseguito: creazione di una vista, risultati in tempo reale, nascondere colonne, prestazioni, viste aggio…
Leggi l'articolo →Sviluppo softwareInterfaccia TypeScript e tipo: differenze reali, testate con il compilatore
Interfaccia TypeScript vs tipo, verificata con il vero compilatore: cosa possono fare entrambi, cosa può fare solo uno, fusione delle dichiarazioni,…
Leggi l'articolo →Sviluppo softwareSpiegazione di Python *args e **kwargs: funzioni flessibili con esempi chiari
Python *args e **kwargs spiegati con il codice che abbiamo eseguito: compressione e decompressione, ordine dei parametri, argomenti solo per parole …
Leggi l'articolo →Sviluppo softwareFunzioni Lambda Python: sintassi, usi reali e quando non usarli
Funzioni lambda Python spiegate con il codice che abbiamo eseguito: sintassi, ordinamento con chiave, mappa e filtro, chiusure, trap dell'associazio…
Leggi l'articolo →Intelligenza artificialeCosa sono gli agenti AI? Come funzionano, con un semplice ciclo di agenti che puoi eseguire
Cosa sono gli agenti IA? Una semplice guida al ciclo dell'agente, agli strumenti, alla memoria e ai guardrail, con un piccolo ciclo Python che abbia…
Leggi l'articolo →DevOpsMonitoraggio vs osservabilità: la vera differenza, con log, metriche e tracce
Spiegazione del monitoraggio e dell'osservabilità: errori noti e sconosciuti, log, metriche e tracce, una procedura dettagliata sugli incidenti di p…
Leggi l'articolo →DevOpsVolumi Docker e montaggi di associazione: mantenere i dati del contenitore nel modo giusto
Volumi Docker e montaggi di collegamento spiegati: perché i dati del contenitore scompaiono, volumi denominati, montaggi di collegamento, tmpfs, ese…
Leggi l'articolo →Automazione dei testTDD vs BDD: differenze chiave, una caratteristica costruita in entrambi i modi e quando utilizzarli ciascuno
TDD vs BDD spiegato con una funzione di sconto costruita in entrambi i modi: refactoring rosso-verde con il codice che abbiamo eseguito, scenari "Da…
Leggi l'articolo →Test del softwareTest di accettazione da parte dell'utente (UAT): processo, lista di controllo ed esempi reali
Spiegazione del test di accettazione dell'utente: chi lo esegue, in cosa differisce dal QA, un processo in sette fasi, un modello di test case UAT, …
Leggi l'articolo →Database e SQLSpiegazione dei valori SQL NULL: IS NULL, COALESCE, NULLIF e le trappole da evitare
Valori SQL NULL spiegati con le query che abbiamo eseguito: logica a tre valori, IS NULL, COALESCE, NULLIF, come aggregazioni, join e ordinamento tr…
Leggi l'articolo →Database e SQLIstruzione SQL CASE WHEN: sintassi, esempi reali ed errori comuni
SQL CASE WHEN spiegato con le query che abbiamo eseguito: moduli semplici e cercati, ordine delle condizioni, pivot con SUM, trucchi COUNT, ordiname…
Leggi l'articolo →Sviluppo softwareCos'è il JWT? Token Web JSON spiegati con un esempio funzionante
Cos'è il JWT? Spiegazione dei token Web JSON: le tre parti, un token creato e manomesso nel codice che abbiamo eseguito, JWT e sessioni, archiviazio…
Leggi l'articolo →Sviluppo softwareSpiegazione del loop di eventi JavaScript: stack di chiamate, microtask e timer con esempi
Il ciclo di eventi JavaScript spiegato con il codice che abbiamo eseguito: stack di chiamate, code di attività e microtask, perché setTimeout 0 non …
Leggi l'articolo →Sviluppo softwareSpiegazione dei generatori Python e del rendimento: risparmia memoria con esempi reali
Generatori Python e rendimento spiegati con il codice che abbiamo eseguito: come vengono messi in pausa e ripresi, misurato il risparmio di memoria,…
Leggi l'articolo →Intelligenza artificialeCosa sono gli incorporamenti? I vettori e la somiglianza del coseno spiegati semplicemente
Cosa sono gli incorporamenti? Una guida in linguaggio semplice ai vettori, alla similarità del coseno e alla ricerca semantica, con un piccolo esemp…
Leggi l'articolo →DevOpsDistribuzione blu-verde rispetto a quella canaria: differenze, compromessi e come scegliere
Spiegazione della distribuzione blu-verde e canary: come funziona ciascuna, costi, rischi e rollback, bucket utente stabile che abbiamo testato, mig…
Leggi l'articolo →Automazione dei testTest instabili: quali sono le cause e come risolverli definitivamente
Test instabili spiegati con demo che abbiamo eseguito: le cause principali, come confermarne e diagnosticarne uno, soluzioni adeguate per tempistich…
Leggi l'articolo →Test del softwareTest di carico e test di stress: differenze, metriche ed esempi k6
Spiegazione del test di carico e dello stress test: cosa dimostra ciascuno, test di picco e di assorbimento, le metriche che contano, perché le medi…
Leggi l'articolo →Test del softwareCaso di test e scenario di test: differenze chiave, esempi e quando utilizzarli
Spiegazione del caso di test e dello scenario di test: definizioni chiare, una tabella affiancata, una funzione di reimpostazione della password pre…
Leggi l'articolo →Database e SQLOttimizzazione delle query SQL: leggi i piani di esecuzione e correggi query lente, con tempistiche
Ottimizzazione delle query SQL testata su un milione di righe: leggi i piani di esecuzione, aggiungi gli indici corretti, correggi filtri non aggior…
Leggi l'articolo →Database e SQLSQL UNION vs UNION ALL: differenze, esempi e prestazioni testate
SQL UNION vs UNION ALL spiegati con le query che abbiamo eseguito: duplicati, regole seguite da entrambi, un vero bug di dati, prestazioni misurate,…
Leggi l'articolo →Sviluppo softwareTutorial sull'API di recupero JavaScript: GET, POST, gestione degli errori e timeout
Un tutorial sull'API JavaScript Fetch testato su un server locale: GET e POST, perché 404 non genera eccezioni, un helper riutilizzabile, stringhe d…
Leggi l'articolo →Sviluppo softwareGestione dei file Python: lettura, scrittura, CSV, JSON e pathlib con esempi
Gestione dei file Python spiegata con il codice che abbiamo eseguito: modalità aperte, con, lettura di file di grandi dimensioni, CSV, JSON, pathlib…
Leggi l'articolo →Sviluppo softwareClassi e oggetti Python: tutorial OOP con esempi reali
Classi e oggetti Python spiegati con il codice che abbiamo eseguito: __init__, metodi, attributi di classe e istanza, ereditarietà, proprietà, metod…
Leggi l'articolo →Intelligenza artificialeChe cos'è un modello linguistico di grandi dimensioni? Come funzionano i LLM, spiegato senza esagerazioni
Cos’è un modello linguistico ampio? LLM spiegati in un linguaggio semplice: token, incorporamenti, attenzione, formazione, finestre di temperatura e…
Leggi l'articolo →DevOpsComandi Linux per principianti: la guida essenziale del terminale con esempi
Comandi Linux per principianti, raggruppati per attività: navigazione, file, visualizzazione log, grep, pipe, permessi, processi e archivi, con un e…
Leggi l'articolo →Automazione dei testSelenio vs drammaturgo: differenze chiave, codice a confronto e quale scegliere
Selenium vs Playwright a confronto: architettura, attesa, supporto per browser e linguaggio, debug, lo stesso test in entrambi gli strumenti, consig…
Leggi l'articolo →Test del softwarePartizionamento di equivalenza: tecnica di progettazione dei test spiegata con esempi pratici
Spiegazione del partizionamento di equivalenza: come trovare partizioni valide e non valide, esempi funzionanti per età, password e coupon, test che…
Leggi l'articolo →Test del softwareGravità vs priorità nel test del software: differenze, matrice ed esempi reali
Spiegazione della gravità e della priorità nei test del software: definizioni chiare, una matrice a quattro vie con esempi, scale di livello, chi im…
Leggi l'articolo →Database e SQLEsercitazione sulle sottoquery SQL: tipi, sottoquery correlate ed EXISTS con esempi
Un tutorial sulle sottoquery SQL con le query che abbiamo eseguito: sottoquery scalari, IN, FROM e SELECT, sottoquery correlate, EXISTS, trap NOT IN…
Leggi l'articolo →Database e SQLSpiegazione di transazioni SQL e ACID: COMMIT, ROLLBACK e livelli di isolamento
Transazioni SQL e ACID spiegate con un bonifico bancario eseguito: COMMIT, ROLLBACK, punti di salvataggio, blocchi, livelli di isolamento, letture s…
Leggi l'articolo →Sviluppo softwareCheat sheet dei comandi Git: i comandi che usi effettivamente, con esempi
Un cheat sheet dei comandi Git raggruppato per attività: configurazione, staging, rami, telecomandi, stash, cronologia ed errori di annullamento, co…
Leggi l'articolo →Sviluppo softwareSpiegazione delle promesse JavaScript: quindi, cattura, Promise.all ed errori comuni
Promesse JavaScript spiegate con il codice che abbiamo eseguito: stati, catene then e catch, gestione degli errori, Promise.all, allSettled, race an…
Leggi l'articolo →Sviluppo softwareTutorial sul dizionario Python: metodi, esempi e modelli comuni
Un tutorial sul dizionario Python con il codice che abbiamo eseguito: creazione, lettura e aggiornamento di dettami, metodi chiave, unione, comprens…
Leggi l'articolo →Intelligenza artificialeCos'è il RAG? La generazione aumentata di recupero spiegata con un esempio funzionante
Cos'è il RAG? La generazione aumentata di recupero viene spiegata passo dopo passo: indicizzazione, suddivisione in blocchi, incorporamenti, recuper…
Leggi l'articolo →DevOpsTutorial Terraform per principianti: infrastruttura come codice dal primo file ai moduli
Un tutorial su Terraform per principianti: inizia senza account cloud, impara init, pianifica e applica, quindi variabili, output, stato, moduli e u…
Leggi l'articolo →DevOpsDocker vs Kubernetes: differenze chiave, come funzionano insieme e di cosa hai bisogno
Spiegazione di Docker vs Kubernetes: cosa fa ciascuno, la stessa app viene eseguita con entrambi, Docker Compose e Swarm a confronto, il dockershim …
Leggi l'articolo →Automazione dei testTutorial Pytest per principianti: infissi, parametrizzazione ed esempi reali
Un tutorial pytest per principianti con test che abbiamo eseguito su pytest 9.2: asserzioni, dispositivi, parametrizzazione, conftest, marcatori, tm…
Leggi l'articolo →Test del softwareCiclo di vita del test del software (STLC): 6 fasi, criteri di ingresso e uscita, esempio
Spiegazione del ciclo di vita del test del software: sei fasi STLC con criteri di ingresso e uscita, risultati finali, un esempio di funzionalità di…
Leggi l'articolo →Sviluppo softwareGit merge vs rebase: differenze, esempi e quando usare ciascuno
Git merge vs rebase spiegato con output reale del log, una tabella di confronto, la regola d'oro del rebase e un flusso di lavoro sicuro per i team.
Leggi l'articolo →Sviluppo softwareList comprehension in Python: sintassi, esempi e quando evitarla
List comprehension in Python spiegata: sintassi, filtri, if-else, cicli annidati, tempi misurati e i casi in cui un normale ciclo for è meglio.
Leggi l'articolo →Database e SQLSQL JOIN spiegati con esempi (Inner, Left, Right, Full)
Capisci i JOIN SQL passo dopo passo con tabelle e query di esempio: INNER, LEFT, RIGHT, FULL, CROSS e SELF, con errori comuni e consigli sulle prest…
Leggi l'articolo →