Go Analyzer - LSP Server

A high-performance Language Server Protocol (LSP) implementation for Go code analysis, written in Rust. Provides real-time variable lifecycle tracking, data race detection, and advanced static analysis capabilities.

Features

🚀 High Performance

• Built in Rust for maximum speed and memory safety
• Asynchronous processing with Tokio runtime
• Incremental parsing with tree-sitter
• Smart caching with automatic cleanup

🔍 Advanced Analysis

• Variable Lifecycle Tracking: Complete variable scope and usage analysis
• Data Race Detection: Intelligent goroutine and concurrency analysis
• Context-Aware Analysis: Support for all Go constructs (structs, interfaces, methods)
• Severity Classification: High/Medium/Low priority race condition detection

Installation

Install the LSP server using Cargo:

cargo install go-analyzer

This will install the go-analyzer binary to your ~/.cargo/bin directory.

Usage

The go-analyzer binary implements the Language Server Protocol and can be used with any LSP-compatible editor.

The server communicates via stdin/stdout using the LSP protocol.

Editor Integration

VS Code

Install the Go Analyzer extension from the marketplace.

Neovim

Emacs (lsp-mode)

Vim (vim-lsp)

LSP Capabilities

The server implements the following LSP features:

• Hover: Detailed variable information with lifecycle data
• Execute Command: Custom analysis commands
  • goanalyzer/cursor: Analyze variable at cursor position
• Text Document Sync: Full document synchronization
• Custom Notifications: Progress updates and indexing status

Configuration

The server accepts the following environment variables:

• GO_ANALYZER_LOG_LEVEL: Set logging level (debug, info, warn, error)
• GO_ANALYZER_CACHE_SIZE: Maximum number of cached AST trees (default: 20)
• GO_ANALYZER_CACHE_TTL: Cache time-to-live in seconds (default: 300)

Architecture

Core Components

• LSP Server: Tower-LSP based server implementation
• Go Parser: Tree-sitter Go grammar for accurate parsing
• Analysis Engine: Variable tracking and race detection algorithms
• Cache System: Intelligent AST caching with TTL and size limits

Analysis Pipeline

1. File Parsing: Go source code → AST via tree-sitter
2. Variable Extraction: Identify declarations, usages, and scopes
3. Race Detection: Analyze goroutine patterns and synchronization
4. Result Generation: Create LSP-compatible analysis results

Performance

• Startup Time: < 100ms typical startup
• Analysis Speed: < 50ms for files up to 2000 lines
• Memory Usage: < 50MB with caching enabled
• CPU Usage: < 5% during active analysis, 0% when idle

Development

Building from Source

git clone https://github.com/vremyavnikuda/go-analyzer-rs.git
cd go-analyzer-rs
cargo build --release

Running Tests

cargo test

Contributing

Contributions are welcome! Please see our GitHub repository for development guidelines.

License

Licensed under the MIT License. See LICENSE for details.

Related Projects

• VS Code Extension - VS Code integration
• tree-sitter-go - Go grammar for tree-sitter

For more information, visit the project repository.