Настройка git extensions на windows

Обновлено: 05.07.2024

Теперь, когда Git установлен в вашей системе, самое время настроить среду для работы с Git под себя. Это нужно сделать только один раз — при обновлении версии Git настройки сохранятся. Но, при необходимости, вы можете поменять их в любой момент, выполнив те же команды снова.

В состав Git входит утилита git config , которая позволяет просматривать и настраивать параметры, контролирующие все аспекты работы Git, а также его внешний вид. Эти параметры могут быть сохранены в трёх местах:

Файл [path]/etc/gitconfig содержит значения, общие для всех пользователей системы и для всех их репозиториев. Если при запуске git config указать параметр --system , то параметры будут читаться и сохраняться именно в этот файл. Так как этот файл является системным, то вам потребуются права суперпользователя для внесения изменений в него.

/.config/git/config хранит настройки конкретного пользователя. Этот файл используется при указании параметра --global и применяется ко всем репозиториям, с которыми вы работаете в текущей системе.

Файл config в каталоге Git (т. е. .git/config ) репозитория, который вы используете в данный момент, хранит настройки конкретного репозитория. Вы можете заставить Git читать и писать в этот файл с помощью параметра --local , но на самом деле это значение по умолчанию. Неудивительно, что вам нужно находиться где-то в репозитории Git, чтобы эта опция работала правильно.

Настройки на каждом следующем уровне подменяют настройки из предыдущих уровней, то есть значения в .git/config перекрывают соответствующие значения в [path]/etc/gitconfig .

В системах семейства Windows Git ищет файл .gitconfig в каталоге $HOME ( C:\Users\$USER для большинства пользователей). Кроме того, Git ищет файл [path]/etc/gitconfig , но уже относительно корневого каталога MSys, который находится там, куда вы решили установить Git при запуске инсталлятора.

Если вы используете Git для Windows версии 2.х или новее, то так же обрабатывается файл конфигурации уровня системы, который имеет путь C:\Documents and Settings\All Users\Application Data\Git\config в Windows XP или C:\ProgramData\Git\config в Windows Vista и новее. Этот файл может быть изменён только командой git config -f <file> , запущенной с правами администратора.

Чтобы посмотреть все установленные настройки и узнать где именно они заданы, используйте команду:

Имя пользователя

Первое, что вам следует сделать после установки Git — указать ваше имя и адрес электронной почты. Это важно, потому что каждый коммит в Git содержит эту информацию, и она включена в коммиты, передаваемые вами, и не может быть далее изменена:

Опять же, если указана опция --global , то эти настройки достаточно сделать только один раз, поскольку в этом случае Git будет использовать эти данные для всего, что вы делаете в этой системе. Если для каких-то отдельных проектов вы хотите указать другое имя или электронную почту, можно выполнить эту же команду без параметра --global в каталоге с нужным проектом.

Многие GUI-инструменты предлагают сделать это при первом запуске.

Выбор редактора

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

В случае с Notepad++, популярным редактором, скорее всего вы захотите установить 32-битную версию, так как 64-битная версия ещё не поддерживает все плагины. Если у вас 32-битная Windows или 64-битный редактор с 64-битной системой, то выполните следующее:

Vim, Emacs и Notepad++ — популярные текстовые редакторы, которые часто используются разработчиками как в Unix-подобных системах, таких как Linux и Mac, так и в Windows. Если вы используете другой редактор или его 32-битную версию, то обратитесь к разделу Команды git config core.editor за дополнительными инструкциями как использовать его совместно с Git.

В случае, если вы не установили свой редактор и не знакомы с Vim или Emacs, вы можете попасть в затруднительное положение, когда какой-либо из них будет запущен. Например, в Windows может произойти преждевременное прерывание команды Git при попытке вызова редактора.

Настройка ветки по умолчанию

Когда вы инициализируете репозиторий командой git init , Git создаёт ветку с именем master по умолчанию. Начиная с версии 2.28, вы можете задать другое имя для создания ветки по умолчанию.

Например, чтобы установить имя main для вашей ветки по умолчанию, выполните следующую команду:

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

Если вы хотите проверить используемую конфигурацию, можете использовать команду git config --list , чтобы показать все настройки, которые Git найдёт:

Некоторые ключи (названия) настроек могут отображаться несколько раз, потому что Git читает настройки из разных файлов (например, из /etc/gitconfig и

/.gitconfig ). В таком случае Git использует последнее значение для каждого ключа.

Также вы можете проверить значение конкретного ключа, выполнив git config <key> :

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

терминология

Для ознакомления с терминологией Git, пожалуйста, обратитесь к моей предыдущей статье .

Настройка рабочей станции / Visual Studio

В последнее время Microsoft, похоже, признает Git в качестве ценной альтернативы своей проприетарной TFS (Team Foundation Server) тому, что касается контроля версий, и поэтому начала выпускать свое собственное расширение Visual Studio, которое в настоящее время находится в фазе «предварительного просмотра». Вы можете найти его здесь: Visual Studio Tools for Git (Microsoft)

Скотт Хансельман также написал об этом. Я быстро попробовал плагин и, хотя он отлично интегрируется с Visual Studio (в основном, как TFS), он все еще слишком большой бета на мой вкус.

В настоящее время лучшая альтернатива, которую я нашел, — это установить Git Extensions для Windows и Git Source Control Provider Visual Studio Plugin. В следующих разделах рассматриваются соответствующие установки.

Установите Git Extensions для Windows

Первым шагом является загрузка Git Extensions из соответствующего Google Code Repository .

Его мастер установки установит все, что вам нужно для полной настройки Git, установки Git (из git-scm ) в различные инструменты Unix для Git Bash.

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

Вы найдете этот контрольный список при открытии приложения Git Extensions, а затем перейдя к Plugins > Settings .

Установка Git Source Control Provider

Git Source Control Provider — это расширение с открытым исходным кодом, которое использует установку Git вашей машины и интегрирует ее в Visual Studio.

Если вы успешно настроили Git (следуя процедуре, упомянутой выше), вы можете продолжить и установить расширение Git Source Control Provider для Visual Studio. Возможно, самый простой способ — через диалоговое окно «Расширения и обновления», в котором вам нужно просто выполнить поиск «git source control».

В качестве одного из следующих шагов вам нужно правильно установить провайдера исходного кода в Visual Studio, поскольку у вас их может быть больше (например, TFS). Это делается в настройках Visual Studio в разделе «Source Control»:

Вы должны увидеть запись «Git Source Control Provider». Выберите это и подтвердите ваши настройки. После этого вы также должны убедиться, что он правильно ссылается на ваши установки Git и Git Extensions:

Настройка вашего ключа SSH

Многие репозитории Git-сервера допускают разные модели аутентификации:

Лично я предпочитаю последнее, так как ненавижу постоянно вводить свои учетные данные.

Чтобы получить руководство по генерации открытого ключа SSH, просто обратитесь к документации по GitHub, которая довольно подробно и хорошо объяснена.

Ну, вот и все, что касается установки. Теперь вы должны быть готовы начать.

Давайте начнем: создайте новый Git-репозиторий

Прежде всего, я просто создаю проект консоли, так как основное внимание здесь уделяется не созданию чего-то приятного и работающего, а скорее демонстрации интеграции Git в Visual Studio. Как только проект создан, мы можем настроить локальный репозиторий Git.

Это можно сделать, щелкнув правой кнопкой мыши по решению и выбрав «Создать Git Repository»:

После этой операции вы должны увидеть репозиторий для успешной настройки:

Более того, вы должны увидеть некоторые файлы, перечисленные в окне ожидающих изменений в Git:

Просто щелкните их все, добавьте содержательный комментарий и подтвердите их, нажав кнопку «Подтвердить».

Git SCP (отныне ссылающийся на расширение Git Source Control Provider для VS) предоставляет очень удобный и удобный механизм для просмотра реальной ситуации в вашем Git-репозитории, а именно путем визуализации лежащего в его основе дерева Git. Просто нажмите кнопку «История» …

… В окне «Ожидающие изменения» откроется новое окно с красивым графиком:

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

.gitignore

Важным аспектом, который я не упомянул в предыдущем уроке по Git, является концепция файла .gitignore . Этот файл в основном содержит набор строк, указывающих, какие артефакты должны игнорироваться Git. Обычно это специфичные для IDE файлы или скомпилированные двоичные файлы.

