# Parcourir un projet et ouvrir des fichiers depuis un arbre

Ce guide montre comment ouvrir l'arbre du projet, le parcourir et y ouvrir un fichier. Il suppose Turbo JS déjà installé.

## Ouvrir l'arbre

Lancez l'éditeur **depuis le dossier du projet**, puis appuyez sur `F9`, ou choisissez **Window ▸ Project tree**.

Une fenêtre s'ouvre avec les fichiers du projet, nommée d'après le dossier depuis lequel l'éditeur a été lancé :

```
╔═[x]═══════════════ shapes ═══════════════2═[■]╗
║ ▶ .turbo-js                                   ║
║ ▼ lib                                         ║
║     geometry.js                               ║
║   .gitignore                                  ║
║   README.md                                   ║
║   package.json                                ║
║   shapes.js                                   ║
║   shapes.test.js                              ║
╚═══════════════════════════════════════════════╝
```

Les dossiers viennent d'abord, puis les fichiers, chaque groupe trié. `.git` est la seule chose masquée — `.turbo-js`, `.gitignore` et les autres sont des fichiers de votre projet, que vous voudrez sans doute ouvrir.

Appuyer de nouveau sur `F9` ramène cette fenêtre au premier plan plutôt que d'ouvrir un second arbre.

## Le parcourir

| Touche | Effet |
| --- | --- |
| `↑` `↓` | Déplacer la surbrillance |
| `→` | Ouvrir un dossier fermé ; sur autre chose, passer à la ligne suivante |
| `←` | Fermer un dossier ouvert ; sur autre chose, remonter au dossier qui le contient |
| `Entrée` | Ouvrir un fichier, ou ouvrir et fermer un dossier |
| `Début` `Fin` | Première / dernière ligne |
| `Page↑` `Page↓` | Un écran à la fois |

Un dossier est lu la première fois que vous l'ouvrez : un arbre sur un gros projet coûte donc une lecture de dossier, pas un parcours complet.

## Ouvrir un fichier

Placez la surbrillance dessus et appuyez sur `Entrée`, ou cliquez-le deux fois.

Le fichier s'ouvre dans une fenêtre à lui, devant l'arbre. Un fichier déjà ouvert est ramené au premier plan plutôt qu'ouvert deux fois.

## Voir un fichier créé après l'ouverture de l'arbre

L'arbre ne surveille pas le disque. Appuyez sur **`F5`** ou **`Ctrl-R`** avec l'arbre au premier plan : il relit le projet, en gardant ouvert ce que vous aviez ouvert et la surbrillance sur la même entrée.

Enregistrer un fichier rafraîchit l'arbre pour vous : un **File ▸ Save as** sous un nouveau nom y apparaît sans rien demander. Un fichier créé autrement — un `npm init` ou un `npm install` dans une fenêtre terminal, ou un `git checkout` — demande la touche de rafraîchissement.

## Travailler avec l'arbre et un fichier côte à côte

L'arbre est une fenêtre ordinaire, donc toutes les commandes de fenêtre s'y appliquent :

- **Window ▸ Tile** place l'arbre et votre fichier côte à côte.
- Tirez son coin inférieur droit pour le rétrécir une fois que vous vous y retrouvez.
- `[x]` le ferme ; `F9` le ramène.

## Variantes

- **Vous avez lancé l'éditeur depuis un sous-dossier.** L'arbre y est enraciné et ne montre que cette partie du projet. Lancez plutôt depuis le dossier du projet — la même règle que `.turbo-js/settings.toml`.
- **Un dossier apparaît ouvert mais vide.** Il n'a pas pu être lu, le plus souvent un problème de permissions. Le reste de l'arbre n'est pas affecté ; corrigez les permissions et appuyez sur `F5`.

## Voir aussi

- Toutes les touches et tout ce que l'arbre montre, exactement : [Référence de l'arbre du projet](../reference/project-tree.md)
- Pourquoi c'est une fenêtre et non un panneau ancré, et pourquoi il ne surveille pas le disque : [Arbre du projet](../explanation/project-tree.md)
- Le colorer : [Format des fichiers de thème](../reference/themes.md)