Premier script Python, partir simple et apprendre sans se perdre

Un premier script Python ne devrait pas commencer par une avalanche d’outils, d’extensions et de concepts abstraits. Le vrai départ, c’est un fichier que vous comprenez, une commande que vous lancez vous-même, puis un résultat visible dans le terminal. Si cette boucle est claire, le reste devient beaucoup moins intimidant.

Le but n’est pas d’écrire “le bon programme” du premier coup. Le but est d’apprendre le cycle de base : écrire, exécuter, lire ce qui se passe, corriger, relancer. C’est cette mécanique qui transforme Python en langage accessible, pas seulement sa syntaxe réputée simple.

Le bon objectif pour un tout premier script

Un premier script doit faire une chose simple et observable. Afficher un message, demander un prénom, calculer une petite valeur ou transformer une phrase suffit largement. Si vous essayez dès le départ de créer une application complète, vous mélangez la syntaxe, le terminal, les fichiers, les bibliothèques et la logique métier, alors que votre vrai apprentissage porte encore sur l’exécution d’un fichier.

Choisissez plutôt un script qui tient en quelques lignes. Vous devez pouvoir expliquer chaque ligne à voix haute. Cette contrainte paraît scolaire, mais elle évite la copie passive. Un débutant progresse plus vite quand il sait pourquoi le fichier s’appelle script.py, pourquoi il se lance avec python ou python3, et où le résultat doit apparaître.

Commencez petit, sans confondre simplicité et inutilité. Un programme vraiment utile viendra après, quand vous saurez déjà lancer et corriger un fichier.

Installer Python sans perdre une heure dans la configuration

Avant d’écrire du code, vérifiez que l’interpréteur répond. C’est le socle du reste.

La première vérification est simple : Python doit répondre dans le terminal. Sur Windows, macOS ou Linux, installez une version récente depuis le site officiel ou via le gestionnaire recommandé par votre système. Ensuite, ouvrez un terminal et testez la commande. Selon votre machine, elle peut être python, python3 ou passer par un lanceur comme py sur Windows.

Ne passez pas trop vite cette étape. Si le terminal ne trouve pas Python, votre script peut être correct et pourtant impossible à lancer. Le problème vient alors du chemin, de l’installation ou de la commande utilisée, pas de votre code. C’est une distinction importante pour ne pas corriger le mauvais sujet.

Une installation saine se vérifie avant d’ouvrir l’éditeur. C’est moins séduisant qu’un nouvel outil, mais beaucoup plus rentable.

python --version
python3 --version
py --version

Une seule de ces commandes peut suffire selon votre environnement. Gardez celle qui affiche une version Python 3 récente, puis utilisez-la de manière cohérente dans la suite.

Créer le fichier .py et écrire les premières lignes

Créez un dossier dédié, par exemple “premier-script-python”. Dans ce dossier, créez un fichier nommé bonjour.py. L’extension .py indique qu’il s’agit d’un fichier Python. Évitez les noms ambigus comme “test.py” si vous comptez ensuite importer des modules, et évitez les espaces dans le nom du fichier au début.

Écrivez ensuite un programme volontairement simple. Il demande un prénom, construit un message et l’affiche. Trois lignes suffisent à montrer les variables, l’entrée utilisateur et la sortie terminal.

prenom = input("Comment tu t'appelles ? ")
message = "Bonjour " + prenom
print(message)

Ce code n’est pas spectaculaire, mais il est parfait pour démarrer. La variable prenom garde la réponse. La variable message assemble le texte. La fonction print() affiche le résultat.

Vous avez déjà un vrai script. Il tient en trois lignes, mais il possède une entrée, une transformation et une sortie.

Lancer le script depuis le terminal

Ouvrez le terminal dans le dossier du fichier. C’est souvent l’étape qui crée le plus de confusion : le terminal exécute une commande depuis un emplacement précis. Si vous êtes dans le mauvais dossier, Python ne trouve pas le fichier. Ce n’est pas une erreur de programmation, c’est un problème de chemin.

La commande dépend de votre installation. Si votre vérification affichait une version avec “python”, utilisez cette commande. Si c’était “python3”, adaptez. L’important est de garder la même logique.

python bonjour.py

# ou selon votre système
python3 bonjour.py
py bonjour.py