Из коробки Git SCP уже создает тот, который подходит для Visual Studio. В противном случае вы можете обратиться к проекту Gitignore GitHub, который представляет собой набор файлов .gitignore для различных типов IDE и языков программирования.

Создать и зафиксировать новый файл

Просто добавьте новый файл в ваш проект Visual Studio. Я добавил Person.cs с некоторым контентом. Вы должны сразу увидеть изменения, перечисленные в окне Pending Changes.

Примечание. Вы можете открыть окно « Ожидающие изменения », щелкнув правой кнопкой мыши проект или файл решения Visual Studio и выбрав «Git (master)», а затем «Ожидающие изменения».

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

Наше дерево после коммита выглядит так:

Создать (особенность) ветку

Чтобы создать новую ветку, нажмите кнопку « Расширения Git» в окне ожидающих изменений, а затем « Создать ветку».

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

Примечание: мы также устанавливаем флажок «Оформить заказ после создания», и сразу же переключаемся на новую ветку. Это как-то похоже на git checkout -b <branch-name> команду на оболочке.

Диалоговое окно подтверждения показывает успешность операции и выполненную команду в оболочке.

Более того, в окне Pending Changes мы теперь видим текущую ветвь, в которой мы находимся, которая является только что созданной «my-feature-branch».

Теперь мы можем изменить существующий файл — скажем, наш Person.cs — и зафиксировать его. Окно Pending Changes точно показывает разницу изменений до того, как мы их передадим

После внесения изменений дерево продвинулось и обратите внимание, что сейчас master и my-feature-branch указывают на разные места. HEAD находится в нашей ветви функций, поскольку она является текущей активной.

Слияние и разрешение конфликтов

Вернемся к мастеру . Мы можем сделать это — снова — используя кнопку ветви Checkout из меню «Git Extensions».

Мы должны выбрать в master качестве нашего филиала и продолжить.

Примечание: есть варианты того, как вы хотите обрабатывать любые локальные изменения, которые еще не были зафиксированы, то есть хранить их.

Дерево Git отражает это переключение на master ветку, так как оно HEAD теперь правильно указывает master снова.

В этой статье объясняется, как установить клиентские средства Git и Visual Studio Code в интерактивном режиме.

Установка Git
Установка Visual Studio Code
Установка пакета создания документации.

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

Участникам, которые будут вносить значительные изменения, рекомендуется выполнить эти шаги. Это позволит им применить рабочий процесс по внесению значительных изменений или изменений, требующих длительного времени. Даже если у вас есть разрешения на запись в основном репозитории, настоятельно рекомендуется (и в этом руководстве предполагается, что вы это сделаете) создать вилку и клон репозитория, чтобы у вас были права на чтение и запись для хранения в этой вилке предлагаемых вами изменений.

Установка клиентских средств для Git

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

Установка клиентских средств Git для Windows

If you prefer a graphical user interface (GUI) over a command-line interface (CLI), Visual Studio Code, Software Freedom Conservancy's available GUI Clients page, and GitHub's GitHub Desktop offer that functionality.

Run the downloaded executable (.EXE) file and follow the prompts to install. Select Next at each prompt to accept all default settings.

Select Finish to complete the installation.

After installing the Git for Windows, you'll have to configure your Git name and your email address, before installing Visual Studio Code.

Git on Windows: Enable long path names. By default, Git for Windows disables support for long filepaths, which prevents any file with a destination path longer than 255 characters from being cloned. Enable long filepaths to avoid this issue by running the following command as an administrator:
git config --global core.longpaths true

Установка клиентских средств Git для Mac и Linux

Git для Mac предоставляется как часть средств командной строки Xcode. Просто запустите git из командной строки. При необходимости вам будет предложено установить средства командной строки. Вы также можете скачать Git для Mac из Software Freedom Conservancy.

Следуйте инструкциям по установке и настройке для выбранного клиента.

Установка Visual Studio Code

Visual Studio Code (также называется VS Code) — это простой редактор, который работает в Windows, Linux и Mac. Он включает интеграцию с Git и поддержку расширений.

Чтобы запустить VS Code и открыть текущую папку, выполните команду code . в командной строке или оболочке Bash. Если текущая папка содержится в локальном репозитории Git, в Visual Studio Code автоматически отобразятся данные об интеграции с GitHub.

Установка Visual Studio Code для Windows, Mac и Linux

