Unity VContainer – High-Performance DI for Unity

Overview

VContainer is a high-performance IoC container for Unity, providing dependency injection patterns for testable and maintainable code.

Core Topics:

• Constructor and method injection
• Service registration patterns (Singleton, Transient, Scoped)
• LifetimeScope hierarchies
• MonoBehaviour injection
• Factory patterns with DI
• Testing with mocks

Foundation Required: unity-csharp-fundamentals (TryGetComponent, FindAnyObjectByType, null-safe coding)

Learning Path: DI fundamentals → VContainer basics → Advanced patterns → Testing

Quick Start

using VContainer;
using VContainer.Unity;

// Define service interface
public interface IPlayerService
{
    void Initialize();
}

// Implement service
public class PlayerService : IPlayerService
{
    public void Initialize() => Debug.Log("Player initialized");
}

// Setup LifetimeScope
public class GameLifetimeScope : LifetimeScope
{
    protected override void Configure(IContainerBuilder builder)
    {
        builder.Register<IPlayerService, PlayerService>(Lifetime.Singleton);
        builder.RegisterComponentInHierarchy<PlayerController>();
    }
}

// Inject into MonoBehaviour
public class PlayerController : MonoBehaviour
{
    [Inject] private readonly IPlayerService mPlayerService;

    void Start() => mPlayerService.Initialize();
}

Key Concepts

Lifetime Scopes

• Singleton: One instance per container
• Transient: New instance every resolve
• Scoped: One instance per scope

Injection Types

• Constructor Injection: Preferred for required dependencies
• Method Injection: For optional dependencies
• Property/Field Injection: Use [Inject] attribute

Reference Documentation

See VContainer Best Practices for detailed patterns.

Best Practices

1. Register interfaces: Loose coupling and testability
2. Constructor injection first: Explicit dependencies
3. Avoid Service Locator: Don’t resolve in Update loops
4. Test with mocks: Use ContainerBuilder in tests
5. Clear hierarchies: Root → Scene → Local scopes