Le programme doit vous poser la question, attendre votre réponse, puis afficher le message. Ce moment est important : vous venez de passer d’un texte dans un fichier à un programme exécuté. C’est la frontière à comprendre avant d’empiler des bibliothèques.

Pour approfondir ce point, consultez Détourer une image en ligne gratuitement sans, qui traite plus précisément de détourer une image en ligne gratuitement sans perdre en qualité.

Organiser le dossier pour ne pas vous perdre

Le rangement du projet fait partie du code. Il détermine ce que Python peut trouver.

Un script débutant mérite un dossier propre. Ce conseil semble secondaire, pourtant il évite une grande partie des confusions : fichier introuvable, images ou CSV mal placés, commandes lancées depuis le mauvais répertoire, ancien script modifié au lieu du nouveau. Dès le départ, donnez à chaque exercice un dossier dédié.

Dans ce dossier, gardez peu de fichiers. Un fichier principal, éventuellement un fichier de données, puis un fichier de notes si vous voulez garder vos commandes. Évitez de disperser les scripts sur le Bureau, dans Téléchargements et dans Documents. Python sait lire des fichiers, mais il ne devine pas votre rangement.

Un dossier clair rend les erreurs plus faciles à expliquer et à reproduire. Ce n’est pas du rangement cosmétique.

premier-script-python/
  bonjour.py
  notes.txt
  donnees.txt

Cette organisation prépare aussi la suite. Quand vous apprendrez les modules, les tests ou les environnements virtuels, vous aurez déjà le réflexe de travailler par projet. C’est une habitude professionnelle, même pour un petit exercice. Elle vous oblige aussi à distinguer le code, les données, les notes et les essais, ce qui devient décisif dès que le script lit ou écrit un fichier.

Comprendre une erreur sans paniquer

Les erreurs Python sont bavardes, et c’est une bonne nouvelle. Elles indiquent souvent le fichier, la ligne et le type de problème. Au début, ne cherchez pas à tout comprendre ni à traduire toute la pile d’appel. Cherchez d’abord la ligne concernée, puis le dernier message de l’erreur. C’est généralement là que se trouve le signal principal, celui qui permet de corriger sans toucher à tout ni réécrire un script qui était presque juste.

Une parenthèse oubliée, une variable mal orthographiée ou une indentation incorrecte suffit à bloquer le script. Ce blocage fait partie de l’apprentissage normal. Le mauvais réflexe consiste à supprimer des lignes au hasard. Le bon réflexe consiste à lire, formuler une hypothèse, corriger une chose, puis relancer.

Une erreur est une information, pas un jugement. Lisez-la calmement avant de modifier le fichier.

Ajouter une petite logique sans compliquer le projet

Une fois le premier script lancé, ajoutez une condition. Par exemple, demandez l’âge et affichez un message différent selon la réponse. Vous introduisez alors la logique conditionnelle, qui sert partout : formulaires, automatisations, scripts d’analyse, petits outils internes. Le bon réflexe consiste à garder le programme lisible pendant cette évolution, car une condition mal placée peut rendre une erreur plus difficile à repérer qu’une ligne de syntaxe incorrecte.

Attention à un piège classique : ce que renvoie input() est du texte. Si vous voulez comparer un âge comme un nombre, convertissez-le avec int(). Cette conversion est une excellente première leçon, car elle montre que Python distingue les chaînes de caractères et les nombres.

age = int(input("Quel âge as-tu ? "))

if age >= 18:
    print("Tu es majeur.")
else:
    print("Tu es mineur.")

La ligne indentée sous if ou else fait partie du bloc correspondant. En Python, l’indentation n’est pas décorative : elle structure le programme. C’est parfois surprenant pour un débutant, mais cela rend le code très lisible quand la règle est respectée.

Passer aux fonctions sans changer de niveau

Une fonction sert à donner un nom à une petite action. Elle évite de répéter les mêmes lignes et rend le script plus lisible. Pour un premier apprentissage, ne cherchez pas encore les architectures complexes. Une fonction qui prépare un message suffit à comprendre l’idée.

Le point important est la séparation entre définir et appeler. Quand vous écrivez def, vous expliquez à Python quoi faire plus tard. Quand vous écrivez le nom de la fonction avec des parenthèses, vous demandez l’exécution. Beaucoup de débutants oublient cette deuxième étape.

