Проект и файлы
Дерево проекта показывает файлы и папки; содержимое подгружается по мере раскрытия, набор
раскрытых папок возвращается при следующем открытии проекта. Файл открывается по клику или
двойному (выбор — настройка explorer.openOnSingleClick). Значки файлов и папок свои: цвет
и буква говорят о виде файла, у папок отдельные тона для src, tests, dist и других.
Над деревом — поле фильтра (Ctrl+F в фокусе проводника): скрывает строки, не совпадающие
с подстрокой; шапка панели вместе с фильтром съедает минимум высоты, чтобы дерево начиналось
сразу под ней.
Проект в шапке окна#
Имя открытого проекта и переключение на недавние живут в шапке окна, сразу за меню, — а не в заголовке проводника: проект решает всё остальное (дерево, поиск, терминал, задачи), и переключаться на него нужно и при закрытой боковой панели. Список недавних — тот же, что у стартового окна.
Работа с файлами#
Файлы и папки создаются, переименовываются (вводом прямо в строке дерева)
и удаляются в корзину; те же действия — в контекстном меню строки. Ввод a/b/c.txt создаёт всю
цепочку папок. Перетаскивание переносит файл или целую выделенную группу; с Ctrl (на macOS —
Alt) — копирует, и копия не перетирает существующее. «Обновить» перечитывает папки, не схлопывая
дерево: раскрытые папки и выделение остаются на месте.
Выделение#
Ctrl/Cmd+клик добавляет или снимает строку, Shift+клик выделяет диапазон,
Del удаляет всю группу одним вопросом.
Открытие вне приложения#
Из контекстного меню строки: «Открыть в системном проводнике»,
«Открыть внешней программой», «Открыть терминал в папке» (встроенная панель поднимается
в каталоге выбранного) и «Открыть терминал системы» (свой задаётся переменной $TERMINAL).
Копирование пути — тоже из меню строки; у группы копируются все пути, по одному на строку.
Быстрое открытие файла (Ctrl+Shift+O) — список файлов проекта с отбором по подпоследовательности
символов: «qjs» находит quick-js. Совпадение в имени файла весит больше, чем в пути.
Поиск и замена по проекту (Ctrl+Shift+F) — с регулярными выражениями и маской файлов.
Рядом с поиском поле «Чем заменить» и кнопка «Заменить все». Область поиска переключается
на «Открытые вкладки» — тогда поиск идёт по тексту документов в памяти (видно и несохранённые
правки), но замена в этом режиме недоступна.
Поиск по структуре#
Поиск символа по проекту (Ctrl+T — имя класса, функции, переменной),
«Где экспортируется» — файлы, где имя под курсором объявлено экспортом, «Кто наследует тип»
и «От кого наследует тип» — по родителям объявления.
Объявления всех файлов проекта (Python и Node.js) IDE держит собранными зараннее и сохраняет между запусками. Поэтому поиск по структуре отвечает сразу после открытия проекта, а пока языковой сервер ещё разбирается или вовсе недоступен — находит по этой же карте.
В карту попадают и установленные зависимости — пакеты node_modules и библиотеки окружения
Python (включая общее окружение вне проекта). Их классы и функции находятся так же, но идут в
списке ниже своих и подписаны именем пакета; открываются такие файлы только на чтение.
Пометки git в дереве: буква у файла и точка у папки, внутри которой есть правки; в подсказке —
сколько правок внутри. Цветом помечается и весь путь к правке. Несохранённые документы тоже
показываются изменёнными, а удалённые и ещё не закоммиченные файлы остаются зачёркнутой строкой
с буквой D. Игнорируемые git файлы показываются приглушённо (настройка explorer.dimIgnored).
Пометки обновляются сами, в том числе после чужого коммита из терминала. Добавить файл
в .gitignore можно прямо из меню строки.
Подсветка недавно изменённых#
Файл, тронутый в пределах окна (explorer.recentChanges,
по умолчанию сутки), получает точку свежести — это про время правки, а не про правки с коммита.
Просмотр без открытия (Пробел на выделении или «Просмотр» в меню строки) — копия кода файла
«на месте», вкладок не трогает; стрелками листаются файлы, Enter уводит насовсем, Escape
закрывает.
Сравнение файлов и папок#
Два выделенных файла дают «Сравнить», один — «Сравнить с…» (файл подбирается быстрым открывателем). Две папки дают «Сравнить папки»: окно показывает различающиеся файлы, а клик по строке открывает их сравнение.
Локальная история файла (file.history): прежнее содержимое откладывается при каждой
перезаписи и перед удалением; окно показывает версии (время, возраст, размер, причину), даёт
предпросмотр и возврат выбранной. История хранится вне проекта, рядом с беседами.
Связанные файлы (file nesting)#
Button.module.css и Button.test.tsx сворачиваются
под Button.tsx. Правила по умолчанию есть для JS, TS, Python, Go и Ruby, свои задаёт настройка
explorer.fileNesting.
Автосохранение (настройка editor.autoSave): выключено, «через паузу после правки»,
«при переходе к другому файлу», «при потере фокуса окна». Если файл изменён на диске, автосохранение
его не перезаписывает, а сообщает, что пропустило.
Горячий выход#
Несохранённые правки уходят в сессию проекта и возвращаются при следующем открытии; файл на диске при этом не трогается, вкладка помечена «не сохранён». Размер и число таких буферов ограничены. Вернуть файл к версии на диске можно командой «Перечитать с диска» — она отбрасывает правки в буфере с подтверждением, где перечислено, что потеряется.
Большие проекты#
Дерево рисует только строки вокруг видимой части, поэтому папка в несколько
тысяч файлов остаётся отзывчивой. Симлинки показываются значком-стрелкой: ссылка на папку
раскрывается, на файл — открывается, битая помечена. В монорепо пакеты можно поднять строками
верхнего уровня (explorer.groupByPackage) — packages/api показывается как @demo/api,
а промежуточный каталог скрывается.
Группировка и сортировка#
Порядок строк настраивается: имя, тип файла, время изменения,
пометки git. Группировка по назначению (explorer.groupByType, выключена по умолчанию) собирает
файлы под полками «Тесты», «Стили», «Документация», «Конфигурация», «Ресурсы», «Исходники».
Избранное и закрепление#
Постоянные места — отдельным блоком над деревом (настройка
workspace.favorites): живут в настройках приложения, переживают смену проекта и могут указывать
на папку вне области. Закреплённые файлы и папки собираются в блоке сверху дерева. Метка файла —
цветной ярлык из подменю «Метка»; закладки на строки живут в редакторе.
Настройки на каждую папку#
У корня области могут быть свои отличия от общих: что скрыто, как сортируется, что помечается (окно «Настройки папки…» в меню строки корня).
Удалённые папки#
Адреса ssh://, wsl:// и container://; ходит туда клиент системы — ssh,
wsl, docker. Папки видны блоком «Удалённые папки» в дереве, файл открывается своим окном
с записью. Адрес задаётся настройкой workspace.remoteRoots или командой «Подключить удалённую
папку…». Строка папки различает три состояния: «Читаю…», красное «Не удалось прочитать — проверьте
адрес и доступ» и «Папка пуста». По удалённым путям не работают слежение за папкой, пометки git,
индексация и запуск, поэтому такая папка открывается отдельным окном, а не вкладкой.
Сторонние значки поверх дерева: правила «маска → подпись и цвет». Набор приносит человек —
файлом (команда «Набор значков дерева из файла…») или настройкой explorer.badges.
Раздел взят из README приложения версии 0.3.57. Нашли расхождение с приложением — скажите о нём, и раздел поправят вместе с приложением.