Programmation
Guide consultable des commandes terminal courantes pour modifier, exécuter, tester et déboguer un projet web.
33 commandes
Navigation
pwd
pwdAffiche le chemin absolu du dossier dans lequel le terminal est actuellement en cours d'exécution.
L'exécuter avant les commandes qui dépendent du fait d'être dans le dossier du projet.
pwdVérifiez quel dossier le terminal utilise actuellement.
Navigation
ls
lsListe les fichiers et les dossiers dans le répertoire actuel.
Utilisez-le pour confirmer la présence des fichiers attendus tels que package.json, src ou next.config.mjs.
lsLister les fichiers dans le dossier de projet actuel.
Navigation
cd
cd ~/projects/my-web-appDéplace le terminal vers un autre dossier.
Utilisez-le avant d'exécuter des commandes spécifiques au projet, telles que npm run build.
Une commande peut échouer si vous êtes dans le mauvais répertoire, même si la commande elle-même est correcte.
cd ~/projects/my-web-appAller dans le dossier du projet avant d'exécuter les commandes.
Navigation
clear
clearEfface la sortie visible du terminal sans modifier les fichiers ni l'historique des commandes.
Utilisez-le avant de relancer une commande lorsque la sortie précédente est visuellement bruyante.
clearEffacer le terminal avant de relancer la compilation.
Fichiers et dossiers
cat
cat package.jsonAffiche le contenu d'un fichier dans le terminal.
Utilisez-le pour les petits fichiers tels que package.json, les fichiers de configuration ou les petits fichiers texte.
Pour les fichiers très volumineux, préférez sed, rg ou un pager plutôt que d'imprimer tout.
cat package.jsonAfficher les scripts du package.json.
Fichiers et dossiers
sed
sed -n '1,120p' src/components/SiteHeader.tsxPeut imprimer une plage de lignes sélectionnée à partir d'un fichier.
Utilisez-le pour examiner une section d'un fichier source sans ouvrir tout le fichier.
sed -n '1,120p' src/components/SiteHeader.tsxAfficher les 120 premières lignes de SiteHeader.tsx.
Fichiers et dossiers
mkdir
mkdir -p src/app/[locale]/reference/terminal-commandsCrée un nouveau dossier. L'option -p crée également les dossiers parents manquants et évite les erreurs si le dossier existe déjà.
Utilisez-le avant d'ajouter un nouveau dossier de page ou un nouveau dossier d'assets.
mkdir -p src/app/[locale]/reference/terminal-commandsCréer le dossier de route pour la page des commandes du terminal.
Fichiers et dossiers
cp
cp .env.example .env.localCopie d'un fichier ou d'un dossier vers un autre emplacement.
Utilisez-le pour créer une configuration locale à partir d'un fichier d'exemple ou dupliquer un modèle.
Si le fichier de destination existe, cp peut l'écraser.
cp .env.example .env.localCopier le fichier env d'exemple uniquement si cela n'écrasera pas les paramètres locaux.
Fichiers et dossiers
mv
mv old-name.ts new-name.tsDéplace un fichier ou un dossier, ou le renomme si la destination se trouve dans le même dossier.
Utilisez-le lorsque vous modifiez un nom de fichier, un nom de dossier ou que vous déplacez des ressources.
Le renommage des dossiers de routage modifie les URL.
mv old-name.ts new-name.tsRenommer ce fichier et mettre à jour les importations si nécessaire.
Sécurité
rm
rm unused-file.tsSupprime les fichiers. Avec -r, il peut supprimer les dossiers de manière récursive.
Utilisez-le uniquement lorsqu'un fichier est intentionnellement supprimé du projet.
rm is destructive. Check the path carefully before running it.
rm unused-file.tsAvant de supprimer ce fichier, expliquez ce qui sera supprimé.
Recherche et inspection
rg
rg -n "errorMessageGuide" srcRechercher rapidement du texte dans les fichiers.
Utilisez-le pour trouver les importations, les composants, les slugs, les classes CSS ou les anciens noms avant de modifier.
rg -n "errorMessageGuide" srcRechercher où ce composant est importé.
Recherche et inspection
rg --files
rg --files src/appListe rapidement les chemins de fichiers, en respectant les règles d'exclusion courantes.
Utilisez-le pour trouver les fichiers de page, les composants et les bibliothèques sans analyser la sortie de la compilation.
rg --files src/appLister les fichiers de page de référence sous src/app.
Recherche et inspection
find
find src -name 'page.tsx'Rechercher dans le système de fichiers par chemin, nom ou autres propriétés de fichier.
Utilisez-le lorsque vous recherchez par motif de nom de fichier plutôt que par contenu textuel.
find src -name 'page.tsx'Rechercher tous les fichiers de route page.tsx.
Recherche et inspection
wc
wc -l src/lib/terminal-commands.tsCompte les lignes, les mots ou les octets.
Utilisez-le pour estimer la taille des fichiers ou le nombre de résultats de recherche lorsqu'il est combiné avec d'autres commandes.
wc -l src/lib/terminal-commands.tsCompter le nombre de lignes dans ce fichier de données.
Paquets
npm install
npm installInstalle les packages listés dans package.json et package-lock.json.
Utilisez-le après avoir cloné un projet ou lorsque les dépendances sont manquantes.
Cela peut modifier package-lock.json si les versions des dépendances sont résolues différemment.
npm installInstallez les dépendances uniquement si node_modules est manquant.
Serveur dev
npm run dev
npm run devExécute le script de serveur de développement local du projet.
Utilisez-le pour tester les pages dans le navigateur tout en les modifiant.
Un serveur de développement en cours d'exécution maintient la session du terminal active jusqu'à ce qu'elle soit arrêtée.
npm run devDémarrer le serveur de développement et me donner l'URL locale.
Paquets
npm run build
npm run buildExécute le script de construction de production et détecte de nombreux problèmes de compilation, de routage et de type.
L'exécuter avant le déploiement ou après l'ajout de nouvelles pages.
npm run buildExécuter la construction de production et résumer les avertissements ou les échecs.
Paquets
npm run lint
npm run lintExécute le script de lint du projet pour détecter les problèmes de style et de code statique.
L'exécuter avant la construction lorsque vous souhaitez obtenir un retour d'information rapide.
npm run lintExécuter lint et afficher uniquement les erreurs qui peuvent être corrigées.
Paquets
node -v
node -vAffiche la version de Node.js installée.
Utilisez-le lorsqu'un projet nécessite une version spécifique de Node.
node -vVérifier la version de Node.js avant d'expliquer cet avertissement.
Paquets
npx
npx next infoExécute une commande provenant d'un package npm installé ou temporairement téléchargé.
Utilisez-le pour les commandes d'outils ponctuels lorsque aucun script de package n'existe.
npx can download packages from the network if they are not installed.
npx next infoExpliquez si cette commande npx nécessite un accès réseau.
Git
git status
git status --shortMontre la branche actuelle et les fichiers modifiés, préparés ou non suivis.
L'exécuter avant les modifications, les validations, les récupérations ou les changements de branche.
git status --shortVérifier l'état de Git et résumer les fichiers modifiés.
Git
git diff
git diff -- src/components/SiteHeader.tsxMontre les différences ligne par ligne dans les fichiers modifiés.
Utilisez-le pour vérifier exactement ce qui a changé avant de valider les modifications.
git diff -- src/components/SiteHeader.tsxExaminer les modifications apportées à cette tâche.
Git
git log
git log --oneline -5Montre l'historique des commits.
Utilisez-le pour consulter les travaux récents ou trouver un commit à examiner.
git log --oneline -5Afficher les cinq commits les plus récents.
Git
git add
git add src/lib/terminal-commands.tsSélectionne les modifications à inclure dans le prochain commit.
Utilisez des chemins explicites pour les commits ciblés.
git add src/lib/terminal-commands.tsAjouter uniquement les fichiers liés à cette page de commandes de terminal.
Git
git commit
git commit -m "Add terminal command reference"Les modifications préparatoires sont enregistrées dans l'historique Git.
Utilisez-le après avoir examiné les modifications préparées.
git commit -m "Add terminal command reference"Valider les modifications préparées avec un message clair.
Serveur dev
Ctrl+C
Appuyez sur Ctrl+C dans le terminal du serveur de développement.Interrompt la commande de terminal en cours d'exécution.
Utilisez-le pour arrêter un serveur de développement local avant de fermer le terminal ou de modifier les ports.
Utilisez-le dans la session du terminal où la commande est exécutée.
Appuyez sur Ctrl+C dans le terminal du serveur de développement.Arrêter le serveur de développement en cours d'exécution.
Serveur dev
lsof
lsof -i :3001Peut afficher quel processus utilise un port.
Utilisez-le lorsqu'un serveur de développement échoue avec EADDRINUSE.
lsof -i :3001Rechercher quel processus utilise le port 3001.
Serveur dev
ps
ps auxAffiche les processus en cours d'exécution.
Utilisez-le pour examiner les outils de développement, les serveurs ou les processus en arrière-plan en cours d'exécution.
ps auxVérifiez si un serveur de développement Next.js est toujours en cours d'exécution.
Sécurité
kill
kill 12345Envoie un signal pour arrêter un processus en utilisant son ID.
Utilisez-le lorsqu'un serveur continue de fonctionner après qu'une interruption normale n'est plus disponible.
Vérifier attentivement le PID pour ne pas arrêter le mauvais processus.
kill 12345Avant de tuer un processus, montrez-moi à quoi appartient le PID.
Réseau
curl
curl -I http://localhost:3001/koEnvoie des requêtes HTTP depuis le terminal et affiche la réponse.
Utilisez-le pour vérifier si une URL locale ou déployée renvoie 200, 404, 500 ou des redirections.
curl -I http://localhost:3001/koUtilisez curl pour vérifier si cette page renvoie 200.
Réseau
ping
ping 172.30.1.55Vérifie si un hôte répond aux paquets réseau de base.
Utilisez-le comme une vérification approximative de la connectivité réseau, et non comme une vérification de l'état d'une application web.
ping 172.30.1.55Vérifiez si cet appareil peut accéder à l'adresse IP de la machine de développement.
Recherche et inspection
which
which nodeIndique quel fichier exécutable sera utilisé pour un nom de commande.
Utilisez-le lorsque différentes versions de Node, npm ou d'outils peuvent exister sur la machine.
which nodeVérifiez quel exécutable Node est utilisé.
Sécurité
chmod
chmod +x script.shModifie les permissions de lecture, d'écriture ou d'exécution sur les fichiers.
Utilisez-le lorsqu'un script local doit être exécutable.
Évitez les modifications d'autorisations générales telles que chmod -R 777.
chmod +x script.shExpliquer le changement d'autorisation le plus sûr pour ce script.