многокорневых рабочих областей в Visual Studio Code

Редактировать

Вы можете работать с несколькими папками проекта в Visual Studio Code с многокорневыми рабочими пространствами. Это может быть полезно, когда вы одновременно работаете над несколькими связанными проектами. Например, у вас может быть репозиторий с документацией по продукту, который вы хотите обновлять при обновлении исходного кода продукта.

Примечание . Если вы хотите узнать больше о концепции «рабочей области» VS Code, см. статью Что такое «рабочая область» VS Code? Если вы явно не создаете многокорневую рабочую область, «рабочая область» — это просто единственная корневая папка вашего проекта.

Добавление папок

В существующую рабочую область легко добавить еще одну папку. Есть несколько жестов для добавления папок:

Добавить папку в рабочую область

Файл > Команда «Добавить папку в рабочее пространство» вызывает диалоговое окно «Открыть папку» для выбора новой папки.

После добавления корневой папки проводник отобразит новую папку как корневую в проводнике. Вы можете щелкнуть правой кнопкой мыши любую из корневых папок и использовать контекстное меню для добавления или удаления папок.

Проводник должен работать и вести себя как прежде. Вы можете перемещать файлы между корневыми папками и использовать любые типичные действия с файлами, предусмотренные в контекстном меню и представлении проводника.

Такие параметры, как files.exclude , поддерживаются для каждой корневой папки, если они настроены, и для всех папок, если они настроены как глобальные пользовательские настройки.

Перетаскивание

Вы можете использовать перетаскивание для добавления папок в рабочее пространство. Перетащите папку в проводник, чтобы добавить ее в текущую рабочую область. Вы даже можете выбрать и перетащить несколько папок.

Примечание . Перетаскивание одной папки в область редактора VS Code по-прежнему будет открывать папку в режиме одной папки. Если вы перетащите несколько папок в область редактора, будет создана новая рабочая область с несколькими корнями.

Вы также можете использовать перетаскивание для изменения порядка папок в рабочей области.

Множественный выбор собственных диалогов открытия файлов

Открытие нескольких папок с помощью собственного диалогового окна открытия файлов вашей платформы создаст рабочую область с несколькими корнями.

командная строка —add

Добавить папку или несколько папок в последний активный экземпляр VS Code для многокорневой рабочей области.

 код --добавить vscode vscode-docs
 

Удаление папок

Вы можете удалить папку из рабочей области с помощью Удалить папку из рабочей области Команда контекстного меню.

Файл рабочей области

Когда вы добавляете несколько папок, они изначально помещаются в рабочую область с названием UNTITLED WORKSPACE , и это имя останется до тех пор, пока вы не сохраните рабочую область. Вам не нужно сохранять рабочее пространство, пока вы не захотите разместить его в постоянном месте, например, на рабочем столе. Безымянные рабочие области присутствуют до тех пор, пока открыт экземпляр VS Code, который они используют. После того, как вы полностью закроете экземпляр с безымянным рабочим пространством, вам будет предложено сохранить его, если вы планируете открывать его снова в будущем:

При сохранении рабочей области будет создан файл .code-workspace , и имя файла будет отображаться в проводнике.

Сохранить рабочее пространство как…

Если вы хотите переместить файл рабочего пространства в новое место, вы можете использовать команду Файл > Сохранить рабочее пространство как , которая автоматически установит правильные пути к папкам относительно нового Расположение файла рабочей области.

Открытие файлов рабочей области

Чтобы повторно открыть рабочую область, вы можете:

• Дважды щелкните файл . code-workspace в Проводнике вашей платформы.
• Используйте команду File > Open Workspace и выберите файл Workspace.
• Выберите рабочую область из списка Файл > Открыть последние (⌃R (Windows, Linux Ctrl+R)).
  • Рабочие области имеют суффикс (Рабочая область) , чтобы отличать их от папок.

Так же, как Закрыть папку , когда в VS Code открыта одна папка, есть команда Закрыть рабочую область (⌘K F (Windows, Linux Ctrl+K F)) для закрытия активной рабочей области.

Схема файла рабочей области

Схема .code-workspace довольно проста. У вас есть массив папок с абсолютными или относительными путями. Относительные пути лучше использовать, если вы хотите поделиться файлами рабочей области.

Вы можете переопределить отображаемое имя ваших папок с помощью name атрибут, чтобы давать более понятные имена папкам в Проводнике. Например, вы можете назвать папки своего проекта, например, «Продукт» и «Документация», чтобы легко идентифицировать содержимое по имени папки:

 {
  "папки": [
    {
      // Исходный код
      "имя": "Товар",
      "путь": "vscode"
    },
    {
      // Документы и примечания к выпуску
      "имя": "Документация",
      "путь": "vscode-документы"
    },
    {
      // Генератор расширений Yeoman
      "name": "Генератор расширений",
      "путь": "код-генератора vscode"
    }
  ]
}
 

, что приведет к следующему отображению проводника:

Как видно из приведенного выше примера, вы можете добавлять комментарии к файлам рабочей области.

