Como recuperar arquivos excluídos no Jupyter Notebook: 6 métodos
Pensando Como recuperar arquivos excluídos no Jupyter Notebook após remover uma célula, excluir um arquivo .ipynb ou salvar uma alteração indesejada? Comece identificando o que desapareceu. Uma célula excluída, um arquivo de notebook ausente e um notebook armazenado em um JupyterHub remoto exigem soluções diferentes. Este guia orienta você em cada caso, na ordem mais segura. Para uma visão mais ampla recuperação de arquivos excluídos em uma unidade local do Windows, Magic Data Recovery pode procurar um caderno perdido quando as próprias opções de recuperação e backups do Jupyter não forem suficientes.
Faça isso primeiro: Pare de salvar arquivos, instalar pacotes, limpar caches ou executar ferramentas de limpeza na unidade em que o notebook estava armazenado. Novos dados podem sobrescrever um arquivo .ipynb excluído permanentemente.
Compatível com Windows 7/8/10/11 e Windows Server
Índice
O que exatamente você excluiu no Jupyter Notebook?
Um notebook .ipynb é um documento JSON que armazena células de código, células Markdown, resultados e metadados. No entanto, o kernel ativo também mantém um histórico de entradas para o código que você executou. Essa distinção explica por que é possível recuperar código do histórico sem precisar recuperar o notebook inteiro.
Faça este diagnóstico rápido antes de tentar resolver o problema:
O que desapareceu? | O melhor método inicial | O que o método pode restaurar |
Uma ou mais células, com o caderno ainda aberto | Pressione Z no modo de comando | Células excluídas recentemente |
Células ou edições salvas no caderno atual | Reverter para um ponto de verificação ou versão anterior | Um estado do caderno salvo anteriormente |
O arquivo .ipynb local na íntegra | Verifique a Lixeira ou o Lixo | O arquivo completo, caso tenha sido movido para lá |
O código foi executado, mas não resta nenhuma cópia utilizável no notebook | Pesquisar no histórico do IPython | Insira o código, não a estrutura completa do notebook |
Um notebook no JupyterHub, um laboratório do curso ou outro serviço hospedado | Verifique o histórico da plataforma ou entre em contato com o administrador | Backups do lado do servidor, instantâneos ou lixeira |
Um notebook local do Windows que não aparece na Lixeira nem nos backups | Faça uma verificação na unidade original | Um arquivo .ipynb excluído que possa ser recuperado ou outros arquivos de projeto |
Como recuperar arquivos excluídos no Jupyter Notebook: 6 métodos
Siga as soluções a seguir nesta ordem. Os métodos iniciais não verificam o espaço em disco excluído, por isso são mais rápidos e menos invasivos.
Método 1: Desfazer imediatamente a exclusão de uma célula
Se você excluiu uma célula, mas o caderno ainda está aberto, o histórico de operações de células do Jupyter oferece a solução mais rápida.
- Pressione a tecla Esc para entrar no modo de comando.
- Pressione Z uma vez.
- Verifique se a célula excluída volta à sua posição original.
- Salve o caderno com um novo nome antes de fazer mais alterações.
A corrente Referência de comandos do JupyterLab indica Z como o atalho para Desfazer operação na célula. Você também pode abrir o menu “Editar” ou a Paleta de Comandos e selecionar esse comando. Se você tiver excluído várias células, repita o procedimento com cuidado.
Não confunda a tecla Z com Ctrl+Z ou Cmd+Z. O comando de uma única tecla reverte uma ação realizada em uma célula no nível do caderno de anotações enquanto você estiver no modo de comando. O atalho padrão geralmente desfaz edições de texto dentro de uma célula ativa.
Essa opção funciona melhor antes de você fechar ou recarregar o notebook. Se o histórico de desfazer tiver sumido, passe para o método do ponto de verificação.
Método 2: Restaurar um ponto de verificação do Jupyter Notebook
Os pontos de verificação contêm um estado anterior salvo de um notebook. Eles são úteis quando você exclui células, substitui código em funcionamento ou salva uma edição com erros sobre o arquivo original.
Reverter a partir da interface do Jupyter
Antes de reverter, faça uma cópia do caderno atual. Em seguida, abra o menu “Arquivo” e procure por Reverter o Notebook para o ponto de verificação ou um comando com nome semelhante. O texto dos menus pode variar entre as versões do Jupyter Notebook e do JupyterLab.
Selecione o ponto de verificação disponível e verifique a data e a hora registradas. A reversão substitui o estado atual do notebook; portanto, copie todas as células mais recentes de que ainda precisar antes de confirmar.
Recupere o arquivo de ponto de verificação manualmente
O Jupyter costuma armazenar cópias de pontos de verificação em uma pasta oculta ao lado do notebook:
- projeto/
- ├── analysis.ipynb
- └── .ipynb_checkpoints/
- └── analysis-checkpoint.ipynb
Se o ponto de verificação ainda estiver lá, copie-o para uma pasta diferente e renomeie a cópia, por exemplo:
- analysis-recovered.ipynb
Abra a cópia renomeada no Jupyter e verifique as células. Não edite diretamente o único ponto de verificação.
Um ponto de verificação não é um sistema completo de controle de versão. Ele pode conter apenas um estado anterior e pode nem existir caso o caderno nunca tenha sido salvo. Além disso, excluir um caderno por meio de algumas interfaces pode remover os dados associados ao ponto de verificação. Portanto, verifique esse local logo no início, mas não confie nele como seu único backup.
Método 3: Restaurar o arquivo .ipynb excluído da Lixeira
Se o arquivo inteiro tiver desaparecido, verifique o sistema operacional antes de usar um software de recuperação. O site oficial do Jupyter Notebook notas de lançamento suporte para enviar arquivos excluídos do painel do Notebook para a lixeira do sistema operacional, em vez de apagá-los imediatamente.
No Windows
- Aberto Lixeira.
- Pesquise o nome do caderno ou classifique por Data de exclusão.
- Verifique se o arquivo termina com a extensão .ipynb.
- Clique com o botão direito do mouse e selecione Restaurar.
- Volte para a pasta original do projeto e abra uma cópia.
No macOS
Aberto Lixo, localize o caderno, clique com o botão direito do mouse nele e selecione Colocar de volta. Se você usou o Finder ou o Terminal para excluir o arquivo, procure-o também pelo nome no Finder.
No Linux
Verifique a Lixeira do seu ambiente de desktop. Um local comum é:
- ~/.local/share/Lixeira/arquivos/
A localização real pode variar em uma estação de trabalho gerenciada, em um contêiner ou em um servidor remoto. Procure também no diretório do projeto, caso o notebook tenha sido renomeado ou movido, em vez de excluído.
Arquivos excluídos com Shift+Delete, um comando de terminal como o rm ou um processo de limpeza podem não passar pela Lixeira. Unidades removíveis e recursos compartilhados em rede também podem se comportar de maneira diferente.
Método 4: Recuperar código executado do histórico do IPython
Suponha que o arquivo do notebook tenha sido perdido, mas que seu kernel ou o histórico do IPython ainda estejam disponíveis. Ainda assim, você poderá reconstruir grande parte do código. Execute estes comandos em um novo notebook ou no console do IPython:
- %history -n
Isso exibe as entradas de código da sessão atual com números de linha. Para pesquisar no histórico salvo uma função, variável, importação ou comentário específico, use um padrão glob:
%history -g “rotatividade de clientes“
Para verificar as entradas recentes em todas as sessões, tente:
%history -l 100
Depois de identificar o intervalo necessário, exporte-o para um novo script:
%history -f recovered_notebook_code.py 4-38
Use um nome de arquivo que ainda não exista. O documentação oficial do IPython alerta que a opção -f pode sobrescrever o arquivo de destino a partir de uma interface de notebook.
Essa é uma maneira valiosa de recuperar código excluído no Jupyter Notebook, mas tem limites bem definidos. O histórico do IPython concentra-se nas entradas. Ele não recria as explicações em Markdown, a ordem das células com total fidelidade, as imagens anexadas às células em Markdown, os metadados do notebook nem todas as saídas exibidas. O código que você digitou, mas nunca executou, também pode estar ausente.
Método 5: Verifique os backups, o histórico de sincronização, o Git ou a plataforma de hospedagem
Quando os pontos de verificação falharem, procure fora do Jupyter. O local correto depende de onde o arquivo .ipynb estava armazenado.
- Histórico de arquivos do Windows ou Versões anteriores: Abra a pasta original do bloco de notas, verifique suas propriedades e procure uma versão anterior à exclusão.
- OneDrive, Dropbox ou Google Drive: Verifique a lixeira na nuvem e o histórico de versões, caso a pasta do projeto tenha sido sincronizada.
- Git: Verifique o status do Git, o histórico do repositório, outros ramos, stashes e cópias remotas. O Git só pode restaurar o conteúdo que foi submetido ou preservado de alguma outra forma.
- JupyterHub ou um servidor da universidade/empresa: Pergunte ao administrador sobre instantâneos, lixeira do servidor, backups e períodos de retenção.
- Plataformas de cursos e laboratórios hospedados: Verifique se há opções de reinicialização, restauração, histórico ou novo download antes de reinicializar a área de trabalho. A reinicialização pode substituir seus arquivos atuais.
This location check matters. A local data recovery program cannot directly scan a notebook that existed only on a remote JupyterHub server. In that case, the service owner or administrator controls the storage and backups.
Method 6: Recover a Deleted Jupyter Notebook with Magic Data Recovery
Use disk recovery only after Recycle Bin, checkpoints, history, and backups fail. This method fits a notebook that was stored on a Windows PC, external drive, USB device, or another storage device that you can connect to Windows.
Magic Data Recovery addresses a wider set of local data-loss cases than Jupyter’s built-in tools. It can scan for files lost through deletion, formatting, file-system errors, inaccessible partitions, or related logical problems. Its guided scan-and-recover workflow also avoids the command syntax required by some recovery utilities.
How to recover a local .ipynb file
1. Protect the source drive. Stop using the volume that contained the notebook. If the file was on C:, avoid downloading or installing anything there when possible.
2. Install safely. Baixar Magic Data Recovery to another drive or run it from a Windows computer that is not using the affected disk as its system drive.
Compatível com Windows 7/8/10/11 e Windows Server
3. Select the original location. Choose the disk or partition where the project folder existed, then start the scan.
4. Narrow the results. Search for the notebook name, .ipynb, its former folder, or the approximate modification date. A recovered notebook may appear under Documents or Other Files, depending on the remaining file-system information.
5. Recover to a different drive. Never save the result back to the source volume.
6. Validate the recovered copy. Open it in Jupyter. If Jupyter reports invalid content, inspect a duplicate in a text editor and confirm that it contains coherent JSON rather than a partial or overwritten file.
Magic Data Recovery is more practical than a checkpoint when the checkpoint disappeared with the original notebook, and more complete than IPython history when the underlying .ipynb file remains recoverable. It can also scan other project assets that history cannot reconstruct, such as CSV files, images, scripts, and documents.
Still, no recovery tool can promise a specific result. SSD TRIM, continued disk use, secure deletion, or physical damage may make recovery impossible. The software also cannot retrieve a file stored only on a remote server unless you first obtain access to that server’s storage or a local disk image.
Which Jupyter Notebook Recovery Method Should You Choose?
Método | Melhor para | Principal limitação |
Z / Undo Cell Operation | A cell deleted moments ago | Undo history may disappear after closing or reloading |
Checkpoint | Saved-over cells or an unwanted notebook state | Usually limited history; may be missing |
Lixeira ou Lixo | A recently deleted local .ipynb file | Permanent deletion may bypass it |
IPython %history | Rebuilding executed code | Does not restore a complete notebook |
Backup, sync, Git, or server snapshot | Preserved earlier copies | Must have existed before the loss |
Magic Data Recovery | A deleted local file or logical storage problem on Windows | Cannot recover overwritten data or scan remote-only storage |
In practice, the best sequence is undo → checkpoint → Trash → history → backup → disk scan. That order protects current data and uses the most direct recovery source first.
How to Prevent Another Jupyter Notebook Loss
Once you recover the work, improve the project rather than trusting checkpoints alone.
- Put important notebooks under Git and commit meaningful milestones.
- Keep the project inside a backed-up or versioned folder.
- Export critical notebooks to .py or HTML at key stages.
- Save raw data separately from generated outputs.
- Use clear filenames instead of keeping everything as Untitled.ipynb.
- Confirm the notebook’s actual path with %pwd, especially when using remote kernels or mounted drives.
- Test your backup restoration process before an emergency.
For active research, a simple habit works well: commit the notebook before a major refactor, then save a second copy before clearing cells or outputs.
Conclusão
Aprendizagem Como recuperar arquivos excluídos no Jupyter Notebook starts with distinguishing a deleted cell from a deleted .ipynb file. Press Z for a recent cell deletion, inspect checkpoints for an earlier saved state, check the operating system’s Trash for the complete file, and use IPython history when you mainly need executed code. For hosted notebooks, contact the platform owner and look for server-side snapshots.
When the missing notebook lived on a local Windows drive and those options fail, Magic Data Recovery is worth trying because it covers permanent deletion, formatted storage, and file-system errors through a clear scan-and-recover process. It also helps retrieve related project files that Jupyter history cannot rebuild. Act quickly, scan the correct device, and restore results elsewhere. For more guidance on safely restoring erased data, visit Amagicsoft’s recuperação de arquivos excluídos resource.
Compatível com Windows 7/8/10/11 e Windows Server
FAQs About Jupyter Notebook File Recovery
É possível recuperar uma célula excluída no Jupyter Notebook?
Sim. Se o bloco de notas permanecer aberto, pressione Esc para entrar no modo de comando e, em seguida, pressione Z para desfazer a última operação na célula. Você também pode escolher Desfazer operação na célula no menu ou na Paleta de Comandos. Salve uma cópia assim que a célula for exibida.
Onde são armazenados os arquivos de checkpoint do Jupyter Notebook?
O Jupyter geralmente os armazena em uma pasta oculta chamada .ipynb_checkpoints, localizada ao lado do notebook original. Um arquivo chamado analysis.ipynb pode ter um ponto de verificação chamado analysis-checkpoint.ipynb. A pasta ou o ponto de verificação podem não existir se o notebook nunca tiver sido salvo ou se seu ponto de verificação tiver sido removido.
Um ponto de verificação pode recuperar um caderno que foi totalmente excluído?
Às vezes, mas não sempre. Um ponto de verificação pode permanecer intacto quando o arquivo original foi excluído fora do Jupyter; no entanto, alguns fluxos de trabalho de exclusão removem os dados associados aos pontos de verificação. Verifique o arquivo .ipynb_checkpoints, copie qualquer arquivo em potencial para outro local, renomeie-o com a extensão .ipynb e abra a cópia.
O comando `%history` restaura o Jupyter Notebook inteiro?
O `No. %history` pode recuperar entradas de código registradas pelo IPython, incluindo entradas de sessões anteriores em muitas configurações. Ele não reproduz integralmente células Markdown, saídas com formatação avançada, anexos, metadados ou a ordem exata das células. Considere-o como uma forma de reconstruir o código, e não como o notebook completo.
Para onde vão os arquivos do Jupyter Notebook que são excluídos?
Os arquivos excluídos por meio das interfaces modernas do Jupyter geralmente vão para a Lixeira do sistema operacional. No entanto, comandos de terminal, atalhos para exclusão definitiva, servidores remotos, contêineres e gerenciadores de conteúdo personalizados podem se comportar de maneira diferente. Verifique tanto a Lixeira local quanto qualquer área de recuperação específica do servidor ou da plataforma.
O Magic Data Recovery consegue recuperar um arquivo .ipynb?
É possível recuperar um arquivo .ipynb excluído de um local de armazenamento acessível no Windows, desde que seus dados e registros no sistema de arquivos não tenham sido sobrescritos. Pesquise os resultados da varredura por nome de arquivo, extensão, caminho e data e, em seguida, restaure os arquivos identificados em outra unidade. Os resultados da recuperação dependem do dispositivo e da atividade posterior no disco.
É possível recuperar um notebook excluído do JupyterHub?
É possível, mas a recuperação depende do servidor. Os notebooks do JupyterHub geralmente ficam armazenados em um espaço de armazenamento gerenciado pelo servidor; portanto, verifique a lixeira, os instantâneos, o histórico de sincronização ou os backups da plataforma. Entre em contato com o administrador o mais rápido possível. Um software de recuperação local não consegue verificar diretamente um arquivo de servidor que existe apenas remotamente sem acesso ao armazenamento.
O que devo fazer logo após excluir um bloco de notas?
Pare de gravar no armazenamento afetado. Não instale pacotes, não limpe caches, não formate o disco nem recrie um arquivo com o mesmo nome. Verifique primeiro as ações de desfazer, os pontos de verificação, a Lixeira, o histórico e os backups. Se o arquivo era local e foi excluído permanentemente, faça a varredura a partir de outro disco.
