Visual Studio Code:
установка и первый проект

Категория

Подготовка рабочего места

Уровень

Нулевой — опыта не требуется

Связанные темы

1.1 Переменные, 1.3 print(), 1.5 input()

Зачем это знать

Писать и запускать программы на своём компьютере

§1Интерпретатор, редактор, терминал

Обычно говорят «установить Python», хотя для работы понадобятся три разные программы.

• Интерпретатор Python — программа, которая читает ваш код и выполняет его. Это и есть сам язык на компьютере: без интерпретатора файл с кодом остаётся обычным текстовым файлом.
• Редактор кода — программа, в которой вы этот текст набираете. Мы возьмём Visual Studio Code, дальше — просто VS Code.
• Терминал — окно, где вы отдаёте команды компьютеру текстом. Из него мы будем запускать программу и видеть, что она вывела.

Редактор сам по себе ничего не выполняет. Он сохраняет файл на диск, дальше этот файл читает интерпретатор. Поэтому один и тот же main.py работает одинаково, в каком бы редакторе его ни набрали.

§2Проверяем, установлен ли Python

Сначала проверьте, есть ли Python на компьютере — часто он уже установлен. Откройте терминал и выполните одну команду.

• Windows: нажмите Win, наберите PowerShell и откройте его. Команда — python --version.
• macOS: откройте программу «Терминал» через Cmd + Пробел. Команда — python3 --version.

Python 3.12.12

Третье число — номер исправления, для работы он значения не имеет. Подходит Python 3.12 и любая более поздняя версия; примеры справочника рассчитаны на 3.12 и новее. При меньшей версии Python нужно доставить.

Если вместо номера версии вы увидели сообщение вроде command not found, не является внутренней или внешней командой или открылся магазин приложений — значит, интерпретатора нет или он не прописан в PATH. Переходим к установке.

§3Устанавливаем Python

Установщик берём только с официального сайта python.org/downloads. Сборки с других сайтов бывают изменены, и причину сбоя в них найти трудно.

Сайт определяет систему и предлагает последнюю версию. На снимке это Download Python 3.14.7, на вашем экране номер будет выше: версии выходят примерно раз в год. Нажимайте эту кнопку.

Минимальная версия для курса — 3.12. На 3.11 и старше часть примеров не заработает. Если на компьютере уже стоит 3.12 или новее, ставить вторую не нужно — переходите к §4.

Если сайт определил систему неверно или установщик нужен для другого компьютера, кнопка предложит не тот файл. Тогда идите по ссылке Windows в строке «Looking for Python with a different OS?» — откроется список сборок под Windows.

В разделе Stable Releases возьмите верхний выпуск и в нём ссылку Windows installer (64-bit). Строка embeddable package — сборка без установщика, для курса она не подходит.

1. Скачайте установщик для своей системы. Для Windows это Windows installer (64-bit).
2. Windows, обязательный шаг: в первом окне установщика поставьте галочку Add python.exe to PATH внизу. Она добавляет папку с Python в список PATH, о котором сказано в §2.
3. Нажмите Install Now и дождитесь конца установки.
4. Закройте терминал и откройте заново: список PATH читается при запуске, и старое окно об изменениях не знает.
5. Проверьте установку командой из §2. Должен появиться номер версии.

На macOS Python обычно уже есть в системе, но версия бывает старой. Установщик с python.org ставится рядом с системным: он добавляет команду python3 нужной версии, системный Python остаётся на месте.

§4Устанавливаем Visual Studio Code

VS Code скачиваем с code.visualstudio.com. Кнопка на главной странице подставляет вариант для вашей системы.

Если система определилась неверно, нажмите other platforms под кнопкой или Download в шапке — откроется страница со всеми вариантами сразу.

Для Windows берите синюю кнопку Windows — это User Installer для x64, он ставится без прав администратора. Для Mac — кнопку Mac; если не знаете, какой у вас процессор, возьмите Universal.

1. Windows: запустите скачанный .exe. В окне с дополнительными задачами отметьте Add to PATH — тогда редактор можно будет открывать командой code. Остальные галочки по желанию: они добавляют пункты в контекстное меню проводника.
2. macOS: распакуйте архив и перетащите Visual Studio Code.app в папку Программы. Без этого шага редактор останется в папке загрузок и удалится вместе с её содержимым при очистке.
3. Запустите VS Code. При первом запуске он предложит выбрать тему оформления — выбирайте любую, на работу это не влияет.

Интерфейс по умолчанию английский. Если он неудобен, поставьте языковой пакет: Ctrl + Shift + X, в поиске наберите Russian Language Pack, установите и перезапустите редактор. Дальше в главе названия пунктов даны по-русски, а в скобках — по-английски, чтобы вы нашли их в любом варианте.

§5Окно редактора: пять зон

В окне VS Code много панелей и кнопок. В работе постоянно нужны пять зон, на снимке они отмечены номерами.

1 2 3 4 5

1. Панель действий (Activity Bar) — узкая полоса слева. Переключает, что показано во второй зоне: файлы, поиск, отладка, расширения.
2. Проводник (Explorer) — список файлов открытой папки. Здесь вы создаёте, открываете и переименовываете файлы.
3. Редактор — область, где набирают код. Сверху вкладки открытых файлов, слева номера строк.
4. Терминал — нижняя панель. Это терминал из §1, встроенный в окно редактора.
5. Строка состояния — тонкая полоса внизу. Справа в ней показана выбранная версия Python, о выборе версии сказано в §9.

§6Папка проекта

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

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

