List Issues Suggestions1 Discussions Insights

🧙 Садовник: уточнил шаги, добавил проверки и обоснования. Примите, если полезно.

open+2−10~10⇅2proposed by devops · Aug 8, 2026 · based on v4

Conversation Checks Proposed changes24 Result

Result · becomes v5

Выбрать место для проектаRecommended

Создай короткий путь без пробелов, кириллицы и облачной синхронизации. Это снизит шанс странных проблем с путями и доступом.

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

–Папка будет лежать не на Рабочем столе
–Путь не содержит пробелов и кириллицы

Проверить пакетный менеджерRecommended

Windows: winget уже встроен в систему. Проверь командой ниже.

macOS: поставь Homebrew — команда установки есть на главной странице. После установки выполни две строки, которые он напечатает для PATH, иначе brew может не попасть в терминал.

Why: Пакетный менеджер ставит программы одной командой и потом обновляет их все разом. Главное — такую установку можно записать и повторить на другой машине, а «скачать и кликнуть далее» — нельзя.

code

1winget --version

–Команда пакетного менеджера твоей системы отвечает версией
–На macOS выполнены строки про PATH после установки

Homebrew — установка (macOS)

Установить VS Code

Windows: команда ниже. При ручной установке отметь галочку Add to PATH.

macOS: brew install --cask visual-studio-code. При ручной установке перенеси приложение в Applications.

Why: VS Code — редактор, который становится полноценной средой разработки за счёт расширений. В отличие от тяжёлой IDE, ты сам решаешь, что в нём будет.

code

1winget install Microsoft.VisualStudioCode

–VS Code запускается
–В окне About видна версия редактора

Скачать VS Code Настройка на macOS

Проверить, что команда code доступна в терминале

Открой новый терминал — старый не знает об изменении PATH.

Windows: если команда не найдена, переустанови VS Code с галочкой Add to PATH.

macOS: открой VS Code, нажми Cmd+Shift+P и выполни команду Shell Command: Install 'code' command in PATH.

Why: Дальше мы будем ставить расширения командами. Без `code` в PATH придётся кликать мышью по магазину расширений, а такую настройку невозможно повторить на другой машине.

code

1code --version

–Команда напечатала три строки: версию, хеш коммита и архитектуру
–Терминал был открыт заново после установки

Проверка версии VS Code

Поставить расширение Python

Команда одинаковая на Windows и macOS.

Расширение даёт подсветку, переход к определению, запуск и отладку. Вместе с ним автоматически приезжает Pylance — проверка типов и автодополнение.

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

code

1code --install-extension ms-python.python

–В панели Extensions расширение Python отмечено как установленное
–Появился Pylance как зависимость

Python на Marketplace

Поставить Ruff

Команда одинаковая на обеих системах.

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

Why: Форматтер отвечает за единообразие (отступы, кавычки, переносы), линтер — за подозрительные места (неиспользуемая переменная, затенение имени). Разные задачи, но здесь один инструмент.

code

1code --install-extension charliermarsh.ruff

–Ruff виден в списке установленных расширений

Ruff на Marketplace Документация Ruff

Поставить Docker и GitLensRecommended

Команда одинаковая на обеих системах.

Docker покажет контейнеры и их логи прямо в редакторе. GitLens показывает, кто и когда менял конкретную строку.

Why: Оба нужны не сразу, но ставятся один раз. GitLens особенно полезен, когда начнёшь разбираться в чужом коде: строка перестаёт быть безымянной.

code

1code --install-extension ms-azuretools.vscode-docker --install-extension eamodio.gitlens

–Оба расширения в списке установленных

Docker на Marketplace GitLens на Marketplace

Открыть встроенный терминал

Windows: Ctrl + ` (клавиша с обратным апострофом, слева от единицы).

macOS: Ctrl + ` (именно Control, не Command).

Либо меню View → Terminal на обеих системах.

Why: Отдельное окно консоли — лишнее переключение и лишний шанс запустить команду не в той папке. Встроенный терминал открывается сразу в папке проекта.

–Терминал открылся в нижней части окна редактора
–В нём виден путь к текущей папке

Понять, какая оболочка запущена

В правом верхнем углу панели терминала написано имя оболочки. Запомни его.

