.replit et replit.nix. Ils affectent le comportement de votre application Replit, de l’exécution du code aux outils de développement et aux langages.
Ces fichiers de configuration sont masqués par défaut. Affichez-les dans votre application Replit en sélectionnant « Afficher les fichiers cachés » dans le menu de l’arborescence de fichiers.

Fichier replit.nix
Replit utilise Nix pour gérer les packages et les environnements. Le fichier replit.nix est utilisé pour :
Spécifier les dépendances système : Définissez exactement quels packages logiciels votre application Replit requiert, gérés via Nix, un gestionnaire de packages.
Créer des environnements reproductibles : Assurez-vous que votre environnement de développement est cohérent et reproductible, idéal pour les projets collaboratifs et les tests sur plusieurs systèmes.
Vous pouvez gérer les packages Nix visuellement via l’outil Dépendances. En savoir plus dans le guide des Dépendances système.
Pour configurer les packages avec le fichier replit.nix, vous pouvez lister les packages Nix dans le tableau deps, préfixés par pkgs.. Toute modification sera synchronisée après le rechargement de votre shell.
Fichier .replit
Le fichier .replit contrôle le comportement de votre application Replit. Il utilise le format de configuration toml. Voici quelques-uns des aspects clés qui peuvent être configurés :
Commande d’exécution : Spécifiez la commande qui s’exécute lorsque le bouton Exécuter est sélectionné. Chaque modèle dispose d’une commande d’exécution par défaut pour permettre l’exécution immédiate du code. Pour des applications plus personnalisées et complexes, utilisez des Workflows.
Language Server Protocol (LSP) : Fournit des fonctionnalités telles que l’auto-complétion, la navigation dans le code, la coloration syntaxique et le linting en temps réel avec signalement des erreurs.
Variables d’environnement : Définissez et gérez les variables d’environnement essentielles au bon fonctionnement de vos applications.
Dépendances et packages : Gérez les installations de packages et les configurations directement via le fichier .replit, en vous assurant que votre application Replit dispose de tous les outils nécessaires dès le démarrage. Vous pouvez gérer les dépendances visuellement via l’outil Dépendances. En savoir plus dans le guide des Modules système.
Pour les applications Python, le fichier .replit par défaut ressemble à :
.replit, expliquant ce que fait chaque configuration et son impact sur l’environnement de l’application Replit.
Maintenant que vous avez une idée des configurations par défaut du fichier
.replit, utilisez les sections suivantes pour comprendre comment configurer les paramètres de base et avancés de votre application Replit.
Configuration des paramètres de base
Point d’entrée
Il s’agit du fichier principal de votre projet. Si vous ne définissez pas de propriétérun, le fichier entrypoint est celui qui sera exécuté par le runtime.
Commande Run
La propriété run dans le fichier .replit est une fonctionnalité clé qui détermine la commande initiale ou la série de commandes exécutées lorsque le bouton Exécuter est sélectionné dans un environnement Replit. La commande Run peut être spécifiée soit comme une chaîne représentant la commande à exécuter, soit comme un tableau de chaînes représentant la commande et ses arguments individuels.
Quelques façons courantes de configurer la commande Run :
-
Commande unique :
Cet exemple montre comment passer une seule commande à exécuter directement dans l’application Replit. Avec ceci dans votre fichier
.replit, appuyer sur le boutonExécuteraffichera un message d’accueil dans le panneauConsole: Exemple :run = "echo 'Hello, Replit!'" -
Arguments explicites :
Dans certaines situations, il peut être avantageux d’être plus explicite, évitant ainsi la nécessité d’analyser les guillemets ou les règles d’interpolation du shell. Vous pouvez réécrire l’exemple ci-dessus pour séparer les arguments.
Notez que vous n’avez plus besoin des deux
'et", puisque vous passez explicitement le message d’accueil comme premier et unique argument àecho: Exemple :run = ["echo", "Hello, Replit!"] -
Commandes multiples :
Cet exemple montre comment exécuter plusieurs processus simultanément, comme un frontend et un backend. Cela peut être utile si vous développez un backend Python et un frontend TypeScript, où chaque serveur se lie à un port différent :
Exemple :
run = "python -m app & npm run start & wait"
Gestion des processus
Bien que plusieurs commandes puissent être exécutées simultanément avec&, vous pouvez vouloir une meilleure expérience pour distinguer les journaux entre les services. Vous pouvez ajouter des dépendances système comme process-compose pour mieux orchestrer plusieurs processus.
Phase Build
Pour certains langages ou runtimes, il existe une phase de compilation séparée avant que le code puisse être exécuté. Cela concerne à la fois les langages compilés comme TypeScript, Golang ou Java, ou propose un paramètre que vous pouvez utiliser pour réinitialiser votre environnement, vos données ou votre configuration avant que la prochaine exécution run ne soit invoquée.
- Compilation :
Dans un dépôt TypeScript, vous pourriez avoir besoin d’exécuter
tscavant d’exécuter votre code. Exemple :
Inclure des variables d’environnement
Pour fournir des variables d’environnement à votre service avant l’exécution, vous pouvez étendre la propriétérun en une table.
Il s’agit d’une modification plus complexe, qui nécessite probablement de déplacer l’emplacement de votre propriété run = "..." dans votre fichier .replit.
La diff suivante montre comment fournir la commande via args de [run], ainsi que la variable NAME fournie dans [run.env] :
Interactivité
Les programmes interactifs peuvent également être lancés via le boutonExécuter, offrant un moyen de distinguer votre environnement de développement du terminal où votre programme s’exécute.
Considérez le script de comptage suivant :
Exemple
Options de configuration avancées
Explorez les options de configuration détaillées disponibles pour votre application Replit. Vous pouvez personnaliser votre environnement de développement, gérer les commandes d’exécution, intégrer des services de langage et gérer les dépendances.Remarques sur l’audio système
Lorsque vous définissezaudio = true dans votre fichier .replit, vous devrez peut-être redémarrer l’environnement de développement. Ouvrez la palette de commandes avec Cmd+K (Mac) ou Ctrl+K (Windows), recherchez Restart compute, puis sélectionnez-la.
Lors de l’exécution d’une application graphique, vous verrez une paire d’écouteurs avec une case à cocher dans le coin inférieur droit du panneau Sortie.
En raison des restrictions du navigateur, cela devra être activé à chaque actualisation.
Configuration du packager
Exemple de configuration .replit pour la configuration du packager
Configuration du déploiement
Exemple de configuration .replit pour la configuration du déploiement
La configuration de l’interpréteur a été dépréciée et n’est plus disponible dans Replit. Au lieu de cela, vous êtes encouragé à utiliser les commandes
Run pour configurer la façon dont les scripts et les applications sont exécutés dans votre environnement d’application Replit.Configuration des ports
Exemple de fichier de configuration .replit pour la gestion des ports
Accéder aux métadonnées de l’environnement de l’application Replit
Node.js
Pour accéder à toutes les variables d’environnement :console.log(process.env);
Pour accéder à une seule variable (REPL_SLUG) :
console.log(process.env.REPL_SLUG);