Файл рабочей области также может содержать глобальные настройки рабочей области в разделе settings и рекомендации по расширению в разделе extensions , которые мы обсудим ниже.

Общий пользовательский интерфейс

Редактор

В пользовательском интерфейсе VS Code есть лишь несколько изменений при использовании многокорневых рабочих пространств, в первую очередь для устранения неоднозначности файлов между папками. Например, если есть конфликт имен между файлами в нескольких папках, VS Code будет включать имя папки в заголовки с вкладками.

Если вы всегда хотите, чтобы папка отображалась в заголовке с вкладками, вы можете использовать настройку workbench.editor.labelFormat «средние» или «длинные» значения для отображения папки или полных путей.

 "workbench.editor.labelFormat": "средний"
 

Пользовательский интерфейс VS Code, такой как списки OPEN EDITORS и Quick Open (⌘P (Windows, Linux Ctrl+P)) включают имя папки.

Если вы используете тему значков файлов и активная тема поддерживает ее, вы увидите специальный значок рабочей области.

Ниже вы можете увидеть значки рабочей области из встроенного Minimal (Visual Studio Code) темы значков файлов:

Поиск

Функции VS Code, такие как глобальный поиск, работа во всех папках и группировка результатов поиска по папкам .

Если у вас открыто многокорневое рабочее пространство, вы можете выбрать поиск в одной корневой папке, используя синтаксис ./ в файлах , чтобы включить поле . Например, если вы введете ./project1/**/*.txt , который будет искать все файлы .txt в корневой папке project1/.

Настройки

При наличии нескольких корневых папок в одной рабочей области можно иметь папку .vscode в каждой корневой папке, определяющую параметры, которые должны применяться к этой папке. Чтобы избежать конфликтов настроек, при использовании многокорневой рабочей области применяются только настройки ресурса (файла, папки). Параметры, влияющие на весь редактор (например, макет пользовательского интерфейса), игнорируются. Например, два проекта не могут одновременно устанавливать уровень масштабирования.

Пользовательские настройки поддерживаются так же, как и для проектов с одной папкой, и вы также можете установить глобальные настройки рабочей области, которые будут применяться ко всем папкам в вашей многокорневой рабочей области. Глобальные настройки рабочей области будут храниться в файле .code-workspace .

 {
  "папки": [
    {
      "путь": "vscode"
    },
    {
      "путь": "vscode-документы"
    },
    {
      "путь": "код-генератора vscode"
    }
  ],
  "настройки": {
    "window.zoomLevel": 1,
    "files.autoSave": "послезадержки"
  }
}
 

Когда вы переходите от экземпляра одной папки к нескольким папкам, VS Code добавит соответствующие настройки всего редактора из первой папки в новые глобальные настройки рабочей области.

Вы можете легко просматривать и изменять различные файлы настроек с помощью редактора настроек. Вкладки редактора настроек позволяют выбрать настройки пользователя, глобальные настройки рабочей области и настройки отдельных папок.

Вы также можете открыть определенные файлы настроек с помощью команд:

• Настройки: открыть настройки пользователя — открыть глобальные настройки пользователя
• Настройки: Открыть настройки рабочей области — Откройте раздел настроек в файле рабочей области.
• Настройки: Открыть настройки папки — Открыть настройки для активной папки.

Глобальные настройки рабочей области имеют приоритет над настройками пользователя, а настройки папки могут иметь приоритет над настройками рабочей области или пользователя.

Неподдерживаемые настройки папки

Неподдерживаемые настройки папки для всего редактора будут отображаться серым цветом в настройках папки и отфильтровываться из НАСТРОЙКИ ПАПКИ ПО УМОЛЧАНИЮ список. Вы также увидите информационный значок перед настройкой.

Отладка

В многокорневых рабочих пространствах VS Code ищет во всех папках launch.json файлы конфигурации отладки и отображает их с именем папки в качестве суффикса. Кроме того, VS Code также отображает конфигурации запуска, определенные в файле конфигурации рабочей области.

В приведенном выше примере показаны конфигурации отладки для расширения TSLint. есть запустите конфигурацию из папки расширения tslint , чтобы запустить расширение, работающее на хосте расширений VS Code, а также конфигурацию прикрепите из папки tslint-server , чтобы подключить отладчик к работающему серверу TSLint.

Вы также можете увидеть три команды Add Config для папок, tslint , tslint-server и tslint-tests в рабочей области vscode-tslint. Конфигурация добавления 9Команда 0114 либо откроет существующий файл launch.json в подпапке .vscode , либо создаст новый и отобразит раскрывающийся список шаблонов конфигурации отладки.

Переменные, используемые в конфигурации (например, ${workspaceFolder} или устаревшая ${workspaceRoot} ) разрешаются относительно папки, которой они принадлежат. Можно определить область действия переменной для папки рабочей области, добавив к переменной имя корневой папки (разделенное двоеточием).

Конфигурации запуска рабочей области

