chui_iDE

Проект и файлы

6 мин чтения 1040 слов 13 подразделов

Дерево проекта показывает файлы и папки; содержимое подгружается по мере раскрытия, набор раскрытых папок возвращается при следующем открытии проекта. Файл открывается по клику или двойному (выбор — настройка 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. Нашли расхождение с приложением — скажите о нём, и раздел поправят вместе с приложением.