def creer_message(prenom):
    return "Bonjour " + prenom

nom = input("Ton prénom ? ")
print(creer_message(nom))

Ce script reste très simple, mais il introduit une idée majeure : votre code peut être découpé en blocs nommés. Dès qu’un script grossit, cette découpe devient un outil de clarté, pas une décoration.

Nommer les variables et commenter sans alourdir

Un débutant a souvent envie de commenter chaque ligne. Ce n’est pas nécessaire. Un commentaire doit expliquer une intention, une limite ou une décision, pas traduire mécaniquement le code. Si la ligne est simple, un bon nom de variable vaut mieux qu’un commentaire évident.

Préférez donc prix_unitaire à p, nom_fichier à x, total_ttc à resultat si le contexte le demande. Ces noms rendent le script lisible quand vous revenez dessus deux jours plus tard. La lisibilité n’est pas un luxe : c’est ce qui permet de corriger sans tout relire depuis zéro.

Les commentaires restent utiles pour expliquer une règle. Par exemple, “on refuse les quantités négatives” ou “on arrondit pour l’affichage seulement”. Ils deviennent gênants quand ils répètent “on affiche le total” juste au-dessus d’un print évident.

# On applique la remise uniquement au-delà de 100 €
if total > 100:
    total = total * 0.9

Ce réflexe prépare la suite : écrire du code que quelqu’un d’autre peut lire, y compris vous-même dans une semaine. C’est une compétence de débutant avancé, mais elle commence dès le premier fichier.

Quand utiliser un éditeur comme VS Code

Un éditeur moderne rend l’apprentissage plus confortable : coloration syntaxique, terminal intégré, suggestions, formatage et navigation entre fichiers. Visual Studio Code est un choix fréquent pour commencer avec Python, mais l’éditeur ne doit pas masquer les bases. Vous devez encore savoir où se trouve le fichier et quelle commande lance le script. Si l’éditeur lance un autre interpréteur que votre terminal, vous pouvez obtenir deux comportements différents avec le même fichier ; c’est précisément pourquoi la compréhension du terminal reste utile.

Installez l’extension Python seulement après avoir vérifié que Python fonctionne dans le terminal. Sinon, vous risquez de confondre un problème d’éditeur avec un problème d’installation. Le bon ordre reste : Python d’abord, éditeur ensuite, extensions seulement quand le script de base fonctionne.

Installer des paquets : pas avant d’en avoir besoin

Les bibliothèques sont utiles, mais elles ajoutent une couche. Ne commencez pas par elle.

Beaucoup de tutoriels débutants parlent vite de pip, de bibliothèques et d’environnements virtuels. Ce sont de bons outils, mais ils arrivent après le premier script autonome. Tant que vous utilisez print(), input(), conditions, boucles et fichiers simples, vous pouvez rester avec la bibliothèque standard.

Lorsque vous commencez à installer des paquets externes, créez un environnement virtuel. Il isole les dépendances du projet et évite de mélanger plusieurs essais sur la même machine. Pour un débutant, l’idée suffit : chaque projet peut avoir son petit espace Python séparé.

python -m venv .venv

# activer l'environnement dépend du système
# puis installer un paquet si nécessaire
python -m pip install nom-du-paquet

Ne transformez pas cette étape en labyrinthe. Si votre premier script n’a besoin d’aucun paquet, n’en installez pas. La simplicité est une compétence.

Un mini-projet réaliste pour finir la séance

Après les exercices isolés, créez un mini-script qui répond à un besoin minuscule. Par exemple : demander une dépense, une quantité, puis calculer un total. Vous utilisez alors input(), conversion numérique, variables, condition éventuelle et affichage. C’est peu, mais c’est déjà une logique complète.

Voici une version volontairement sobre. Elle ne gère pas tous les cas, et c’est acceptable. Le but est de voir le chemin des données : une saisie arrive comme texte, elle est convertie en nombre, puis elle sert à produire un résultat.

prix = float(input("Prix unitaire : "))
quantite = int(input("Quantité : "))

total = prix * quantite

if total > 100:
    print("Total élevé :", total, "€")
else:
    print("Total :", total, "€")

Vous pouvez ensuite l’améliorer par petites touches : arrondir le total, ajouter une remise, refuser une quantité négative ou enregistrer le résultat. Chaque amélioration doit avoir une raison précise. C’est ainsi qu’un exercice devient progressivement un outil.

