Fixing the Eclipse Index

One of the greatest features in Eclipse is the Indexer: it parses automatically my code in the background. It creates all the needed information so I can browse around my sources. I can use the Open Declaration context menu in the source code:

Open Declaration Context Menu

Open Declaration Context Menu

Another way is to click into the variable/include/etc and press the F3 key. Or to hold the CTRL key pressed and hover over it with the cursor to hyperlink it:

Hyperlinking with the CTRL key pressed

Hyperlinking with the CTRL key pressed

The Indexer knows as well my macros and grays out things if not active or disabled. But sometimes things simply look wrong: I know that my macro is enabled, but the editor still shows it grayed out?

Wrong Indexer? Macro block igrayed out.....

Wrong Indexer? Macro block grayed out…..

I’m sure that I have defined PL_HAS_TEMPERATURE in my header file, and I properly have included it. Still eclipse thinks it is not defined or not set to one?

One first thing I try is to rebuild the index. For this I select the project and select the menu Index > Rebuild:

Rebuilding the Index

Rebuilding the Index

This usually fixes things for me.

If not, then there is a problem with the project or workspace settings for the Indexer: the project settings for the Indexer are accessible in the project properties. The workspace settings are found in Window > Preferences > C/C++ > Indexer:

Indexer settings with disabled heuristics and using active build configuration

Indexer settings with disabled heuristics and using active build configuration

What I have found out is that ‘Allow heuristic resolution of includes‘ is causing inaccurate results. As in my example above,the indexer is not correctly using the includes if heuristics are enabled. The solutions is to disable heuristics.

The other setting is for the active build configuration: I make sure I have ‘Use active build configuration‘ enabled. That way the Indexer is switching the data base based on the build configuration too.

With these options the result is now correct:

Fixed Indexer: showing macro correctly

Fixed Indexer: showing macro correctly

Happy Indexing 🙂

22 thoughts on “Fixing the Eclipse Index

  1. Pingback: Eclipse Editor Scalability | MCU on Eclipse

  2. Pingback: Compiler Defines and Eclipse Editor Highlighting | MCU on Eclipse

  3. Pingback: Top 10 Customization of Eclipse Settings | MCU on Eclipse

  4. Nice, that didn’t solve my problem but it pointed me in the right direction. I was seeing a lot of my symbols not showing up as being indexed. Some of my class types would be green and some would stay black.

    Increase the Cache Limits in the same window as listed in the article. We have a rather large C++ project that was exceeding the cache limit.


    • ah, that might explain a similar problem I had: I used to rebuild the index to solve it. I have many projects in my workspace, some with shared folders and linked files. It looks like increasing the cache limits solved that problem 🙂


  5. Dude, how can I thank you more!!
    The solution actually worked for an issue that had been in the back of my head bothering me all the time!


  6. Thank you for taking the time to post, you have solved an issue i have had for 8 years!

    Turning of “Allow heuristic resolution of includes” fixes my issues with greyed out #ifdef areas which has being a constant point of stress with this IDE.


  7. > The other setting is for the active build configuration: I make sure I have ‘Use active build configuration‘ enabled.

    This setting doesn’t seem to get exported using File > Export > General > Preferences…



      • OK – thanks. I’m still on Kepler SR2 but will try Luna when I get a chance.

        (I hope the following isn’t too off topic….?)

        More generally I’m having problems getting imported epf file settings taking effect. I presume that no editing of the exported epf file (e.g. to remove the leading “/instance”) is needed unlike when putting the settings into, say, plugin_customization.ini?

        Also (and maybe this is already well known) it seems pretty hit and miss which settings exported to an epf file can be edited and then applied via plugin_customization.ini and which seem to be ignored.

        E.g. I’d like to set a PATH env var but org.eclipse.cdt.core/environment/workspace/PATH/value= in plugin_customization.ini doesn’t take effect for some reason.

        Similarly I’d like to override and disable the GNU ARM Eclipse OpenOCD debug pre run reset setting but ilg.gnuarmeclipse.debug.gdbjtag.openocd/gdb.openocd.doPreRunReset=false in plugin_customization.ini doesn’t take effect.

        Any advice/suggested reading as it seems difficult to find authoritative and comprehensive info about this stuff.

        Thanks a lot.


  8. Thanks a lot! It was really driving me crazy to edit active code in grayed area where no suggestion was available. This solved it.


  9. More great stuff. With this and your “Refresh Policy” build fix, you’ve converted my Eclipse from a blithering idiot to a valuable team member. (Before I made the indexing changes you suggest, I had projects go from zero errors to 1000+ errors with no changes to the source code. I was spending more time fiddling with the indexing than writing / testing / debugging the code. The situation was made worse by the fact that switching off the indexing did not get rid of the listed errors / red source code annotations, even after restarting the IDE and opening and closing the affected projects). Eclipse is now actually pleasurable to use rather than painful. I think my blood pressure is beginning to return to normal…

    Eclipse has got a bad reputation and quite frankly, with such problems, it deserves it. Yet it’s also very close to being very good indeed.

    Thanks again!



    • Yes, these small things indeed are very painful. The good thing is knowing these small fixes, with everyone else in the industry using Eclipse: that knowledge can be applied to all these different tool vendor IDE’s based on Eclipse. It is a shame that somehow the Eclipse developer community is paying so little attention to all these small (but important) things.
      Glad to know that this article was helpful to one more developer struggling with it 🙂


  10. Pingback: Hiding Inactive Code In Eclipse | MCU on Eclipse

  11. Pingback: Different Ways of Software Configuration | MCU on Eclipse

  12. Pingback: Building and Flashing ESP32 Applications with Eclipse | MCU on Eclipse

  13. Pingback: Eclipse Gems, Tips & Tricks: Open Declaration | MCU on Eclipse

  14. Pingback: FreeRTOS and Eclipse Indexer for >5K Lines Source Files | MCU on Eclipse

  15. Pingback: Eclipse Indexer Debug Tips | MCU on Eclipse

What do you think?

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

This site uses Akismet to reduce spam. Learn how your comment data is processed.