Вы работаете в Debian 12 с окружением Gnome и внезапно замечаете в своей рабочей директории папку с названием .virtual_documents. Она выглядит как обычная, но внутри — копии файлов, которых там быть не должно. Никаких явных действий для её создания вы не совершали, а приложения установлены по минимуму. Скорее всего, это Jupyter Lab с парой расширений. Давайте разберёмся, что это за директория, почему она появилась и как с ней взаимодействовать.
Кстати, если вы активно используете Jupyter Lab для работы с кодом, эта статья поможет понять внутренние процессы среды. Директория .virtual_documents — не случайный артефакт, а часть механизма взаимодействия с языковыми серверами (LSP).
Почему появляется .virtual_documents и что внутри?
Jupyter Lab создаёт эту папку для временного хранения несохранённых документов. Когда вы редактируете файл в среде (например, блокнот .ipynb или скрипт .py), его содержимое автоматически копируется в .virtual_documents. Это нужно, чтобы Language Server Providers (LSP) могли анализировать код в реальном времени — подсвечивать синтаксис, находить ошибки, предлагать автодополнение.
Обратите внимание:
- Директория находится в корне проекта, над которым вы работаете (например, /home/ваш_пользователь/проект/.virtual_documents).
- Файлы внутри — временные копии. Их названия могут выглядеть как хеши (например, abcd1234.py).
- При закрытии Jupyter Lab несохранённые данные удаляются, но сама папка остаётся.
Если вы видите в ней сохранённые файлы, это может быть связано с настройками расширений. Например, плагины для автосохранения или интеграции с Git иногда создают временные копии. Проверьте, какие расширения установлены:
- Откройте Jupyter Lab → меню Settings → Advanced Settings Editor.
- В разделе Language Server найдите параметры, связанные с кэшированием или автосохранением.
Можно ли удалить эту папку и как её настроить?
Саму директорию удалять не рекомендую — Jupyter Lab будет создавать её заново при запуске. Однако если вас беспокоят файлы внутри, можно:
- Остановить все сеансы Jupyter Lab перед очисткой (иначе возможны конфликты).
- Настроить исключение папки в вашем файловом менеджере (например, в Nautilus для Gnome) или добавить .virtual_documents/ в .gitignore, чтобы избежать случайного коммита.
Для тонкой настройки работы с LSP добавьте в конфигурационный файл Jupyter Lab (~/.jupyter/labconfig.py) параметры:
c.LanguageServerManager.virtual_documents_dir = '/ваш/путь' # изменить расположение
c.LanguageServerManager.cleanup_delay = 600 # время (в секундах) перед удалением временных файловВажно: если вы отключите LSP (через Settings → Language Servers), папка перестанет наполняться, но потеряете функции анализа кода.
Совет: Если папка занимает много места, проверьте, не настроено ли сохранение временных файлов при ошибках. Иногда расширения «забывают» очистить кэш после сбоев.
Подводя итог, .virtual_documents — не повод для беспокойства. Она помогает Jupyter Lab работать эффективнее, а её содержимое безопасно. Если хочется сократить «следы» среды, настройте исключения в файловых менеджерах или скорректируйте параметры языковых серверов. А вам приходилось сталкиваться с похожими скрытыми директориями? Делитесь в комментариях — обсудим решения!