. На главной странице VS Code должна правильно определиться ваша операционная система:

Установка расширений Visual Studio Code

To install the extensions:

Start Visual Studio Code.

Select the square Extensions icon on the left nav. The Extensions: Marketplace pane appears.

In the Search Extensions in the Marketplace search box, type the name of an extension you want to find.

In the results that appear, locate the extension you want and select Install.

Установка пакета создания документации.

The Docs Authoring Pack for Visual Studio Code includes basic Markdown authoring assistance, page previews, support for Markdown templates, markdownlint, and Code Spell Checker. These features ease and streamline the contributions process. As such, we consider the Docs Authoring Pack a required extension for contributors.

To install the Docs Authoring Pack, choose Install from the Docs Authoring Pack page in the VS Code Marketplace.

To use the Docs Authoring Pack functionality, press Alt+M in Visual Studio Code. To configure a toolbar to show the functions available, edit the Visual Studio Code settings (Control+comma), and add user setting "markdown.showToolbar": true .

Сведения о редакторах Markdown

Markdown — это упрощенный язык разметки, используемый для создания содержимого. Visual Studio Code — предпочтительное средство для редактирования разметки Markdown в Майкрософт. Atom — еще одно популярное средство для редактирования разметки Markdown. Основные сведения о Markdown и функциях, которые поддерживаются настраиваемыми расширениями OPS для Markdown, см. в статье Справочник по Markdown.

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

Однако, поскольку для некоторых это может сбивать с толку, вот руководство, в котором обсуждается Git и демонстрируются шаги по установке и настройке Git в Windows.

Что такое Git и зачем он вам нужен?

Будучи DVCS, Git не имеет централизованного репозитория. Вместо этого, когда кто-то клонирует репозиторий Git, он полностью отображается на компьютере этого человека вместе с полной историей изменений, когда-либо внесенных в него.

Используя Git, вы можете быстро и эффективно управлять всеми своими проектами и сотрудничать с другими разработчиками в режиме реального времени, не рискуя случайно изменить исходный код (или файлы проекта).

Ниже приведены некоторые из причин, по которым вам нужно использовать Git:

Как установить Git в Windows

Git можно установить в Windows несколькими способами. Вы можете использовать автоматическую установку или воспользоваться преимуществами Шоколадный менеджер пакетов чтобы установить Git через командную строку или установить его в каталог из источника последней версии.

1. Установка Git с помощью Chocolatey

Чтобы использовать Chocolatey, вам сначала необходимо установить его на свой компьютер. Для этого откройте командную строку Windows с правами администратора и выполните следующую команду:

@"%SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exe" -NoProfile -InputFormat None -ExecutionPolicy Bypass -Command "[System.Net.ServicePointManager]::SecurityProtocol = 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))" && SET "PATH=%PATH%;%ALLUSERSPROFILE%\chocolatey\bin"

В качестве альтернативы вы можете запустить PowerShell с правами администратора и запустить:

@"%SystemRoot%System32WindowsPowerShellv1.0powershell.exe" -NoProfile -InputFormat None -ExecutionPolicy Bypass -Command "[System.Net.ServicePointManager]::SecurityProtocol = 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))" && SET "PATH=%PATH%;%ALLUSERSPROFILE%chocolateybin"

После установки Chocolatey перезапустите CMD или PowerShell. Теперь введите команду ниже и

нажмите Enter, чтобы установить Git на свой компьютер:
choco install git.install

Следуйте инструкциям, чтобы завершить установку. По завершении используйте следующую команду для проверки установки:
git --version

Чтобы обновить Git, запустите:
choco upgrade git.install

Если вам неудобно работать с интерфейсом командной строки, вы можете использовать установщик Git для установки Git на свой ПК с Windows. Для этого сначала загрузите установщик Git по ссылке ниже.

После загрузки запустите файл. В окне « Контроль учетных записей» нажмите « Да», чтобы открыть окно установки.

Нажмите « Далее», чтобы продолжить настройку.

В окне « Выбор компонентов» установите флажки для дополнительных значков , интеграции с Windows Explorer ( Git Bash и Git GUI ) и « Добавить профиль Git Bash в терминал Windows» . Кликните Далее .

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

