VIM(1) Manuale dei comandi generali VIM(1)
NOME
vim - VI Migliorato, un editor di testi per programmatori
SINTASSI
vim [opzioni] [file ..]
vim [opzioni] -
vim [opzioni] -t tag
vim [opzioni] -q [file_errori]
ex
view
gvim gview evim eview
rvim rview rgvim rgview
DESCRIZIONE
Vim Un editore di testi, compatibile con, e migliore di, Vi. Può essere
usato per editare qualsiasi file di testo. Particolarmente utile per
editare programmi.
Ci sono parecchi miglioramenti rispetto a Vi: undo multipli, finestre e
buffer multipli, evidenziazione sintattica, possibilità di modificare
la riga di comando, completamento nomi file, help in linea, selezione
testi in Modo Visual, etc.. Vedere ":help vi_diff.txt" per un sommario
delle differenze fra Vim e Vi.
Mentre usate Vim potete ricevere molto aiuto dal sistema di help onli-
ne, col comando ":help". Vedere qui sotto la sezione AIUTO ONLINE.
Quasi sempre Vim viene invocato, per modificare un file, col comando
vim nome_file
Più in generale Vim viene invocato con:
vim [opzioni] [lista_file]
Se lista_file non è presente, l'editor inizia aprendo un buffer vuoto.
Altrimenti, una e una sola delle quattro maniere indicate qui sotto può
essere usata per scegliere uno o più file da modificare.
nome_file ..
Una lista di nomi di file. Il primo di questi sarà il file
corrente, e verrà letto nel buffer. Il cursore sarà posi-
zionato sulla prima linea del buffer. Potete arrivare agli
altri file col comando ":next". Per editare un file il cui
nome inizia per "-" premettete "--" alla lista_file.
- Il file da editare è letto dallo "stdin"- I comandi sono
letti da "stderr", che dovrebbe essere un terminale [tty].
-t {tag} Il file da editare e la posizione iniziale del cursore di-
pendono da "tag", una specie di "etichetta" a cui saltare.
{tag} viene cercata nel file "tags", e il file a essa asso-
ciato diventa quello corrente, ed il comando ad essa asso-
ciato viene eseguito. Di solito si usa per programmi C, nel
qual caso {tag} potrebbe essere un nome di funzione. L'ef-
fetto è che il file contenente quella funzione diventa il
file corrente e il cursore è posizionato all'inizio della
funzione. Vedere ":help tag-commands".
-q [file_errori]
Inizia in Modo QuickFix [correzione veloce]. Il file [fi-
le_errori] è letto e il primo errore è visualizzato. Se
[file_errori] non è indicato, il suo nome è ottenuto dal
valore dell'opzione 'errorfile' (che, se non specificata,
vale "AztecC.Err" per l'Amiga, "errors.err" su altri siste-
mi). Si può saltare all'errore successivo col comando
":cn". Vedere ":help quickfix".
Vim si comporta in modo diverso se invocato con nomi differenti (il
programma eseguibile "sottostante" può essere sempre lo stesso).
vim Modo Normal, comportamento normale.
ex Inizia in Modo "Ex". Si può passare in Modo Normal col coman-
do ":vi". Si può invocare il Modo "Ex" anche con l'argomento
"-e".
view Inizia in Modo Read-only (Sola Lettura). Non potete modifica-
re i file. Si può invocare il Modo Read-only anche con l'ar-
gomento "-R".
gvim gview
La versione GUI [Graphical User Interface]. Apre una nuova
finestra. Si può invocare il Modo GUI anche con l'argomento
"-g".
evim eview
La versione GUI in Modo Easy (semplificata). Apre una nuova
finestra. Si può invocare il Modo Easy anche con l'argomento
"-y".
rvim rview rgvim rgview
Come sopra, ma con restrizioni ai comandi. Non si potranno
eseguire comandi della shell o sospendere Vim. Si può chiede-
re la stessa cosa anche con l'argomento "-Z".
OPZIONI
Le opzioni possono essere in un ordine qualsiasi, prima o dopo i nomi
di file. Opzioni che non hanno un argomento si possono specificare die-
tro a un solo "-".
+[numero] Per il primo file il cursore sarà posizionato sulla linea
"numero". Se "numero" manca, il cursore sarà posizionato
sull'ultima linea del file.
+/{espressione}
Per il primo file il cursore sarà posizionato alla prima
occorrenza di {espressione}. Vedere ":help search-pattern"
per come specificare l'espressione.
+{comando}
-c {comando}
{comando} sarà eseguito dopo che il primo file è stato let-
to. {comando} è interpretato come un comando Ex. Se il {co-
mando} contiene spazi deve essere incluso fra doppi apici
(o altro delimitatore, a seconda della shell che si sta
usando). Esempio: vim "+set si" main.c
Note: Si possono avere fino a 10 comandi "+" o "-c".
-S {file} I comandi contenuti in {file} sono eseguiti dopo la lettura
del primo file. Equivalente a -c "source {file}". {file}
non può avere un nome che inizia per '-'. Se {file} è omes-
so si usa "Session.vim" (funziona solo se -S è l'ultimo ar-
gomento specificato).
--cmd {comando}
Come "-c", ma il comando è eseguito PRIMA di eseguire qual-
siasi file vimrc. Si possono usare fino a 10 di questi co-
mandi, indipendentemente dai comandi "-c".
-A Se Vim è stato compilato con supporto ARABIC per editare
file con orientamento destra-sinistra e tastiera con mappa-
tura araba, questa opzione inizia Vim in Modo Arabic, cioè
impostando 'arabic'. Altrimenti viene dato un messaggio di
errore e Vim termina in modo anormale.
-b Modo Binary (binario). Vengono impostate alcune opzioni che
permettono di modificare un file binario o un programma
eseguibile.
-C Compatibile. Imposta l'opzione 'compatible'. In questo modo
Vim ha quasi lo stesso comportamento di Vi, anche in pre-
senza di un file .vimrc.
-d Inizia in Modo Diff [differenze]. Dovrebbero esserci come
argomenti due o tre o quattro nomi di file. Vim aprirà tut-
ti i file evidenziando le differenze fra gli stessi. Fun-
ziona come vimdiff(1).
-d {dispositivo}
Apre {dispositivo} per usarlo come terminale. Solo per
l'Amiga. Esempio: "-d con:20/30/600/150".
-D Debugging. Vim si mette in Modo "debugging" a partire
dall'esecuzione del primo comando da uno script.
-e Eseguire Vim in Modo Ex, come se il programma eseguito sia
"ex".
-E Eseguire Vim in Modo Ex migliorato, come se il programma
eseguito sia "exim".
-f Direttamente [Foreground]. Per la versione GUI, Vim non
crea [fork] una nuova finestra, indipendente dalla shell di
invocazione. Per l'Amiga, Vim non è fatto ripartire per
aprire una nuova finestra. Opzione da usare quando Vim è
eseguito da un programma che attende la fine della sessione
di edit (ad es. mail). Sull'Amiga i comandi ":sh" e ":!"
non sono disponibili.
--nofork Direttamente [Foreground]. Per la versione GUI, Vim non
crea [fork] una nuova finestra, indipendente dalla shell di
invocazione.
-F Se Vim è stato compilato con supporto FKMAP per editare fi-
le con orientamento destra-sinistra e tastiera con mappatu-
ra Farsi, questa opzione inizia Vim in Modo Farsi, cioè im-
postando 'fkmap' e 'rightleft'. Altrimenti viene dato un
messaggio di errore e Vim termina in modo anormale.
-g Se Vim è stato compilato con supporto GUI, questa opzione
chiede di usarla. Se Vim è stato compilato senza supporto
GUI viene dato un messaggio di errore e Vim termina in modo
anormale.
-h Un po' di aiuto su opzioni e argomenti che si possono dare
invocando Vim. Subito dopo Vim esce.
-H Se Vim è stato compilato col supporto RIGHTLEFT per editare
file con orientamento destra-sinistra e tastiera con mappa-
tura Ebraica, questa opzione inizia Vim in Modo Ebraico,
cioè impostando 'hkmap' e 'rightleft'. Altrimenti viene da-
to un messaggio di errore e Vim termina in modo anormale.
-i {viminfo}
Se è abilitato l'uso di un file viminfo, questa opzione in-
dica il nome del file da usare invece di quello predefinito
"~/.viminfo". Si può anche evitare l'uso di un file .vimin-
fo, dando come nome "NONE".
-L Equivalente a -r.
-l Modo Lisp. Imposta le opzioni 'lisp' e 'showmatch'.
-m Inibisce modifica file. Inibisce l'opzione 'write'. È anco-
ra possibile modificare un buffer, ma non riscriverlo.
-M Modifiche non permesse. Le opzioni 'modifiable' e 'write'
sono annullate, in modo da impedire sia modifiche che ri-
scritture. Da notare che queste opzioni possono essere abi-
litate in seguito, permettendo così modifiche.
-N Modo "Non-compatibile". Annulla l'opzione 'compatible'.
Così Vim va un po' meglio, ma è meno compatibile con Vi,
anche in assenza di un file .vimrc.
-n Inibisce l'uso di un file di swap. Il recupero dopo una ca-
duta di macchina diventa impossibile. Utile per editare un
file su un supporto molto lento (ad es. floppy). Il comando
":set uc=0" ha lo stesso effetto. Per abilitare il recupero
usare ":set uc=200".
-nb Diviene un Editor server per NetBeans. Vedere la documenta-
zione per dettagli.
-o[N] Apri N finestre in orizzontale. Se N manca, apri una fine-
stra per ciascun file.
-O[N] Apri N finestre, in verticale. Se N manca, apri una fine-
stra per ciascun file.
-p[N] Apri N pagine di linguette. Quando N è omesso, apri una pa-
gine di linguette per ciascun file.
-R Modo Read-only (Sola Lettura). Imposta l'opzione 'readon-
ly'. Si può ancora modificare il buffer, ma il file è pro-
tetto da una riscrittura involontaria. Se si vuole davvero
riscrivere il file, occorre aggiungere un punto esclamativo
al comando Ex, come in ":w!". L'opzione -R implica anche
l'opzione -n (vedere sotto). L'opzione 'readonly' può esse-
re annullata con ":set noro". Vedere ":help 'readonly'".
-r Lista file di swap, e informazioni su come usarli per ri-
pristinare file.
-r {file} Modo Recovery (ripristino). Il file di swap è usato per re-
cuperare una sessione di edit finita male. Il file di swap
è un file con lo stesso nome file del file di testo edita-
to, col suffisso ".swp". Vedere ":help recovery".
-s Modo silenzioso. Solo quando invocato come "Ex" o quando
l'opzione "-e" è stata data prima dell'opzione "-s".
-s {scriptin}
Lo script file {scriptin} è letto. I caratteri nel file so-
no interpretati come se immessi da terminale. Lo stesso ri-
sultato si può ottenere col comando ":source! {scriptin}".
Se la fine del file di input viene raggiunta prima che Vim
termini, l'ulteriore input verrà preso dalla tastiera.
-T {terminale}
Dice a Vim quale tipo di terminale state usando. Utile solo
se il terminale non viene riconosciuto correttamente da
Vim. Dovrebbe essere un terminale noto a Vim (internamente)
o definito nei file termcap o terminfo.
-u {vimrc} Usa i comandi nel file {vimrc} per inizializzazioni. Tutte
le altre inizializzazioni non sono eseguite. Usate questa
opzione per editare qualche file di tipo speciale. Si pos-
sono anche omettere tutte le inizializzazioni dando come
nome "NONE". Vedere ":help initialization" da vim per ulte-
riori dettagli.
-U {gvimrc} Usa i comandi nel file {gvimrc} per inizializzazioni GUI.
Tutte le altre inizializzazioni GUI non sono eseguite. Si
possono anche omettere tutte le inizializzazioni GUI dando
come nome "NONE". Vedere ":help gui-init" da vim per ulte-
riori dettagli.
-V[N] Verboso. Vim manda messaggi relativi ai file di script che
esegue e quando legge o scrive un file viminfo. Il numero
opzionale N è il valore dell'opzione 'verbose'. Il valore
predefinito è 10.
-v Inizia Vim in Modo Vi, come se il programma eseguibile fos-
se "vi". Questo ha effetto solo quando Vim viene invocato
con il nome "ex".
-w {scriptout}
Ogni carattere immesso viene registrato nel file {scrip-
tout}, finché non si esce da Vim. Utile se si vuole creare
uno script file da usare con "vim -s" o ":source!". Se il
file {scriptout} esiste, quel che immettete viene aggiunto
in fondo.
-W {scriptout}
Come -w, ma uno script file esistente viene sovrascritto.
-x Uso di cifratura nella scrittura dei file. Verrà chiesta
una chiave di cifratura.
-X Non connettersi al server X. Vim parte più rapidamente, ma
il titolo della finestra e la clipboard non sono usati.
-y Eseguire Vim in Modo Easy (semplificato), come se l'esegui-
bile invocato sia "evim" o "eview". Fa sì che Vim si com-
porti come un editor che usa solo il mouse e i caratteri.
-Z Modo ristretto. Vim si comporta come se invocato con un no-
me che inizia per "r".
-- Specifica la fine delle opzioni. Argomenti specificati dopo
questo sono considerati nomi file. Si può usare per editare
un file il cui nome inizi per '-'.
--clean Richiede di non usare alcun file di personalizzazione
(vimrc, plugin, etc.). Utile per verificare se un problema
persiste invocando Vim "originale".
--echo-wid Solo per GUI GTK: Visualizza Window ID su "stdout".
--help Vim dà un messaggio ed esce, come con l'argomento "-h".
--literal Considera i nomi passati come argomenti letterali, senza
espandere metacaratteri. Non ha effetto in Unix, dove la
shell espande comunque i metacaratteri.
--noplugin Non caricare plugin. Implicito se si specifica -u NONE.
--remote Connettersi a un server Vim e chiedere di editare i file
elencati come altri argomenti. Se non si trova un server
viene dato un messaggio e i file sono editati nel Vim cor-
rente.
--remote-expr {expr}
Connettersi a un server Vim, valutare {expr} e stampare il
risultato su "stdout".
--remote-send {chiavi}
Connettersi a un server Vim e spedirgli {chiavi}.
--remote-silent
Come --remote, ma senza avvisare se non si trova un server.
--remote-wait
Come --remote, ma Vim non termina finché i file non sono
stati editati.
--remote-wait-silent
Come --remote-wait, ma senza avvisare se non si trova un
server.
--serverlist
Elenca i nomi di tutti i server Vim disponibili.
--servername {nome}
Usa {nome} come nome server. Usato per il Vim corrente, a
meno che sia usato con l'argomento --remote, nel qual caso
indica il server a cui connettersi.
--socketid {id}
Solo per GUI GTK: Usa meccanismo GtkPlug per eseguire gvim
in un'altra finestra.
--startuptime {nome_file}
Durante la fase iniziale, scrive messaggi di log al file
{nome_file}.
--version Stampa la versione di Vim ed esci.
AIUTO ONLINE
Battere ":help" in Vim per iniziare. Battere ":help argomento" per ri-
cevere aiuto su uno specifico argomento. Per esempio: ":help ZZ" per
ricevere aiuto sul comando "ZZ". Usare <Tab> e CTRL-D per completare
gli argomenti (":help cmdline-completion"). Ci sono "tag" nei file di
help per passare da un argomento a un altro (simili a legami iperte-
stuali, vedere ":help"). Tutti i file di documentazione possono essere
navigati così. Ad es.: ":help syntax.txt".
FILE
/usr/share/vim/vim91/doc/*.txt
I file di documentazione di Vim Usare ":help doc-fi-
le-list" per avere la lista completa.
/usr/share/vim/vim91/doc/tags
Il file di tags usato per trovare informazioni nei file
di documentazione.
/usr/share/vim/vim91/syntax/syntax.vim
Inizializzazioni sintattiche a livello di sistema.
/usr/share/vim/vim91/syntax/*.vim
File di colorazione sintattica per vari linguaggi.
/usr/share/vim/vimrc
Inizializzazioni Vim a livello di sistema.
~/.vimrc Inizializzazioni personali di Vim
/usr/share/vim/gvimrc
Inizializzazioni gvim a livello di sistema.
~/.gvimrc Inizializzazioni personali di
/usr/share/vim/vim91/optwin.vim
Script Vim usato dal comando ":options", da usare per
visualizzare e impostare opzioni.
/usr/share/vim/vim91/menu.vim
Inizializzazioni del menù gvim a livello di sistema.
/usr/share/vim/vim91/bugreport.vim
Script Vim per generare una segnalazione di errore. Ve-
dere ":help bugs".
/usr/share/vim/vim91/filetype.vim
Script Vim per determinare il tipo di un file dal suo
nome. Vedere ":help 'filetype'".
/usr/share/vim/vim91/scripts.vim
Script Vim per determinare il tipo di un file dal suo
contenuto. Vedere ":help 'filetype'".
/usr/share/vim/vim91/print/*.ps
File usati per stampa PostScript.
Per informazioni aggiornate [in inglese - NdT] vedere la home page di
Vim:
<URL:http://www.vim.org/>
VEDERE ANCHE
vimtutor(1)
AUTORE
Buona parte di Vim è stato scritto da Bram Moolenaar, con molto aiuto
da parte di altri. Vedere ":help credits" in Vim.
Vim è basato su Stevie, scritto da: Tim Thompson, Tony Andrews e G.R.
(Fred) Walter. In verità, poco o nulla è rimasto del loro codice origi-
nale.
BACHI
Probabili. Vedere ":help todo" per una lista di problemi noti.
Si noti che un certo numero di comportamenti che possono essere consi-
derati errori da qualcuno, sono in effetti causati da una riproduzione
fin troppo fedele del comportamento di Vi. Se si ritiene che altre cose
siano errori "perché Vi si comporta diversamente", si dia prima un'oc-
chiata al file vi_diff.txt (o si immetta :help vi_diff.txt da Vim).
Un'occhiata va data anche alle opzioni 'compatible' e 'cpoptions.
13 giugno 2022 VIM(1)
Generated by dwww version 1.16 on Tue Dec 16 15:15:00 CET 2025.