N’ajoutez pas tout le même jour. Gardez une version qui fonctionne, puis modifiez une seule chose à la fois.

Les erreurs de débutant les plus fréquentes

Les premiers blocages reviennent souvent. Le fichier n’est pas dans le bon dossier. Python n’est pas trouvé par le terminal. Le fichier s’appelle avec une extension cachée, par exemple bonjour.py.txt. Une variable est écrite de deux manières différentes. Une indentation mélange espaces et tabulations. Ces problèmes paraissent très différents, mais ils ont le même remède : isoler une cause, vérifier une hypothèse, puis relancer sans modifier trois choses à la fois.

Ces erreurs ne disent pas que vous êtes “mauvais”. Elles disent que la programmation demande une précision nouvelle. Un ordinateur ne devine pas l’intention ; il exécute ce qui est écrit. Accepter cette rigueur au début évite beaucoup de frustration.

Corrigez une cause à la fois. Sinon, vous ne saurez pas ce qui a réellement fonctionné.

1. Si le fichier est introuvable, vérifiez d’abord le dossier courant.
2. Si la commande Python échoue, revenez à la vérification de version.
3. Si une variable est inconnue, comparez exactement les noms utilisés.
4. Si l’indentation bloque, réalignez le bloc sans mélanger tabulations et espaces.
5. Si une conversion échoue, affichez la valeur saisie avant de la transformer.

Faire évoluer le script sans tout réécrire

Quand le script fonctionne, ajoutez une amélioration minuscule. Enregistrez la date, formatez mieux le message, faites une boucle pour poser plusieurs questions, ou écrivez le résultat dans un fichier texte. Une seule nouveauté à la fois permet de savoir ce qui a cassé si une erreur apparaît.

Cette progression évite le piège du grand tutoriel jamais terminé. Un petit script que vous modifiez trois fois vous apprend plus qu’un projet copié en entier. Vous commencez à sentir la logique d’exécution, les entrées, les sorties et les limites de votre code.

Gardez une version qui marche, puis expérimentez. La meilleure progression reste celle que vous pouvez vérifier vous-même.

Ce qu’il vaut mieux éviter au tout début

Certains sujets sont utiles, mais trop tôt. Les frameworks web, l’intelligence artificielle, les interfaces graphiques, les bases de données et les gros projets GitHub peuvent attendre. Si vous les ouvrez avant de savoir lancer un fichier, lire une erreur et organiser un dossier, vous risquez de croire que Python est compliqué alors que vous avez simplement brûlé les étapes.

Évitez aussi les scripts copiés sans lecture. Copier un exemple peut aider, mais seulement si vous le réduisez ensuite à des morceaux compréhensibles. Changez une variable, modifiez un message, cassez volontairement une ligne, puis observez l’erreur. Cette exploration active vaut mieux que la copie silencieuse.

Le niveau suivant viendra plus vite si le niveau actuel est solide.

Ce que vous devez retenir après ce premier script

Si vous avez créé un fichier .py, lancé une commande, vu une sortie et corrigé une erreur, vous avez franchi le vrai seuil. Vous n’avez pas seulement lu du Python : vous avez exécuté un programme et compris la boucle de travail minimale. C’est la base sur laquelle vous pourrez ensuite apprendre les fonctions, listes, dictionnaires, fichiers, modules, tests et paquets, sans dépendre d’un tutoriel à chaque nouvelle ligne.

La suite doit rester progressive. Ne cherchez pas à “maîtriser Python” en une semaine. Cherchez plutôt à écrire des scripts courts qui résolvent de vrais petits problèmes : renommer des fichiers, nettoyer un tableau, générer un message, vérifier une liste. C’est là que Python devient concret.

Un bon premier script n’est pas impressionnant. Il est clair, lançable, corrigible et compris.

À partir de là, votre meilleur plan n’est pas de lire dix nouveaux guides. Prenez le même fichier, changez un détail, relancez, puis notez ce que vous avez appris. Cette répétition courte installe le geste de développeur : avancer par hypothèse vérifiable, pas par intuition vague.

Pour approfondir ce point, consultez markdown pdf, qui traite plus précisément de markdown pdf, produire des documents propres sans perdre la source.