1. Создайте папку в удобном месте: C:\Users\Имя\python\zayavki на Windows или ~/python/zayavki на macOS.
2. В VS Code выберите Файл → Открыть папку… (File → Open Folder…) и укажите её.
3. Редактор спросит, доверяете ли вы авторам файлов в папке. Нажмите Trust: папку вы создали сами.

Соседний пункт Open… открывает отдельный файл, папку открывает Open Folder…. В диалоге выберите папку одним щелчком и нажмите Открыть: заходить внутрь папки не нужно.

Про доверие редактор спрашивает при первом открытии папки. Пока ответа нет, папка держится в ограниченном режиме (Restricted Mode): задачи и отладка не запускаются, часть расширений работает не полностью.

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

§7Первый файл и запуск кнопкой

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

1. Наведите курсор на название папки в проводнике — справа появятся значки. Нажмите первый, Создать файл (New File).
2. Наберите имя main.py и нажмите Enter. Расширение .py обязательно: по нему редактор определяет, что это код на Python, и включает подсветку.
3. В открывшейся вкладке наберите одну строку: print("Hello, world!")
4. Сохраните файл: Ctrl + S (на macOS Cmd + S). Пока файл не сохранён, на вкладке вместо крестика стоит точка.
5. Нажмите треугольник ▷ в правом верхнем углу редактора. Внизу откроется терминал и выполнит файл.

print("Hello, world!")

В терминале видна вся команда: путь к интерпретатору и путь к файлу. Строкой ниже — то, что напечатала программа: Hello, world!.

Добавим второй файл — программу, которая запрашивает данные у пользователя. Создайте zayavka.py тем же способом.

name = input("Ваше имя: ")
age = int(input("Ваш возраст: "))
print(f"{name}, через год вам будет {age + 1}")

В терминале внизу подсказки Ваше имя: и Ваш возраст: появляются по очереди: программа ждёт ввода и продолжает работу после Enter. Устройство input() разобрано в главе 1.5.

§8Расширения: минимальный набор

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

1. Откройте вкладку расширений: значок с квадратами на панели действий или Ctrl + Shift + X.
2. В поиске наберите python.
3. Выберите расширение Python, у которого в издателях стоит Microsoft с синей галочкой, и нажмите Установить.

Вместе с ним установятся ещё три — Pylance, Python Debugger и Python Environments. Искать их отдельно не нужно, они ставятся как зависимости. Pylance отвечает за подсказки и подчёркивание ошибок прямо в коде, Python Debugger — за пошаговую отладку, Python Environments — за выбор интерпретатора и окружений.

Расширение даёт подсветку кода, автодополнение имён, подчёркивание опечаток до запуска, кнопку ▷ из §7 и выбор интерпретатора из §9. Без него кнопка запуска в углу редактора не появляется.

§9Выбор интерпретатора

Интерпретаторов на компьютере бывает несколько: системный, установленный вами, установленный вместе с другой программой. Редактору указывают, какой из них запускать. Выбор делают в палитре команд — строке, через которую в VS Code вызывают команды редактора.

1. Нажмите Ctrl + Shift + P (на macOS Cmd + Shift + P).
2. Наберите Python: Select Interpreter и выберите эту команду.
3. Из списка выберите версию, которую установили в §3. На снимке это Python 3.14.6; рядом VS Code показывает путь к каждому интерпретатору.

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

§10Запуск из терминала

Кнопка ▷ удобна, но не показывает, какая команда выполняется. В терминале команда видна целиком: сначала имя интерпретатора, затем имя файла. Вне редактора программу запускают так же.

Откройте встроенный терминал: Терминал → Создать терминал (Terminal → New Terminal) или сочетание Ctrl + ` — это клавиша с буквой «ё». Терминал откроется в папке проекта.

python main.py

python3 main.py

Hello, world!

Команда состоит из двух частей. python — имя интерпретатора, программы из §1. main.py — имя файла, который ему передают. Файл ищется в текущей папке, поэтому нужно знать, какая папка открыта в терминале.

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

§11Когда программа не запускается

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

Файл не найден. Терминал находится не в той папке или в имени файла опечатка.

python3: can't open file '/Users/student/python/main.py': [Errno 2] No such file or directory

Путь в кавычках — место, где интерпретатор искал файл. Сравните его с настоящим расположением файла. Чаще всего терминал открыт на уровень выше, и помогает команда cd zayavki.

Ошибка в коде. Файл найден и запущен, но во время выполнения Python встретил имя, которого не существует.

Traceback (most recent call last):
  File "/Users/student/python/zayavki/oshibka.py", line 2, in <module>
    print("Привет, " + nane)
                       ^^^^
NameError: name 'nane' is not defined. Did you mean: 'name'?

Такое сообщение читают снизу вверх. В последней строке — вид ошибки и имя, из-за которого она возникла: nane не существует, и Python предлагает замену Did you mean: 'name'?. Выше указано место: файл, строка 2, стрелки ^^^^ под этим именем. В самом коде имя подчёркнуто волнистой линией ещё до запуска — это работа Pylance из §8.

Команда не найдена. Сообщение command not found: python или не является внутренней или внешней командой выдаёт сама система: она не нашла интерпретатор. К коду программы оно отношения не имеет, дело в установке — вернитесь к §2 и §3.

§12Частые ошибки

§13Проверьте себя

§14Шпаргалка

Итог главы

Для работы нужны три программы: интерпретатор Python выполняет код, VS Code помогает его набирать, терминал связывает их командой python main.py. Проект открываем целой папкой; из расширений ставим одно — Python от Microsoft; перед запуском проверяем, что файл сохранён и что в строке состояния выбрана версия 3.12 или новее. На этом подготовка рабочего места закончена, дальше идёт глава 1.1.