I don't know of a way to change the color scheme of SPL syntax highlighting, but I tend to insert blank lines (Shift + Enter) to format my searches readable. You could do the same with your comments, could look like this:
| eval stuff = bar
| lookup baz source
`comment("explicit lookup to avoid something for some reason")`
| table stuff source ...