Конфигурации запуска рабочей области находятся в разделе «запуск» файла конфигурации рабочей области ( Рабочие области: Открыть файл конфигурации рабочей области в палитре команд):

Кроме того, новые конфигурации запуска могут можно добавить с помощью пункта «Добавить конфигурацию (рабочее пространство)» в раскрывающемся меню «Конфигурация запуска»:

Составная конфигурация запуска может ссылаться на отдельные конфигурации запуска по имени, если имена уникальны в пределах рабочей области, например:

 "соединения": [{
      "name": "Запустить сервер и клиент",
      "конфигурации": [
        «Запуск сервера»,
        «Запуск клиента»
      ]
  }]
 

Если имена отдельных конфигураций запуска не уникальны, соответствующая папка может быть указана с более подробным синтаксисом «папки»:

 «составные»: [{
      "name": "Запустить сервер и клиент",
      "конфигурации": [
        «Запуск сервера»,
        {
          "папка": "Веб-клиент",
          "name": "Запустить клиент"
        },
        {
          "folder": "Настольный клиент",
          "name": "Запустить клиент"
        }
      ]
  }]
 

В дополнение к соединениям раздел запуска файла конфигурации рабочей области также может содержать обычные конфигурации запуска. Убедитесь, что все используемые переменные явно связаны с определенной папкой, поскольку в противном случае они недействительны для рабочей области. Дополнительные сведения о переменных с явно заданной областью действия можно найти в Справочнике по переменным.

Вот пример конфигурации запуска, в которой программа находится в папке «Программа» и где все файлы из папки «Библиотека» должны быть пропущены при пошаговом выполнении:

 "запуск": {
  "конфигурации": [{
      "тип": "узел",
      "запрос": "запустить",
      "name": "Запустить тест",
      "program": "${workspaceFolder:Program}/test.js",
      "пропустить файлы": [
        "${workspaceFolder:Library}/out/**/*.js"
      ]
  }]
}
 

Задачи

Подобно тому, как VS Code выполняет поиск конфигураций отладки, VS Code также попытается автоматически определить задачи из файлов проектов gulp, grunt, npm и TypeScript во всех папках в рабочей области, а также выполнить поиск задач, определенных в tasks. json файлов. Расположение задач указывается суффиксом имени папки. Обратите внимание, что задачи, определенные в файле tasks.json , должны иметь версию 2.0.0.

Из приведенного выше примера рабочей области расширения TSLint видно, что есть две настроенные задачи из файлов tasks.json в папках tslint и tslint-tests и множество автоматически обнаруженных n pm и компилятор TypeScript обнаружены задачи .

Конфигурация задач рабочей области

Задачи области рабочей области находятся в разделе «задачи» файла конфигурации рабочей области ( Рабочие области: откройте файл конфигурации рабочей области в палитре команд). Только задачи типа "оболочка" и "процесс" могут быть определены в файле конфигурации рабочей области.

Система управления версиями

В многокорневых рабочих пространствах имеется раздел ПОСТАВЩИКИ УПРАВЛЕНИЯ ИСТОЧНИКАМИ , который дает обзор при наличии нескольких активных репозиториев. Они могут быть предоставлены несколькими поставщиками SCM; например, у вас могут быть репозитории Git рядом с рабочими областями Azure DevOps Server. Когда вы выбираете репозитории в этом представлении, вы можете увидеть детали системы управления версиями ниже.

Вы можете использовать Ctrl+щелчок или Shift+щелчок для выбора нескольких репозиториев. Их детали будут отображаться в виде отдельных областей внизу.

Расширения

Если вы являетесь автором расширения, вы можете ознакомиться с нашим руководством по внедрению API-интерфейсов рабочей области с несколькими корнями, чтобы узнать об API-интерфейсах рабочей области с несколькими корнями VS Code и о том, как сделать так, чтобы ваше расширение хорошо работало в нескольких папках.

Ниже приведены некоторые из популярных расширений, использующих API-интерфейсы многокорневой рабочей области.

Примечание . Если расширение еще не поддерживает несколько папок, оно все равно будет работать в первой папке вашей многокорневой рабочей области.

Рекомендации по расширению

VS Code поддерживает рекомендации по расширению на уровне папки через файлы extensions.json в подпапке .vscode папки. Вы также можете предоставить глобальные рекомендации по расширению рабочей области, добавив их в файл .code-workspace . Вы можете использовать 9Расширения 0113: настройте команду «Рекомендуемые расширения (папка рабочей области)», чтобы открыть файл рабочей области и добавить идентификаторы расширений ({publisherName}.{extensionName}) в массив extensions.recommendations .

 {
  "папки": [
    {
      "путь": "vscode"
    },
    {
      "путь": "vscode-документы"
    }
  ],
  "расширения": {
    "рекомендации": ["eg2.tslint", "dbaeumer.vscode-eslint", "esbenp.prettier-vscode"]
  }
}
 

Следующие шаги

• Что такое «рабочая область» VS Code? — Подробнее об однопапочных и многокорневых рабочих пространствах.

  No related posts.