Documentation

Variables d'environnement

Variables d'environnement qui affectent le comportement de Vectron.

Cette page documente les variables d’environnement qui affectent directement Vectron. La composition de l’environnement des processus enfants est configurée dans vectron.toml.

CLI et tracing

Variable	Option équivalente	Valeurs / format	Défaut	Notes
`VECTRON_LOG`	`--log-level`	niveau de tracing	Non défini	Exemples: `trace`, `debug`, `info`.

--trace-subscriber n’a pas de variable d’environnement. Ses valeurs acceptées sont pretty et json, avec pretty par défaut.

Métriques TUI

Ces variables sont lues par vectron start et ont le même sens que les options CLI correspondantes. Les options CLI surchargent les variables d’environnement quand les deux sont fournies.

Variable	Option équivalente	Valeurs / format	Défaut	Notes
`VECTRON_TUI_METRICS`	`--tui-metrics`	`on`, `off`	`on`	Active les métriques CPU/RSS des processus dans la TUI.
`VECTRON_TUI_METRICS_MODE`	`--tui-metrics-mode`	`auto`, `foreground`, `background`, `frozen`	`auto`	Contrôle le comportement des métriques avec le focus terminal.
`VECTRON_TUI_METRICS_INTERVAL`	`--tui-metrics-interval`	durée	`1s`	Intervalle de rafraîchissement partiel au premier plan.
`VECTRON_TUI_METRICS_FULL_SCAN_INTERVAL`	`--tui-metrics-full-scan-interval`	durée	`10s`	Intervalle de scan complet au premier plan.
`VECTRON_TUI_METRICS_BACKGROUND_INTERVAL`	`--tui-metrics-background-interval`	durée	`20s`	Intervalle partiel en arrière-plan quand les événements de focus sont supportés.
`VECTRON_TUI_METRICS_BACKGROUND_FULL_SCAN_INTERVAL`	`--tui-metrics-background-full-scan-interval`	durée	`120s`	Intervalle de scan complet en arrière-plan quand les événements de focus sont supportés.

Les durées utilisent le même parser que le CLI. Exemples: 500ms, 1s, 10s, 120s.

Utilisez vectron doctor --json pour inspecter la configuration terminale et les métriques résolues.

Chemins d’installation des completions shell

vectron completions install utilise ces variables quand --dir est omis.

Variable	Utilisée pour	Défaut / fallback	Notes
`XDG_CONFIG_HOME`	Dossier de base des completions Fish	Fallback vers `~/.config`	Chemin final: `$XDG_CONFIG_HOME/fish/completions`.
`XDG_DATA_HOME`	Dossier de base des completions Bash et Zsh	Fallback vers `~/.local/share`	Chemin Bash: `$XDG_DATA_HOME/bash-completion/completions` ; chemin Zsh: `$XDG_DATA_HOME/zsh/site-functions`.
`HOME`	Résolution du home Unix	Requis quand les variables XDG sont absentes	Utilisé pour résoudre les fallbacks `~`.
`USERPROFILE`	Résolution du home Windows	Utilisé par le resolver de home sur Windows	Présent dans le resolver, mais les cibles principales de développement de Vectron sont macOS et Linux.

Fichiers de complétion par défaut:

Shell	Fichier
Bash	`vectron`
Fish	`vectron.fish`
Zsh	`_vectron`

Environnement des processus enfants

Vectron construit l’environnement de chaque processus enfant dans cet ordre:

environnement parent
global.env
global.env_file
process.env
process.env_file
variables spécifiques à l’instance
variables dérivées par instance_env_suffix

Champs de configuration concernés:

Champ	Effet
`global.env`	Ajoute ou surcharge des variables pour tous les processus.
`global.env_file`	Charge des variables après `global.env`.
`process.env`	Ajoute ou surcharge des variables pour un processus.
`process.env_file`	Charge des variables après `process.env`.
`process.port_env`	Exporte le port alloué de l’instance dans la variable nommée.
`global.instance_env_suffix`	Dérive des noms de variables par instance ; doit contenir `{index}`.
`process.instance_env_suffix`	Surcharge le suffixe global pour un processus ; doit contenir `{index}`.
`global.disable_color_env`	Désactive les variables d’environnement liées aux couleurs ANSI dans les processus enfants.
`process.disable_color_env`	Surcharge le comportement color-env pour un processus.