Lição 2 de 3 · 14 min · Verificado em 6 de Outubro de 2026

Pastas, ficheiros e um editor (Windows, Mac e Linux)

No fim desta lição vais conseguir:

Ler um caminho de ficheiro no Windows, no Mac e no Linux
Mostrar as extensões e os ficheiros escondidos, como .env e .gitignore
Instalar o VS Code e abrir nele uma pasta inteira
Decidir se precisas do WSL no Windows

Descarregaste ontem a carta das Finanças. Onde está? O explorador diz «Transferências». O terminal, e qualquer agente de código, diz outra coisa:

Windows: C:\Users\Graca\Downloads\carta_financas.pdf
Mac: /Users/graca/Downloads/carta_financas.pdf
Linux: /home/graca/Transferências/carta_financas.pdf (no Linux, o nome das pastas pode vir traduzido)

É o mesmo ficheiro escrito como uma morada. Nesta lição aprendes a ler estas moradas, a ver o que o computador esconde e a abrir uma pasta inteira num editor.

O caminho é a morada

Um caminho lê-se da esquerda para a direita, como uma morada ao contrário: disco, pasta, subpasta, ficheiro. No Windows as pastas separam-se com \; no Mac e no Linux, com /.

Há dois tipos de caminho:

Absoluto: começa no início do disco (C:\ ou /). Funciona de qualquer sítio.
Relativo: começa na pasta onde estás. Se estiveres dentro de experiencias, o caminho index.html chega para falar do ficheiro que lá está.

O sinal ~ quer dizer «a minha pasta pessoal». ~/experiencias é a pasta experiencias dentro da tua pasta pessoal. Os agentes usam isto muito.

A extensão diz o tipo

As letras depois do último ponto são a extensão: .pdf (documento), .docx (Word), .txt (texto simples), .html (página web), .py (Python), .js (JavaScript), .md (texto com formatação simples), .json (dados).

O Windows esconde as extensões por omissão. Para quem vai trabalhar com código, isso é mau: não distingues index.html de index.html.txt. E é perigoso: factura.pdf.exe aparece como factura.pdf.

Isto é como está a 6 de Outubro de 2026; se o ecrã for diferente, procura o botão com o mesmo nome.

Windows 11: no Explorador de Ficheiros, Ver > Mostrar e liga as extensões dos nomes de ficheiros (em inglês, «File name extensions»).
Windows 10: separador Ver, grupo «Mostrar/ocultar», marca a caixa das extensões dos nomes de ficheiros.

Cuidado

Com as extensões escondidas, um programa disfarçado de PDF parece um PDF. Liga as extensões hoje e deixa-as ligadas. A extensão que conta é a última: carta.pdf.exe é um programa, não uma carta.

Os ficheiros escondidos

No Mac e no Linux, um ficheiro cujo nome começa por ponto fica escondido. Vais encontrar dois muitas vezes neste curso:

.env: guarda segredos, como chaves de acesso. Nunca se partilha.
.gitignore: lista o que o Git não deve guardar (lição 1/05).

Para os ver:

Mac (Finder): Cmd + Shift + . (ponto) liga e desliga.
Linux (gestor de ficheiros): normalmente Ctrl + H.
Windows: os nomes com ponto aparecem normalmente; outras coisas escondidas, como a pasta .git, só com Ver > Mostrar > Itens ocultos.
No terminal: ls -a no Mac e no Linux; dir -Force no PowerShell.

Um editor: o VS Code

Para código não serve o Word: ele mete formatação escondida no ficheiro. Precisas de um editor de texto simples. O Bloco de Notas chegava, mas o VS Code (gratuito, da Microsoft) mostra a pasta inteira à esquerda, pinta o código com cores e tem um terminal lá dentro.

Vai ao site do Visual Studio Code, descarrega a versão do teu sistema e instala como qualquer programa.
Abre o VS Code e usa File > Open Folder… (Ficheiro > Abrir Pasta). Escolhe a pasta experiencias.
À esquerda aparece o Explorer, com os ficheiros da pasta.
Para o terminal dentro do editor: View > Terminal, ou Ctrl + ` (a tecla do acento grave). Ele abre já dentro da pasta.

Guia oficial, em inglês: o que é um espaço de trabalho do VS Code.

Dica

Se estiveres no terminal dentro da pasta, code . abre-a no VS Code (o ponto quer dizer «esta pasta»). No Mac pode ser preciso activar este comando primeiro; se não funcionar, usa o menu, que dá ao mesmo.

Dica

Ao abrir uma pasta, o VS Code pode perguntar se confias nos autores dos ficheiros. Numa pasta tua, como a experiencias, responde que sim. Numa pasta descarregada de um desconhecido, responde que não: abre em modo restrito, que não corre nada sozinho.

Windows: o WSL em cinco linhas

Muitas ferramentas de programação nasceram no Linux e no Mac, por isso muitos guias assumem os comandos desses sistemas.
O WSL (Subsistema Windows para Linux) põe um Linux verdadeiro dentro do Windows, sem apagar nada.
Precisa de Windows 10 versão 2004 ou mais recente, ou Windows 11. Abre o PowerShell como administrador (botão direito, «Executar como administrador») e escreve wsl --install.
Reinicia o computador. Por omissão fica instalado o Ubuntu.
Da primeira vez que o abres, crias um nome de utilizador e uma palavra-passe só para o Linux.

Fonte: Instalar o WSL.

Podes trabalhar sem WSL. O Claude Code e o Codex têm instaladores para Windows (lição 1/02), e neste curso cada comando tem a versão Windows ao lado. O WSL dá jeito quando um guia só tem comandos Linux.

Dica

Ao escrever a palavra-passe no Linux, não aparece nada no ecrã, nem asteriscos. É normal. Escreve-a e carrega em Enter.

Exercício

Liga a opção de mostrar extensões (no Windows) ou os ficheiros escondidos (no Mac ou no Linux).
Abre a pasta experiencias no VS Code.
No Explorer, cria um ficheiro novo chamado horario.txt e escreve: Padaria do Largo: aberta das 7h às 19h. Guarda com Ctrl + S (Cmd + S no Mac).
Abre o terminal dentro do VS Code e escreve cat horario.txt (ou type horario.txt no Windows).

Como sei que ficou bem o ficheiro aparece no Explorer com o nome horario.txt (com a extensão visível) e o terminal mostra a frase que escreveste.

Se não deu

O terminal diz que o ficheiro não existe: confirma com pwd se estás na pasta experiencias, e com ls ou dir se o nome está igual.
O ficheiro chama-se horario.txt.txt: o editor juntou uma extensão. Muda o nome no Explorer do VS Code.
No wsl --install aparece um erro de permissões: o PowerShell não foi aberto como administrador. Fecha e abre com o botão direito.
No Windows, os acentos aparecem trocados (por exemplo Ã em vez de à): o ficheiro está bem; é o PowerShell que lê os acentos de outra maneira. Confirma no VS Code que a frase está certa.

Vídeos

**VS Code para Iniciantes: Guia Completo do Zero**
Professor Attique · 24 min · PT-BR · legendas · Ver no YouTube
Guia de VS Code para iniciantes: abrir pastas de projecto, criar ficheiros, terminal integrado, extensões e Git.

**Learn Visual Studio Code in 15 minutes: 2026 Official Beginner Tutorial**
Visual Studio Code · 15 min · EN · legendas · Ver no YouTube
Tutorial oficial do VS Code em 15 minutos: interface, criar um ficheiro, chat com IA e controlo de versões.

Testa o que aprendeste

1. Recebeste por email um anexo que no teu Windows aparece como «factura_luz.pdf», mas o ícone parece estranho. Qual é a melhor reacção? Ligar a opção de mostrar extensões e ver se o nome verdadeiro não acaba em .exe ou outra coisa Abrir, porque diz pdf Mudar o nome para factura_luz.pdf e abrir

2. Um guia manda criar um ficheiro .env com uma chave. Criaste-o, mas não o vês no Finder do Mac. O que se passa? O ficheiro não foi criado Tens de lhe mudar o nome para env.txt Os ficheiros cujo nome começa por ponto estão escondidos; usa Cmd + Shift + . ou ls -a para os ver

3. Estás no Windows e um guia de instalação só mostra comandos para Mac e Linux. Qual é a melhor reacção? Desistir, isto não é para Windows Procurar na página oficial as instruções para Windows e, se não houver, considerar o WSL Colar os comandos de Linux no PowerShell e ver o que acontece

Correcções a esta lição (1)

6 de Outubro de 2026: Depois de uma revisão externa: os três endereços soltos passaram a ligações com nome (site do VS Code, guia de espaços de trabalho, «Instalar o WSL»). As opções do quiz foram reordenadas.