По умолчанию Git настроен на использование текстового редактора Vim, но, поскольку для некоторых это может напугать, есть другие текстовые редакторы на выбор, такие как Atom, Notepad ++, Visual Studio Code и Sublime Text. Выберите один и нажмите Далее.

Затем вам нужно установить имя по умолчанию для начальной ветки, которую вы создаете в своих репозиториях. Выбор «Разрешить Git решать, использует мастер», что и используется большинством людей.

Однако вы можете установить собственное имя, выбрав «Заменить имя ветки по умолчанию для новых репозиториев» и введя имя в текстовое поле ниже. После выбора нажмите «Далее».

На экране « Настройка среды PATH» выберите Git из командной строки, а также из стороннего программного обеспечения .

Это позволит вам использовать Git из Git Bash, командной строки, PowerShell или любого другого программного обеспечения. Кликните Далее, чтобы продолжить.

Выберите Использовать библиотеку OpenSSL в качестве транспортного сервера для проверки сертификатов сервера и нажмите Далее .

Теперь выберите MinTTY (терминал MSYS2 по умолчанию) для лучшей совместимости и нажмите « Далее» .

Для поведения git pull по умолчанию выберите «По умолчанию» (быстрая перемотка вперед или слияние). С этим параметром, когда вы используете git pull, он будет быстро перематывать текущую ветку к марке извлечения, когда это возможно. Если нет, он создаст фиксацию слияния. Нажмите Далее, чтобы продолжить.

Когда вас попросят выбрать помощника по учетным данным, выберите Git Credential Manager Core и нажмите Далее .

На экране дополнительных параметров установите флажок « Включить кэширование файловой системы», чтобы ускорить операции Git, и нажмите « Далее» . Если вы хотите, вы также можете выбрать Включить символические ссылки, чтобы улучшить разрешение имени пути.

Не выбирайте экспериментальные функции и нажмите « Установить», чтобы начать установку Git на свой компьютер. По завершении нажмите « Готово» .

Теперь, чтобы убедиться, что Git установлен, запустите Git Bash. В качестве альтернативы откройте CMD с правами администратора и запустите:
git --version

Если он возвращает номер версии, это означает, что Git установлен и готов к использованию.

Как настроить Git в Windows

Настройка идентификации пользователя

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

Здесь опция –global установит вашу личность по умолчанию для всех репозиториев. Однако, если вы хотите установить его для определенного репозитория, вы можете сделать это, зайдя в эту папку репозитория и запустив команду без опции –global .

После этого проверьте изменения, запустив:
git config --list

Кроме того, вы также можете получить доступ к файлу конфигурации Git, перейдя в C: \ Users \ user_name \ и найдя файл .gitconfig .

Настройка SSH для Git в Windows

SSH (безопасная оболочка) это протокол для безопасной сетевой связи между двумя системами. Использование SSH с Git позволяет безопасно перемещать файлы между вашим ПК и репозиториями Git и удаленно выполнять различные команды Git по защищенному каналу.

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

Чтобы сгенерировать SSH-ключ, откройте Git Bash и выполните следующую команду:
ssh-keygen -t rsa -b 4096 -C "your_email_address"

Затем вам будет предложено подтвердить место для хранения ключа SSH. Нажмите Enter, чтобы продолжить с местоположением по умолчанию. Теперь вам нужно установить парольную фразу, чтобы добавить дополнительный уровень безопасности к SSH. Введите надежный пароль и нажмите Enter .

Наконец, теперь вам нужно добавить ключ SSH к агенту SSH. Для этого вам сначала нужно включить OpenSSH. Для этого откройте диспетчер задач ( Ctrl + Shift + Esc ), кликните вкладку « Службы » и нажмите « Открыть службы» внизу.

Теперь откройте CMD в повышенном режиме и запустите:
start-ssh-agent

После того, как агент SSH будет запущен, перейдите в Git Bash и выполните команду ниже, чтобы добавить ключ SSH, сгенерированный несколькими шагами ранее:
ssh-add

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

Успешное управление вашими проектами с помощью Git

Если вы внимательно следовали этому руководству, у вас должен быть установлен и запущен Git на вашем компьютере с Windows. И впоследствии вы сможете использовать его для управления всеми файлами своего проекта и сотрудничества с другими разработчиками (если вы работаете в команде).

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

Читайте также: