# Como verificar se um tutorial de programação do YouTube ainda funciona

Para verificar se um tutorial antigo do YouTube funciona na sua versão do software, registre a versão informada e as etapas exatas que aparecem na tela. Compare essas etapas com a documentação oficial da sua versão. Depois, teste um exemplo sem riscos no seu computador. Salve os resultados em uma tabela de versões e etapas. Mantenha visíveis as instruções alteradas e as etapas não resolvidas antes de seguir o tutorial completo.

Comece pelo vídeo, pelo seu software e pela documentação oficial. Você pode verificar um tutorial curto manualmente. As legendas com marcação de tempo podem ajudar a encontrar instruções em um vídeo mais longo. Elas não confirmam o código exibido na tela nem provam que ele funciona.

O resultado é uma tabela que informa o que você verificou, o que mudou e o que ainda precisa de evidências. Ela ajuda a decidir sobre uma tarefa do tutorial em uma configuração informada.

## 1. Defina a tarefa e registre as duas versões

Escolha um resultado que você deseja obter com o tutorial. Por exemplo, você pode querer remover um prefixo exato de um texto. Um prefixo é um texto no início de um texto maior.

Limite a tarefa para que seja possível verificá-la. “Esta operação de texto funciona?” permite definir um teste claro. “Este curso de programação ainda é bom?” não permite.

