GoSublime is a Golang plugin collection for the text editor SublimeText 2 providing code completion and other IDE-like features.
- code completion from Gocode
- context aware snippets via the code-completion popup to complement the existing SublimeText Go package.
- sublime build system(ctrl+b) allowing to run any command your shell will accept with some focus(and enhancements) on the
gocommand including support for cycling errors with F4/Shift+F4
- lint/syntax check as you type
- quickly to any syntax error reported (and jump back to where you were before (across files))
- quickly fmt your source or automatically on save to conform with the Go standards
- easily create a new go file and run it without needing to save it first (go play)
- share your snippets(anything in the loaded file) on play.golang.org
- list declarations in the current file
- automtically add/remove package imports
- quickly jump your import section(automatically goes to the last import) where you can easily edit the pkg alias and return to where you were before
- go to definition of a package function or constant, etc.
- show the source(and thus documentation) of a variable without needing change views
MarGo & Gocode
Some features such as goto definition, fmt, package imports, etc. are provided by MarGo. Most of the code completion(non-snippet) is provided by Gocode Gocode.
It's therefore recommended to allow GoSublime to install MarGo and Gocode.
If either of MarGo or Gocode cannot be found, you will be prompted to install it.
This is an automated install done with
go get. You can always run this command manually from the
ctrl+shift+p and typing
If this doesn't work, or other errors are reported, please discuss it here: https://github.com/DisposaBoy/GoSublime/issues/44.
New demos will be uploaded to http://www.youtube.com/user/GoSublime/videos
Sublime Package Control allows you to easily install or remove GoSublime(and many other ST2 packages) from within the editor. It offers automatically updating packages as well so you no longer need to keep track of changes in GoSublime.
Install Sublime Package Control (if you haven't done so already) from http://wbond.net/sublime_packages/package_control . Be sure to restart ST2 to complete the installation.
Bring up the command palette (default
cmd+shift+p) and start typing
Package Control: Install Packagethen press return or click on that option to activate it. You will be presented with a new Quick Panel with the list of available packages. Type
GoSublimeand press return or on its entry to install GoSublime. If there is no entry for GoSublime, you most likely already have it installed.
Please see USAGE.md for general usage and other tips for effective usage of GoSublime
You can customize the behaviour of GoSublime by creating a settings file in your
User package. This can be accessed from within SublimeText by going to the menu
Preferences > Browse Packages.... Create a file named
GoSublime.sublime-settings or alternatively copy the default settings file
Packages/GoSublime/GoSublime.sublime-settings to your
User package and edit it to your liking.
Note: Filenames are case-sensitive on some platforms(e.g. Linux) so the filename should be exactly
GoSublime.sublime-settings with capitalization preserved.
The following letters are used as suffix for entries in the completion list.
ʂ - Snippets. These snippets are provided by GoSublime and should not be confused with SublimeText's snippets. Furthermore, they are context sensitive, therefore the snippets provided in the global scope will be different to those provided in function scope.
ν - Variables
ʈ - User-defined types, structs, maps, slices, etc.
Ɩ - Constants
ƒ - Functions
ρ - Packages