mirror of
https://github.com/golang/go
synced 2024-11-14 14:40:23 -07:00
6be21b9f02
The vi bundled with OS X has a weird bug in that if you turn off filetype in .vimrc when it's not turned on, even a clean exit of vi will return 1 which breaks almost everything. While we're at it, add hint to change $GOROOT to its actual value in .vimrc. Fixes #7865. LGTM=robert.hencke, dsymonds R=golang-codereviews, robert.hencke, gobot, dsymonds CC=golang-codereviews https://golang.org/cl/96800046
104 lines
3.3 KiB
Plaintext
104 lines
3.3 KiB
Plaintext
Vim plugins for Go (http://golang.org)
|
|
======================================
|
|
|
|
To use all the Vim plugins, add these lines to your $HOME/.vimrc.
|
|
|
|
" Some Linux distributions set filetype in /etc/vimrc.
|
|
" Clear filetype flags before changing runtimepath to force Vim to reload them.
|
|
if exists("g:did_load_filetypes")
|
|
filetype off
|
|
filetype plugin indent off
|
|
endif
|
|
set runtimepath+=$GOROOT/misc/vim " replace $GOROOT with the output of: go env GOROOT
|
|
filetype plugin indent on
|
|
syntax on
|
|
|
|
If you want to select fewer plugins, use the instructions in the rest of
|
|
this file.
|
|
|
|
A popular configuration is to gofmt Go source files when they are saved.
|
|
To do that, add this line to the end of your $HOME/.vimrc.
|
|
|
|
autocmd FileType go autocmd BufWritePre <buffer> Fmt
|
|
|
|
|
|
Vim syntax highlighting
|
|
-----------------------
|
|
|
|
To install automatic syntax highlighting for GO programs:
|
|
|
|
1. Copy or link the filetype detection script to the ftdetect directory
|
|
underneath your vim runtime directory (normally $HOME/.vim/ftdetect)
|
|
2. Copy or link syntax/go.vim to the syntax directory underneath your vim
|
|
runtime directory (normally $HOME/.vim/syntax). Linking this file rather
|
|
than just copying it will ensure any changes are automatically reflected
|
|
in your syntax highlighting.
|
|
3. Add the following line to your .vimrc file (normally $HOME/.vimrc):
|
|
|
|
syntax on
|
|
|
|
In a typical unix environment you might accomplish this using the following
|
|
commands:
|
|
|
|
mkdir -p $HOME/.vim/ftdetect
|
|
mkdir -p $HOME/.vim/syntax
|
|
mkdir -p $HOME/.vim/autoload/go
|
|
ln -s $GOROOT/misc/vim/ftdetect/gofiletype.vim $HOME/.vim/ftdetect/
|
|
ln -s $GOROOT/misc/vim/syntax/go.vim $HOME/.vim/syntax
|
|
ln -s $GOROOT/misc/vim/autoload/go/complete.vim $HOME/.vim/autoload/go
|
|
echo "syntax on" >> $HOME/.vimrc
|
|
|
|
|
|
Vim filetype plugins
|
|
--------------------
|
|
|
|
To install one of the available filetype plugins:
|
|
|
|
1. Same as 1 above.
|
|
2. Copy or link ftplugin/go.vim to the ftplugin directory underneath your vim
|
|
runtime directory (normally $HOME/.vim/ftplugin). Copy or link one or more
|
|
additional plugins from ftplugin/go/*.vim to the Go-specific subdirectory
|
|
in the same place ($HOME/.vim/ftplugin/go/*.vim).
|
|
3. Add the following line to your .vimrc file (normally $HOME/.vimrc):
|
|
|
|
filetype plugin on
|
|
|
|
|
|
Vim indentation plugin
|
|
----------------------
|
|
|
|
To install automatic indentation:
|
|
|
|
1. Same as 1 above.
|
|
2. Copy or link indent/go.vim to the indent directory underneath your vim
|
|
runtime directory (normally $HOME/.vim/indent).
|
|
3. Add the following line to your .vimrc file (normally $HOME/.vimrc):
|
|
|
|
filetype indent on
|
|
|
|
|
|
Vim compiler plugin
|
|
-------------------
|
|
|
|
To install the compiler plugin:
|
|
|
|
1. Same as 1 above.
|
|
2. Copy or link compiler/go.vim to the compiler directory underneath your vim
|
|
runtime directory (normally $HOME/.vim/compiler).
|
|
3. Activate the compiler plugin with ":compiler go". To always enable the
|
|
compiler plugin in Go source files add an autocommand to your .vimrc file
|
|
(normally $HOME/.vimrc):
|
|
|
|
autocmd FileType go compiler go
|
|
|
|
|
|
Godoc plugin
|
|
------------
|
|
|
|
To install godoc plugin:
|
|
|
|
1. Same as 1 above.
|
|
2. Copy or link plugin/godoc.vim to $HOME/.vim/plugin/godoc,
|
|
syntax/godoc.vim to $HOME/.vim/syntax/godoc.vim,
|
|
and autoload/go/complete.vim to $HOME/.vim/autoload/go/complete.vim.
|