This VS Code extension supports Syntax Highlighting, Snippets, Completion, Hover, Definition, References, Document Symbol, Call Hierarchy, and Semantic Tokens for Common Lisp.
Beginner's Guide: Overview.
File Types: lisp, lsp, l, cl, asd, asdf, and you can add more by yourself: adding-a-file-extension-to-a-language.
| Kind of Symbols | Color (Dark+) | Color (Light+) |
|---|---|---|
| Macro, Declaration | Blue | Dark Blue |
| Special Operator | Purple | Purple |
| Accessor, Functions, Standard Generic Function | Yellow | Khaki |
| Class, System Class, Type, Condition Type | Green | Dark Green |
| Keyword Package Symbol, Local Variable | Sky Blue | Navy Blue |
| Constant Variable | Light Blue | Blue |
| Special Variable | Red | Brown |
Snippets support: defun, if, cond, let, let*, lambda, etc.
For huge files, in some rare cases, semantic highlighting might lose synchronization when switching files or some large change happens quickly. You only need to type any character in the file to recover.
The language identifier (id) is commonlisp .
If you need to customize your setting only for Common Lisp files, in settings.json, please add something like
"[commonlisp]": {
"editor.bracketPairColorization.enabled": false
}Bracket pair colorization:
- This is enabled by default in VS Code. Bracket pair colorization can be disabled by setting
"editor.bracketPairColorization.enabled": false.
(Thanks to the past contributions of Bracket Pair Colorizer 2 )
Hover tooltip:
- If you find this disturbing, you can disable it in
Editor> Hoveror set a larger delay inEditor> Hover:Delay.
Quick suggestions:
- If you need suggestions while in an active snippet, you can disable
Editor> Suggest:Snippets Prevent Quick Suggestions. - If you need
Snippetsto be on the top of suggestions, you can set"editor.snippetSuggestions": "top".
Semantic highlighting:
- Semantic highlighting can be disabled by setting
"editor.semanticHighlighting.enabled": false.
Also, there are some built-in settings of this extension that can customize more advanced preferences, for example, which language feature provider should be used, which token range should be excluded, and how to deal with the backquote part. See wiki.
Please note that the static analysis currently implemented is experimental and may be incomplete and contain errors, so the result is not compiler-level.
If you need to disable all Programmatic Language Features, that is, only use TextMate-based syntax highlighting, you can set"commonLisp.StaticAnalysis.enabled": falsein this extension's built-in settings (underCommon Lisptab).
Because of the functional features of Common Lisp, we use the intuition of Common Lisp to design syntax highlighting instead of the intuition of non-functional language to design syntax highlighting. That is, we strictly follow the CL-ANSI 1.4.4.14 to classify the 978 external symbols in COMMON-LISP package.
We processed Common Lisp HyperSpec to get the kind of each symbol. The result is in ./assets/COMMON-LISP-symbols.csv, and please feel free to reuse the result :)
We assign different colors to different kinds of symbols, and the assignment rule can be found in the start comment of ./syntaxes/commonlisp.yaml. This file includes comments (related info in CL-ANSI) for all rules.
Please use VS Code 1.72.0 or later for the best performance and profile consistency.
Currently, we use a very simple hand-written parser and combine it with regex to parse the code. Thus, the accuracy, precision, and performance are not good enough. However, we have no plans to complicate the parser further since it is like rebuilding a new wheel (new parser) using TypeScript.
Since this extension is designed as a Web Extension, we are considering using node-tree-sitter as the parser in the future. However, we have no plan to update the parser recently since we are still evaluating its impact on the architecture of VS Code language service (see Anycode).
See Developer Guide.
CL-ANSI Standard Draft, Common Lisp HyperSpec, vscode-scheme, Scheme.tmLanguage, Lisp.tmLanguage, regex101, OSS license from structure101
The icon.png is from Common-Lisp.net and resized.
The commonlisp_file_icon.svg is extracted from the common lisp icon and colored with the purple in Conrad Barski's Logo.
icon.png and commonlisp_file_icon.svg are used under Attribution 4.0 International (CC BY 4.0).
The code segment in Syntax Highlighting is from SBCL Repository.