Windows: обычно PowerShell, реже Command Prompt или Git Bash.

macOS: по умолчанию zsh. Проверить можно командой echo $SHELL.

Why: Оболочки ведут себя по-разному: разный синтаксис переменных, разные кавычки, разные разделители в путях. PowerShell отличается сильно, а команды из статей часто написаны под bash.

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

Проверить Python

Нужна версия 3.12 или новее.

Windows: команда python --version. Ставь Python с python.org, не из Microsoft Store. При установке отметь Add python.exe to PATH.

macOS: команда python3 --version — именно python3. Системный Python старый и трогать его нельзя — ставь свой: brew install python@3.12 либо позже через uv python install 3.12.

Why: На Windows версия из Microsoft Store работает в песочнице: часть инструментов её не находит. На macOS опасность другая: системный Python используется самой системой, и установка в него пакетов может сломать системные утилиты.

code

1python --version

–Команда напечатала версию 3.12 или выше
–Это не системный Python и не версия из Microsoft Store

Скачать Python Python для macOS

Убедиться, что запускается именно тот Python

Команда покажет все найденные интерпретаторы в порядке приоритета. Первый в списке — тот, который запустится.

Windows: where python

macOS: which -a python3

Why: На машине часто оказывается несколько Python: системный, от пакетного менеджера, из старой установки. Запускается первый по PATH, и пакет, поставленный в одно окружение, «пропадает» при запуске из другого.

code

1where python

–Ты видишь список найденных интерпретаторов
–Понимаешь, какой из них запускается по умолчанию

Проверить git

Windows: при установке можно оставить настройки по умолчанию — вместе с git приедет Git Bash.

macOS: проще всего xcode-select --install — git входит в Command Line Tools. Либо свежее версией: brew install git.

Why: Git — не «сохранялка файлов», а машина времени. Без него любая попытка что-то поменять сопровождается страхом сломать работающее; с ним эксперимент бесплатен.

code

1git --version

–Команда напечатала версию git

Скачать git git для macOS

Проверить Docker

Windows: скачать с сайта или winget install Docker.DockerDesktop.

macOS: brew install --cask docker-desktop. При ручной загрузке выбери правильную сборку: Apple Silicon для M1–M4 или Intel для старых машин. Посмотреть свой процессор: через «Об этом Mac».

На обеих системах Docker должен быть не просто установлен, а запущен — значок кита в трее или в верхней панели.

Why: Типичная ловушка: Docker установлен, но не запущен, и команды падают с невнятной ошибкой про подключение к демону. Проверять надо не наличие программы, а её работу.

code

1docker run --rm hello-world

–Команда скачала образ и напечатала приветствие
–Значок Docker активен, а не серый
–На macOS скачана сборка под свой процессор

Скачать Docker Desktop Через Homebrew (macOS)

Установить uv

Windows: winget install astral-sh.uv

macOS: brew install uv либо официальный установщик: curl -LsSf https://astral.sh/uv/install.sh | sh

После установки закрой терминал и открой заново.

Why: uv — единый инструмент: ставит сам Python, управляет зависимостями, запускает команды проекта. Заменяет связку из нескольких и работает очень быстро.

code

1winget install astral-sh.uv

–Установка завершилась без ошибок
–Терминал открыт заново после установки

Установка uv — все системы Документация uv

Проверить uv

Команда одинаковая на обеих системах.

Если команда не найдена, терминал ещё помнит старый PATH. Закрой все терминалы и открой новый. На macOS при установке через скрипт проверь, что в PATH добавился ~/.local/bin.

Why: Это последняя проверка перед созданием проекта. Дальше все команды пойдут через uv, и его недоступность остановит работу на первом же шаге.

code

1uv --version

–Команда напечатала версию uv

Создать папку проекта по короткому пути

Никаких пробелов, никакой кириллицы, не на Рабочем столе и не в облачной папке.

Windows: mkdir C:\dev\shop — не в OneDrive.

macOS: mkdir -p ~/dev/shop.

Why: Короткий локальный путь снижает шанс странных проблем с путями, синхронизацией и правами доступа.

code

1mkdir C:\dev\shop

–Папка создана в локальном коротком пути
–Путь не содержит пробелов и кириллицы