Uma [pergunta pública sobre programação](https://www.reddit.com/r/learnprogramming/comments/1gz6km5) diz: “Posso aprender programação apenas com vídeos do YouTube e muita prática?” As evidências fornecidas indicam que as respostas mencionam versões desatualizadas de software. Esse é um motivo útil para verificar a configuração antes de praticar. Essa única pergunta não mede quantos estudantes têm o problema.

Registre estes dados antes de copiar uma instrução:

1. O título do tutorial e a URL do vídeo.
2. A data de publicação, se conhecida.
3. O nome e a versão do software informados no tutorial.
4. Onde o tutorial informa essa versão.
5. A versão do software que você vai usar de fato.
6. A data da verificação.
7. O resultado específico que você deseja reproduzir.

Um ambiente é a configuração de software na qual você faz o trabalho. Inclua outros dados da configuração quando eles afetarem a etapa escolhida. Por exemplo, registre a versão de uma ferramenta obrigatória quando o tutorial informar uma.

Mantenha a data de publicação e a versão do software separadas. Um vídeo publicado recentemente não prova que suas instruções correspondem à sua versão. Um vídeo antigo não prova que todas as instruções deixaram de funcionar.

Se o tutorial não informar a versão, escreva “desconhecido”. Não tente adivinhar pela idade ou pela aparência do vídeo. Se você não conseguir confirmar sua própria versão, resolva essa falta de informação antes de afirmar que as versões correspondem.

## 2. Encontre cada instrução e observe a tela

Assista à parte que executa a tarefa escolhida. Pause em cada ação obrigatória. Copie a instrução visível exatamente como aparece antes de propor uma alteração.

Uma legenda é um trecho de texto armazenado com um vídeo. Uma transcrição reúne o texto das legendas. Um segmento com marcação de tempo é um trecho de legenda com tempo de início e de fim.

Use as legendas para encontrar possíveis trechos. Depois, assista a esses trechos. A pessoa pode dizer “execute isto” enquanto a tela mostra o único comando completo. As legendas também podem conter um nome de software incorreto ou omitir uma ação feita em silêncio.

Para um vídeo longo, use o método de navegação com foco específico descrito em [como encontrar um conceito em uma aula longa](/pt-BR/articles/como-encontrar-um-conceito-em-uma-aula-longa-no-youtube/). Aqui, o objetivo é encontrar a instrução que você precisa verificar. Não é necessário criar um índice da aula inteira.

Para cada etapa obrigatória:

1. Salve o tempo do vídeo em que a instrução aparece.
2. Leia o código, a opção de menu ou a configuração na tela.
3. Registre qualquer configuração exibida logo antes.
4. Preserve a instrução original.
5. Marque os textos pouco claros como não resolvidos.

Não trate as palavras faladas como código extraído. A ferramenta de legendas descrita abaixo não faz reconhecimento óptico de caracteres. Esse termo significa ler texto de uma imagem. Você precisa examinar a tela por conta própria.

Um comentário que diz “funcionou” pode sugerir algo a verificar. Ele não comprova compatibilidade. Compatibilidade significa que uma instrução funciona com a versão do software em questão. O comentário pode não informar essa versão nem as etapas exatas usadas.

Se um comentário relatar um botão ausente ou um erro, compare-o com o trecho do vídeo antes de usá-lo como evidência. O método descrito em [como conferir um comentário com um trecho do tutorial](/pt-BR/articles/comentarios-do-youtube-para-revisar-tutoriais/) explica essa verificação separada. Trate o comentário como uma pista até confirmar a configuração usada e sua relevância.

## 3. Use legendas com marcação de tempo quando forem úteis

O [YouTube Transcript Scraper](https://apify.com/chronometrica/youtube-transcript-scraper) é um Actor: um programa hospedado que coleta dados. Sua função documentada aqui é ler legendas públicas existentes. Você ainda precisa identificar as instruções, examinar a tela, ler a documentação oficial e avaliar o teste.

O contrato público verificado em 25 de outubro de 2026 descreve a compilação 0.1.43. Ele aceita URLs diretas de vídeos públicos do YouTube ou IDs de vídeos. Um ID é o código curto que identifica um vídeo. Ele não aceita um canal, uma playlist ou uma página de busca como lista de fontes. Ele lê faixas de legendas existentes; não cria texto a partir da fala nem baixa áudio ou vídeo.

A [Task pública de transcrição com marcação de tempo](https://apify.com/chronometrica/youtube-transcript-scraper/examples/youtube-timestamped-transcript-json) é uma configuração predefinida para começar. Uma Task é um conjunto salvo de valores de entrada. Sua página pública e seu ID foram encontrados em 25 de outubro de 2026. Essa verificação não examinou os dados de entrada salvos que exigem autenticação nem testou a execução.

Este pequeno conjunto de dados de entrada passou na verificação de esquema fornecida. Um esquema define os campos e valores de entrada permitidos. Uma verificação de esquema não equivale a uma execução de coleta bem-sucedida.

```json
{"includeFailedInputDetails":true,"outputFormats":["json"],"preferredLanguages":[],"startUrls":["https://www.youtube.com/watch?v=dQw4w9WgXcQ"]}
```

3. Use legendas com marcação de tempo quando forem úteis

Antes de executar:

1. Substitua toda a lista de exemplo em `startUrls` pela URL do tutorial público desejado.
2. Mantenha `outputFormats` definido como `["json"]` para solicitar segmentos com marcação de tempo.
3. Escolha sua política de idioma das legendas.
4. Mantenha `includeFailedInputDetails` como true para que as entradas com falha continuem visíveis no relatório de execução.

A URL de exemplo serve para ilustrar o esquema. Ela não é evidência de um resultado útil de tutorial. Nenhuma execução do Actor foi feita para este guia.

Uma lista `preferredLanguages` vazia solicita a melhor faixa de legendas disponível. Isso não garante legendas em inglês. Se você definir preferências de idioma, o Actor as tenta na ordem indicada. Se nenhuma estiver disponível, o resultado documentado é uma falha categorizada de idioma indisponível. Isso significa uma falha com uma categoria informada, em vez de uma troca de idioma sem aviso.

O limite documentado é de 1 a 1.000 entradas. IDs de vídeos repetidos são processados uma única vez. Para esta verificação, use um tutorial.

Após executar a coleta proposta, examine o resultado antes de usar o texto. Uma linha do conjunto de dados é um resultado salvo de um vídeo. Cada vídeo único processado com sucesso gera uma linha. As entradas com falha aparecem no relatório de execução chamado OUTPUT.

Preserve a identificação do vídeo, `status`, `statusReason`, `transcriptLanguageCode`, `isAutoGenerated` e `scrapedAt`. O último campo registra o momento da coleta. Preserve os `segments` originais, incluindo `text`, `startSeconds`, `endSeconds` e `durationSeconds`.

Use os tempos retornados para encontrar o trecho. O texto simples, por si só, não informa os tempos de fim das legendas. Uma duração ausente continua desconhecida, mesmo que haja um tempo de fim disponível. Não substitua um valor ausente por zero.

As indicações de idioma, de origem das legendas e os valores de cobertura não provam que as palavras estão corretas. Assista ao trecho pertinente em todos os casos.

As legendas são dados de fontes públicas. Seus dados de entrada salvos, os registros privados de execução, o registro da versão local e os resultados dos testes são registros separados. Uma página pública de configuração predefinida não prova o que o titular de uma conta salvou ou executou.

## 4. Monte uma tabela de versões e etapas

Uma tabela de versões e etapas relaciona cada instrução à sua fonte, à referência oficial e ao resultado do teste. Use uma linha por etapa obrigatória. Divida uma linha quando duas ações precisarem de verificações diferentes.

Salve estes campos:

| Campo | O que salvar |
| --- | --- |
| Tarefa | O resultado específico que você deseja |
| Fonte do vídeo | Título e URL pública |
| Localização na fonte | Tempo do vídeo e segmento de legenda pertinente, se disponível |
| Instrução original | Código, opção ou ação exatamente como aparece na tela |
| Versão do tutorial | Versão informada e onde você a encontrou, ou desconhecido |
| Ambiente local | Sua versão real do software e as configurações pertinentes |
| Referência oficial | URL da página, versões abrangidas e trecho pertinente |
| Data de consulta da referência | Quando você leu essa página |
| Alteração proposta | Sua instrução substituta, mantida separada da original |
| Dados de entrada do teste | Dados de entrada exatos e sem riscos, se testados |
| Resultado esperado | O que deve acontecer e por quê |
| Resultado real | Saída ou erro exato observado, ou não testado |
| Data do teste | Quando o teste ocorreu, ou não testado |
| Estado | Verificado, alteração documentada, não testado ou bloqueado |
| Pendência | Evidências ausentes e a próxima verificação necessária |

Preserve os erros com o mesmo cuidado que as saídas bem-sucedidas. Não substitua um erro pelo resultado que você esperava.

Use “desconhecido” quando faltar uma informação. Use zero apenas quando zero for o valor real conhecido. “Nenhum teste registrado” não significa “zero falhas”. Significa que você não tem evidências de teste para essa linha.

Mantenha as instruções originais e propostas em campos separados. Caso contrário, quem ler depois não poderá saber o que mudou nem por quê.

## 5. Leia a referência oficial do recurso e da versão

Abra a documentação oficial do recurso exato. Um recurso é uma função ou um comportamento do software. Verifique qual versão do software a página abrange.

Leia a descrição do comportamento e as notas sobre quando o recurso foi introduzido, alterado ou removido. Salve o trecho pertinente e a data da consulta.

Siga esta sequência:

1. Confira se o nome exato do recurso corresponde à instrução visível.
2. Confirme a versão abrangida pela referência.
3. Leia sobre o comportamento esperado.
4. Verifique as notas de versão.
5. Compare essa abrangência com sua versão local.
6. Registre qualquer informação que ainda falte.

Uma página atual da documentação pode informar quando um recurso foi adicionado. Isso não a torna uma evidência de todos os comportamentos em todas as versões anteriores. Se a página não abranger a versão necessária, deixe essa parte sem resolução até obter uma referência oficial pertinente.

Não conclua que um recurso está indisponível porque você não encontrou sua documentação. Registre a busca sem sucesso como uma lacuna nas fontes.

A [referência oficial de strings do Python](https://docs.python.org/3/builtins/stdtypes.html#str.removeprefix) traz um exemplo claro. `str.removeprefix` remove o prefixo exato fornecido quando ele aparece no início. Caso contrário, retorna a string sem alterações. A referência informa que ele foi adicionado no Python 3.9.

As evidências fornecidas dessa mesma referência distinguem `lstrip`: ele remove caracteres iniciais que pertencem a um conjunto fornecido. Ele não é um substituto equivalente para a remoção de um prefixo exato. Nomes semelhantes ou resultados semelhantes com uma entrada não comprovam o mesmo comportamento.

## 6. Escolha um teste sem riscos e com resultado claro

Um teste de reprodutibilidade verifica se você consegue obter um resultado informado a partir de dados de entrada informados em um ambiente informado.

Escolha o menor teste que responda à pergunta sobre o recurso. Prefira uma operação que trabalhe apenas com valores locais e não tenha efeitos externos. Escreva o resultado esperado antes de executá-la.

Nesta primeira verificação, evite instalações não revisadas, criação de contas, credenciais, sistemas de produção e comandos copiados sem revisão. Credenciais são informações secretas usadas para obter acesso. Um sistema de produção é um sistema usado para trabalho real.

Registre os dados de entrada exatos, a saída esperada, a saída real, a versão local e a data do teste. Se o teste falhar, preserve o erro exato e interrompa essa etapa. Não faça várias alterações sem explicação para depois registrar apenas o sucesso final.

Um teste de recurso sem riscos tem um objetivo limitado. Ele pode confirmar uma operação no seu ambiente. Ele não prova que um projeto inteiro pode ser instalado, que todas as etapas do tutorial funcionam ou que outras versões do software se comportam da mesma forma.

## 7. Exemplo resolvido: remoção de prefixo exato

Este exemplo usa o registro de teste local fornecido. Não é uma ficção criada para este texto. Também não é um teste de um tutorial real do YouTube.

O ambiente registrado era Python 3.12.12. A data da verificação foi 25 de outubro de 2026. O teste usou apenas expressões locais de string da biblioteca padrão. A biblioteca padrão é o conjunto de ferramentas fornecido com o Python. Este teste não incluiu instalação, acesso à rede nem execução de tutorial.

A tarefa é remover o prefixo exato de uma string. Uma string é um valor de texto.

Primeira expressão:

```python
"Arthur: three!".removeprefix("Arthur: ")
```

7. Exemplo resolvido: remoção de prefixo exato

O resultado esperado era `three!`. O resultado real registrado foi `three!`.

O prefixo contém oito caracteres: seis letras, um sinal de dois-pontos e um espaço. O texto original contém 14 caracteres. Ao remover esse prefixo, restam 14 − 8 = 6 caracteres: as cinco letras de `three` e o ponto de exclamação. Essas unidades são caracteres, não bytes.

Segunda expressão:

```python
"Arthur: three!".lstrip("Arthur: ")
```

7. Exemplo resolvido: remoção de prefixo exato

O resultado esperado era `ee!`. O resultado real registrado foi `ee!`.

Aqui, `lstrip` trata o texto fornecido como um conjunto de caracteres a remover do início. Depois de remover `Arthur: `, ele continua pelos caracteres iniciais `t`, `h` e `r` de `three!`. Esses caracteres também pertencem ao conjunto fornecido. Ele para em `e`.

Isso remove os oito caracteres do prefixo e mais três caracteres. A conta é 14 − 8 − 3 = 3 caracteres. O texto restante é `ee!`.

| Verificação | Evidência registrada | Limite |
| --- | --- | --- |
| Versão local | Python 3.12.12 | Não descreve outro ambiente |
| Nota oficial de versão | `str.removeprefix` adicionado no Python 3.9 | Não comprova todos os comportamentos das versões posteriores |
| Teste de prefixo exato | Esperado: `three!`; real: `three!` | Verifica apenas esta expressão e estes dados de entrada |
| Teste de caracteres iniciais | Esperado: `ee!`; real: `ee!` | Mostra por que esta expressão não é um substituto equivalente |
| Versão do tutorial e localização na fonte | Desconhecido; nenhum tutorial foi testado | Nenhuma etapa do tutorial pode ser marcada como verificada |
| Fluxo de trabalho completo | Não testado | Não permite afirmar que o tutorial completo funciona |

As evidências sustentam uma decisão limitada. Use a remoção de prefixo exato quando essa for a operação de texto desejada e a versão oferecer suporte a ela. Não a substitua por `lstrip` como se fossem a mesma coisa.

Para o seu tutorial, acrescente a instrução exata exibida e o tempo em que ela aparece no vídeo. Depois, faça seu próprio teste sem riscos na versão informada. O resultado fornecido é uma evidência sobre o Python 3.12.12, não um resultado do seu computador.

## 8. Atribua um estado e decida o que pode prosseguir

Use os mesmos quatro estados em toda a tabela:

| Estado | Significado | Próxima decisão |
| --- | --- | --- |
| Verificado | Você examinou a instrução e confirmou o teste escolhido no ambiente informado | Prossiga dentro do escopo testado |
| Alteração documentada | A referência oficial sustenta uma diferença de versão pertinente | Preserve o original, proponha uma alteração e registre se ela foi testada |
| Não testado | Você não fez o teste necessário | Teste antes de afirmar que funciona localmente |
| Bloqueado | A falta de evidências ou uma ação obrigatória insegura impede a verificação | Resolva a pendência antes de seguir essa etapa |

Uma alteração documentada não é automaticamente uma correção testada. Mantenha o resultado do teste nos campos de resultado separados. Se precisar de uma nova instrução, crie uma linha só para ela, para que suas evidências fiquem claras.

Se as legendas estiverem indisponíveis, você ainda pode examinar o vídeo manualmente. Se a tela estiver ilegível, mantenha a instrução exata como não resolvida. Se sua versão for desconhecida, confirme-a antes de afirmar que há compatibilidade. Se a referência oficial não abranger o caso necessário, mantenha o registro da lacuna nas fontes.

Antes de seguir o tutorial completo, verifique todas as linhas obrigatórias. Cada linha precisa de evidências para a ação que você pretende executar. O sucesso de uma expressão não valida uma etapa de instalação ou de conta que não foi testada.

Não transforme a tabela em uma nota geral de qualidade do vídeo. Seu objetivo é apoiar uma decisão prática: quais instruções você pode seguir no ambiente informado e quais ainda precisam de trabalho.

## Verifique uma etapa obrigatória a seguir

Escolha uma instrução visível no seu tutorial. Registre as duas versões, leia a referência oficial pertinente e defina um teste sem riscos. Salve o resultado exato e seu limite antes de continuar.

Se encontrar a instrução for a parte demorada, use o [YouTube Transcript Scraper](https://apify.com/chronometrica/youtube-transcript-scraper) para solicitar as legendas existentes com marcação de tempo do seu tutorial público. Primeiro, substitua a URL de exemplo. Trate a coleta como uma ação proposta até examinar o resultado. Depois, volte ao vídeo e conclua você mesmo a verificação de versão.

## Fontes e leituras adicionais

- [Tipos embutidos do Python: remoção de prefixo e de caracteres iniciais — verificado em 25 de outubro de 2026; comportamento e notas de versão oficiais, não um teste de tutorial](https://docs.python.org/3/builtins/stdtypes.html#str.removeprefix)
- [YouTube Transcript Scraper — verificado em 25 de outubro de 2026; contrato público da compilação 0.1.43, sem execução de coleta nem teste de funcionamento em execução](https://apify.com/chronometrica/youtube-transcript-scraper)
- [Task de transcrição com marcação de tempo — verificada em 25 de outubro de 2026; apenas presença da página pública e do ID da Task, sem verificação dos dados de entrada salvos ou da execução](https://apify.com/chronometrica/youtube-transcript-scraper/examples/youtube-timestamped-transcript-json)
- [Pergunta pública sobre aprender programação pelo YouTube — publicada em 25 de novembro de 2024, consultada em 25 de outubro de 2026; uma pergunta de leitor, não uma evidência de demanda ou desempenho](https://www.reddit.com/r/learnprogramming/comments/1gz6km5)