Python в Windows: часто задаваемые вопросы¶Python on Windows FAQ

Как запустить программу Python в Windows?¶How do I run a Python program under Windows?

Это не обязательно простой вопрос. Если вы уже знакомы с запуском программ из командной строки Windows, всё покажется очевидным; в противном случае может потребоваться немного больше пояснений. Также существуют различия между Windows 95, 98, NT, ME, 2000 и XP, которые могут добавить путаницы.

Если вы не используете какую-либо интегрированную среду разработки, вам придётся вводить команды Windows в то, что по-разному называют «окном DOS» или «окном командной строки». Обычно такое окно можно создать из меню «Пуск»; в Windows 2000 нужно выбрать Пуск ‣ Программы ‣ Стандартные ‣ Командная строка. Вы узнаете, что окно открыто, по приглашению командной строки Windows, которое обычно выглядит так:

C:\>

Буква может быть другой, и после неё могут быть ещё символы, так что можно увидеть, например, такое:

D:\Steve\Projects\Python>

в зависимости от настроек компьютера и от недавних действий на нём. Как только такое окно открыто, можно смело приступать к запуску программ Python.

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

First, you need to make sure that your command window recognises the word “python” as an instruction to start the interpreter. If you have opened a command window, you should try entering the command python and hitting return. You should then see something like:

Python 2.2 (#28, Dec 21 2001, 12:21:22) [MSC 32 bit (Intel)] on win32
Type "help", "copyright", "credits" or "license" for more information.
>>>

Интерпретатор запущен в «интерактивном режиме». Это означает, что можно вводить операторы или выражения Python в интерактивном режиме и сразу же получать их выполнение или вычисление. Это одна из самых сильных сторон Python. Проверьте это, введя несколько выражений на свой выбор и увидев результаты:

>>> print("Hello")
Hello
>>> "Hello" * 3
HelloHelloHello

Многие используют интерактивный режим как удобный, но при этом с широкими возможностями программирования калькулятор. Чтобы завершить сеанс Python в интерактивном режиме, удерживайте клавишу Ctrl и нажмите Z, затем нажмите Enter, чтобы вернуться в командную строку Windows.

Вы также можете обнаружить, что у вас есть пункт меню «Пуск», такой как Пуск ‣ Программы ‣ Python 2.2 ‣ Python (командная строка), в результате чего вы видите приглашение >>> в новом окне. Если это так, окно исчезнет после ввода символа Ctrl-Z; Windows выполняет единственную команду «python» в этом окне и закрывает его при завершении интерпретатора.

Если команда python вместо отображения приглашения интерпретатора >>> выводит сообщение вида:

'python' is not recognized as an internal or external command,
operable program or batch file.

или:

Bad command or filename

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

Следует настроить добавление каталога установки Python в PATH каждого командного окна при его запуске. Если вы установили Python недавно, то команда

dir C:\py*

will probably tell you where it is installed; the usual location is something like C:\Python23. Otherwise you will be reduced to a search of your whole disk ... use Tools ‣ Find or hit the Search button and look for “python.exe”. Supposing you discover that Python is installed in the C:\Python23 directory (the default at the time of writing), you should make sure that entering the command

c:\Python23\python

starts up the interpreter as above (and don’t forget you’ll need a “CTRL-Z” and an “Enter” to get out of it). Once you have verified the directory, you need to add it to the start-up routines your computer goes through. For older versions of Windows the easiest way to do this is to edit the C:\AUTOEXEC.BAT file. You would want to add a line like the following to AUTOEXEC.BAT:

PATH C:\Python23;%PATH%

Для Windows NT, 2000 и (я предполагаю) XP вам нужно будет добавить строку, например

;C:\Python23

в текущее значение переменной среды PATH, которое можно найти в окне свойств «Мой компьютер» на вкладке «Дополнительно». Обратите внимание: если у вас достаточно прав, вы можете выбрать установку параметров либо для текущего пользователя, либо для системы. Последний вариант предпочтительнее, если вы хотите, чтобы все пользователи могли запускать Python на этом компьютере.

If you aren’t confident doing any of these manipulations yourself, ask for help! At this stage you may want to reboot your system to make absolutely sure the new setting has taken effect. You probably won’t need to reboot for Windows NT, XP or 2000. You can also avoid it in earlier versions by editing the file C:\WINDOWS\COMMAND\CMDINIT.BAT instead of AUTOEXEC.BAT.

You should now be able to start a new command window, enter python at the C:\> (or whatever) prompt, and see the >>> prompt that indicates the Python interpreter is reading interactive commands.

Let’s suppose you have a program called pytest.py in directory C:\Steve\Projects\Python. A session to run that program might look like this:

C:\> cd \Steve\Projects\Python
C:\Steve\Projects\Python> python pytest.py

Because you added a file name to the command to start the interpreter, when it starts up it reads the Python script in the named file, compiles it, executes it, and terminates, so you see another C:\> prompt. You might also have entered

C:\> python \Steve\Projects\Python\pytest.py

если бы не хотели менять текущий каталог.

Under NT, 2000 and XP you may well find that the installation process has also arranged that the command pytest.py (or, if the file isn’t in the current directory, C:\Steve\Projects\Python\pytest.py) will automatically recognize the “.py” extension and run the Python interpreter on the named file. Using this feature is fine, but some versions of Windows have bugs which mean that this form isn’t exactly equivalent to using the interpreter explicitly, so be careful.

Важно запомнить следующее:

1. Запускайте Python из меню «Пуск» или убедитесь, что PATH настроен правильно, чтобы Windows мог найти интерпретатор Python.

   python
   

   должно выдать приглашение «>>>» от интерпретатора Python. Не забудьте нажать CTRL-Z и ENTER для завершения интерпретатора (и, если вы открыли окно из меню «Пуск», окно исчезнет).

2. Когда это заработает, вы сможете запускать программы с помощью команд:

   python {program-file}
   

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

   python --help
   

   если ваши задачи сложны.

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

Как сделать скрипты Python исполняемыми?¶How do I make Python scripts executable?

On Windows 2000, the standard Python installer already associates the .py extension with a file type (Python.File) and gives that file type an open command that runs the interpreter (D:\Program Files\Python\python.exe "%1" %*). This is enough to make scripts executable from the command prompt as ‘foo.py’. If you’d rather be able to execute the script by simple typing ‘foo’ with no extension you need to add .py to the PATHEXT environment variable.

В Windows NT действия, выполняемые установщиком, как описано выше, позволяют запускать скрипт с помощью «foo.py», но давняя ошибка в командном процессоре NT не позволяет перенаправлять ввод или вывод любого скрипта, выполняемого таким образом. Это часто важно.

Инструкция для того, чтобы сделать скрипт Python исполняемым в WinNT, – дать файлу расширение .cmd и добавить следующую строку в качестве первой:

@setlocal enableextensions & python -x %~f0 %* & goto :EOF

Почему Python иногда так долго запускается?¶Why does Python sometimes take so long to start?

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

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

Где Freeze для Windows?¶Where is Freeze for Windows?

Freeze – это программа, которая позволяет распространять программу Python в виде одного автономного исполняемого файла. Это не компилятор; ваши программы не работают быстрее, но их легче распространять, по крайней мере на платформах с той же ОС и процессором. Прочтите файл README программы freeze для получения дополнительных оговорок.

You can use freeze on Windows, but you must download the source tree (see http://www.python.org/download/source). The freeze program is in the Tools\freeze subdirectory of the source tree.

Вам понадобится компилятор Microsoft VC++, и, вероятно, потребуется собрать Python. Необходимые файлы проекта находятся в каталоге PCbuild.

Является ли файл *.pyd тем же, что и DLL?¶Is a *.pyd file the same as a DLL?

Да, файлы .pyd – это DLL, но есть несколько отличий. Если у вас есть DLL с именем foo.pyd, то в ней должна быть функция initfoo(). После этого можно написать в Python «import foo», и Python будет искать foo.pyd (а также foo.py, foo.pyc) и, если найдёт, попытается вызвать initfoo() для её инициализации. Не нужно компоновать .exe с foo.lib, поскольку это заставит Windows требовать наличия этой DLL.

Обратите внимание, что путь поиска для foo.pyd – это PYTHONPATH, а не тот путь, который Windows использует для поиска foo.dll. Кроме того, foo.pyd не обязательно должен присутствовать для запуска вашей программы, тогда как если вы слинковали программу с DLL, эта DLL требуется. Разумеется, foo.pyd необходим, если вы хотите написать import foo. В DLL связывание объявляется в исходном коде с помощью __declspec(dllexport). В .pyd связывание определяется в списке доступных функций.

Как встроить Python в приложение Windows?¶How can I embed Python into a Windows application?

Встраивание интерпретатора Python в приложение Windows можно резюмировать следующим образом:

1. Do _not_ build Python into your .exe file directly. On Windows, Python must be a DLL to handle importing modules that are themselves DLL’s. (This is the first key undocumented fact.) Instead, link to pythonNN.dll; it is typically installed in C:\Windows\System. NN is the Python version, a number such as “23” for Python 2.3.

   Python можно линковать двумя способами. Линковка во время загрузки означает линковку с pythonNN.lib, а линковка во время выполнения – линковку с pythonNN.dll. (Общее замечание: pythonNN.lib – это так называемая «импортная библиотека», соответствующая pythonNN.dll. Она всего лишь определяет символы для линковщика.)

   Линковка во время выполнения значительно упрощает параметры линковки; всё происходит во время выполнения. Ваш код должен загрузить pythonNN.dll с помощью функции Windows LoadLibraryEx(). Код также должен использовать функции доступа и данные из pythonNN.dll (то есть C API Python) через указатели, полученные с помощью функции Windows GetProcAddress(). Макросы могут сделать использование этих указателей прозрачным для любого C-кода, вызывающего функции C API Python.

   Примечание для Borland: сначала преобразуйте pythonNN.lib в формат OMF с помощью Coff2Omf.exe.

2. Если вы используете SWIG, легко создать Python-«модуль расширения», который сделает данные и методы приложения доступными для Python. SWIG возьмет на себя практически все рутинные детали. В результате получается код на C, который вы встраиваете в свой .exe-файл (!) Вам не нужно создавать DLL-файл, и это также упрощает связывание.

3. SWIG создаст функцию инициализации (функцию на C), имя которой зависит от имени модуля расширения. Например, если модуль называется leo, функция инициализации будет называться initleo(). Если вы используете классы-тени SWIG (а это стоит делать), функция инициализации будет называться initleoc(). Она инициализирует в основном скрытый вспомогательный класс, используемый классом-тенью.

   Причина, по которой можно скомпоновать код на C из шага 2 прямо в .exe-файл, в том, что вызов функции инициализации эквивалентен импорту модуля в Python! (Это второй ключевой недокументированный факт.)

4. Кратко: следующий код позволяет инициализировать интерпретатор Python вместе с вашим модулем расширения.

   #include "python.h"
   ...
   Py_Initialize();  // Инициализировать Python.
   initmyAppc();  // Инициализировать (импортировать) вспомогательный класс.
   PyRun_SimpleString("import myApp") ;  // Импортировать теневой класс.
   

5. Есть две проблемы с C API Python, которые проявятся, если вы используете компилятор, отличный от MSVC (компилятор, которым собрана pythonNN.dll).

   Проблема 1: Так называемые «очень высокоуровневые» функции, принимающие аргументы FILE *, не будут работать в среде с несколькими компиляторами, поскольку каждый компилятор имеет свое представление о struct FILE. С точки зрения реализации это очень _низкоуровневые_ функции.

   Проблема 2: SWIG генерирует следующий код при создании обёрток для функций, возвращающих void:

   Py_INCREF(Py_None);
   _resultobj = Py_None;
   return _resultobj;
   

   Увы, Py_None – это макрос, который разворачивается в ссылку на сложную структуру данных _Py_NoneStruct внутри pythonNN.dll. И этот код тоже не будет работать в среде с несколькими компиляторами. Замените такой код на:

   return Py_BuildValue("");
   

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

6. Использовать скрипт оболочки Python для вызова окна интерпретатора из вашего Windows-приложения – плохая идея: полученное окно будет независимо от оконной системы приложения. Вместо этого вам (или классу wxPythonWindow) следует создать «родное» окно интерпретатора. Подключить это окно к интерпретатору Python несложно. Вы можете перенаправить ввод-вывод Python на _любой_ объект, поддерживающий чтение и запись, так что всё, что нужно – это объект Python (определённый в вашем модуле расширения) с методами read() и write().

Как использовать Python для CGI?¶How do I use Python for CGI?

На сервере Microsoft IIS или на Win95 MS Personal Web Server Python настраивается так же, как и любой другой скриптовый движок.

Запустите regedt32 и перейдите к:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\W3SVC\Parameters\ScriptMap

и введите следующую строку (внеся необходимые изменения, требуемые вашей системой):

.py :REG_SZ: c:\<path to python>\python.exe -u %s %s

Эта строка позволит вызывать ваш скрипт с помощью простой ссылки, например: http://yourserver/scripts/yourscript.py при условии, что «scripts» является «исполняемым» каталогом на вашем сервере (обычно это так по умолчанию). Флаг -u задаёт небуферизованный и двоичный режим для stdin – необходимо при работе с двоичными данными.

Кроме того, рекомендуется не использовать расширение «.py» в данном контексте (возможно, стоит оставить *.py для вспомогательных модулей и использовать *.cgi или *.cgp для скриптов «главной программы»).

Чтобы настроить Internet Information Services 5 на использование Python для обработки CGI, обратитесь к следующим ссылкам:

http://www.e-coli.net/pyiis_server.html (для Win2k Server) http://www.e-coli.net/pyiis.html (для Win2k pro)

Настройка Apache значительно проще. В конфигурационном файле Apache httpd.conf добавьте следующую строку в конец файла:

ScriptInterpreterSource Registry

Затем дайте вашим CGI-скриптам Python расширение .py и поместите их в каталог cgi-bin.

How do I keep editors from inserting tabs into my Python source?¶

The FAQ does not recommend using tabs, and the Python style guide, PEP 8, recommends 4 spaces for distributed Python code; this is also the Emacs python-mode default.

Under any editor, mixing tabs and spaces is a bad idea. MSVC is no different in this respect, and is easily configured to use spaces: Take Tools ‣ Options ‣ Tabs, and for file type “Default” set “Tab size” and “Indent size” to 4, and select the “Insert spaces” radio button.

Если вы подозреваете, что смешивание символов табуляции и пробелов в начале строк вызывает проблемы, запустите Python с ключом -t или выполните Tools/Scripts/tabnanny.py для проверки всего дерева каталогов в пакетном режиме.

How do I check for a keypress without blocking?¶

Используйте модуль msvcrt. Это стандартный модуль расширения для Windows. Он определяет функцию kbhit(), которая проверяет, есть ли нажатие клавиши, и getch(), которая получает один символ без его отображения.

Как эмулировать os.kill() в Windows?¶How do I emulate os.kill() in Windows?

Чтобы завершить процесс, можно использовать ctypes:

import ctypes

def kill(pid):
    """функция kill для Win32"""
    kernel32 = ctypes.windll.kernel32
    handle = kernel32.OpenProcess(1, 0, pid)
    return (0 != kernel32.TerminateProcess(handle, 0))

Почему os.path.isdir() не работает в общих каталогах NT?¶Why does os.path.isdir() fail on NT shared directories?

Решением, по-видимому, является добавление «\» в конце общих дисков.

>>> import os
>>> os.path.isdir( '\\\\rorschach\\public')
0
>>> os.path.isdir( '\\\\rorschach\\public\\')
1

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

k: is not a directory
k:\ is a directory
k:\media is a directory
k:\media\ is not a directory

Те же правила действуют, если заменить «k:» на «\conkyfoo»:

\\conky\foo  is not a directory
\\conky\foo\ is a directory
\\conky\foo\media is a directory
\\conky\foo\media\ is not a directory

cgi.py (или другие CGI-программы) иногда не работают на NT или win95!¶cgi.py (or other CGI programming) doesn’t work sometimes on NT or win95!

Убедитесь, что у вас установлена последняя версия python.exe, что вы используете python.exe, а не GUI-версию Python, и что сервер настроен на выполнение

"...\python.exe -u ..."

для выполнения CGI. Опция -u (небуферизованный) на NT и Win95 предотвращает изменение переводов строк интерпретатором в стандартном вводе и выводе. Без неё запросы post/multipart будут казаться неверной длины, а двоичные (например, GIF) ответы могут быть искажены (что приведёт к повреждённым изображениям, PDF-файлам и другим сбоям при загрузке двоичных файлов).

Почему os.popen() не работает в PythonWin на NT?¶Why doesn’t os.popen() work in PythonWin on NT?

Причина, по которой os.popen() не работает из PythonWin, заключается в ошибке в библиотеке времени выполнения C (CRT) от Microsoft. CRT предполагает, что к процессу подключена консоль Win32.

Вместо этого следует использовать popen() из модуля win32pipe, который не зависит от наличия подключённой консоли Win32.

Пример:

import win32pipe
f = win32pipe.popen('dir /c c:\\')
print(f.readlines())
f.close()

Почему os.popen()/win32pipe.popen() не работают на Win9x?¶Why doesn’t os.popen()/win32pipe.popen() work on Win9x?

В Win9x есть ошибка, которая не позволяет os.popen/win32pipe.popen* работать. Хорошая новость в том, что существует способ обойти эту проблему. Статья базы знаний Microsoft, которую нужно посмотреть: Q150956. Ссылки на базу знаний можно найти здесь: http://support.microsoft.com/.

PyRun_SimpleFile() падает на Windows, но не на Unix; почему?¶PyRun_SimpleFile() crashes on Windows but not on Unix; why?

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

DLL-библиотеки Python 1.5.* (python15.dll) все скомпилированы с помощью MS VC++ 5.0 и с опциями многопоточных DLL (/MD).

Если вы не можете сменить компилятор или флаги, попробуйте использовать Py_RunSimpleString(). Хитрость, чтобы заставить его выполнить произвольный файл, – это сконструировать вызов execfile() с именем файла в качестве аргумента.

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

Импорт _tkinter не выполняется на Windows 95/98: почему?¶Importing _tkinter fails on Windows 95/98: why?

Иногда импорт _tkinter не удаётся на Windows 95 или 98, выдавая сообщение примерно следующего содержания:

ImportError: DLL load failed: One of the library files needed
to run this application cannot be found.

Возможно, вы не установили Tcl/Tk, но если вы установили Tcl/Tk, и приложение Wish работает правильно, проблема может быть в том, что его установщик не смог правильно отредактировать файл autoexec.bat. Он пытается добавить строку, изменяющую переменную среды PATH, чтобы включить подкаталог «bin» Tcl/Tk, но иногда это редактирование не срабатывает. Открыв его в блокноте, обычно можно понять, в чём проблема.

(Дополнительный совет от David Szafranski: здесь нельзя использовать длинные имена файлов; например, используйте C:\PROGRA~1\Tcl\bin вместо C:\Program Files\Tcl\bin.)

Как извлечь загруженную документацию в Windows?¶How do I extract the downloaded documentation on Windows?

Иногда при загрузке пакета документации в Windows через браузер расширение сохранённого файла оказывается .EXE. Это ошибка; расширение должно быть .TGZ.

Просто переименуйте загруженный файл, чтобы расширение стало .TGZ, и WinZip сможет его обработать. (Если ваша версия WinZip не может, загрузите новую с http://www.winzip.com.)

Отсутствует cw3215mt.dll (или отсутствует cw3215.dll)¶Missing cw3215mt.dll (or missing cw3215.dll)

Иногда при использовании Tkinter в Windows возникает ошибка об отсутствии cw3215mt.dll или cw3215.dll.

Причина: в пути поиска DLL находится старая DLL Tcl/Tk, собранная с помощью cygwin (вероятно, C:\Windows). Необходимо использовать DLL Tcl/Tk из стандартной установки Tcl/Tk (Python 1.5.2 поставляется с одной из них).

Предупреждение о версии CTL3D32 от установщика¶Warning about CTL3D32 version from installer

Установщик Python выдает предупреждение следующего вида:

This version uses CTL3D32.DLL which is not the correct version.
This version is used for windows NT applications only.

Tim Peters:

Это DLL от Microsoft, известный источник проблем. Сообщение говорит именно о том, что написано: у вас неправильная версия этой DLL для вашей операционной системы. Установка Python к этому не привела – какое-то другое программное обеспечение, установленное ранее, перезаписало DLL, поставлявшуюся с вашей ОС (вероятно, старая условно-бесплатная программа, но сейчас уже не определить). Если поискать «CTL3D32» в любом поисковике (например, AltaVista), можно найти сотни веб-страниц с жалобами на ту же проблему у самых разных установочных программ. Они укажут, как восстановить правильную версию в вашей системе (поскольку Python не вызывает эту проблему, мы не можем её исправить).

Дэвид А. Бертон написал небольшую программу для решения этой проблемы. Перейдите на http://www.burtonsys.com/downloads.html и нажмите на «ctl3dfix.zip».