Dumb Jumpis an Emacs "jump to definition" package with support for multiple programming languages that favors "just working". This means minimal — and ideally zero — configuration with absolutely no stored indexes (TAGS) or persistent background processes.
How it works
Dumb Jump usesThe Silver Searcher
ag (and falls back to
grep ) to find potential definitions of a function or variable under point. It uses a set of regular expressions based on the file extension, or
major-mode , of the current buffer. Currently the
ag matches are run through a shared set of heuristic methods to find the best candidate to jump to. If it can’t decide it will present the user with a list in a pop-menu.
For the currentlysupported languagesit seems to do a good job of finding what you want. If you find a case where it does not work as expected do not hesitate toopen an issue. It can be slow if it needs to use
grep and/or a project is large. Although it can be sped up by installing
ag and/or creating a
.dumbjump file in your project’s root directory with paths that should be excluded (see configuration).
There is currently basic support for the following languages:
- Emacs Lisp
If you have any issues with the existing languages, or you want support for another one, then pleaseopen an issue. PRs are also welcome.
I wanted "jump to definition" functionality to "just work" in emacs. I use IntelliJ for Java and this functionality is basically the only thing I miss when I switch back to emacs for work in other languages. There are certainly other packages that offer this type of functionality, but they all require significantly more configuration and are often limited to a particular language. An alternative may be worth setting up if you are in a specific project or language often (seealternatives).
The recommended way to install Dumb Jump is via
package.el . It’s available on MELPA : M-x
Dumb Jump performs best with The Silver Searcher
ag installed on your system. Please see theirinstall instructions.
(dumb-jump-mode) to your
.emacs will enable the key bindings for two interactive Dumb Jump functions:
dumb-jump-goC-M g core functionality. Attempts to jump to the definition for the thing under point
dumb-jump-backC-M p jumps back to where you were when you jumped. These are chained so if you go down a rabbit hole you can get back out or where you want to be.
dumb-jump-quick-lookC-M q like
dumb-jump-gobut shows tooltip with
Excluding project directories
Dumb Jump will automatically look for a project root. If it’s not finding one then either put a
.dumbjump file in your project root and optionally add excluded directories to make it faster.
-tests -node_modules -build -images +../some-lib/src +/usr/lib/src
(setq dumb-jump-default-project "~/code")to change default project if one is not found (defaults to
(setq dumb-jump-quiet t)if Dumb Jump is too chatty.
- To support more languages and/or definition types use
dumb-jump-find-rules(see source code).
(add-hook 'dumb-jump-after-jump-hook 'some-function)to execute code after you jump
Feedback is very welcome via GitHub issues. I will positively consider supporting other languages either via issue request or PR. If submitting a PR then please add tests as well.
cd /path/to/dumb-jump cask make test
Here is a list of potential alternatives packages for emacs:
- Tags supports multiple languages
- GNU Global supports multiple languages
- elpy for Python
- robe for Ruby
Most of these were sourced from this emacs StackExchange answer .