安装指南

安装Scrapy

注解

下列的安装步骤假定您已经安装好下列程序:

Python 2.7
Python Package: pip and setuptools. 现在 pip 依赖 setuptools ，如果未安装，则会自动安装 setuptools 。Python 2.7.9 and later include pip by default, so you may have it already.
lxml. 大多数Linux发行版自带了lxml。如果缺失，请查看http://lxml.de/installation.html
OpenSSL. 除了Windows(请查看平台安装指南)之外的系统都已经提供。

您可以使用pip来安装Scrapy(推荐使用pip来安装Python package).

使用pip安装:

pip install Scrapy

注解

对于Windows或者使用 pip 安装有问题的用户, 推荐使用本方案来安装Scrapy.

如果您已经安装了 Anaconda 或者 Miniconda , Scrapinghub 维护了Linux, Windows, OS X系统的官方版本的conda包.

使用 conda 安装Scrapy, 请执行:

conda install -c scrapinghub scrapy

从 https://www.python.org/download/ 上安装Python 2.7.
您需要修改 PATH 环境变量，将Python的可执行程序及额外的脚本添加到系统路径中。将以下路径添加到 PATH 中:
```
C:\Python2.7\;C:\Python2.7\Scripts\;
```
请打开命令行，并且运行以下命令来修改 PATH:
```
c:\python27\python.exe c:\python27\tools\scripts\win_add2path.py
```
关闭并重新打开命令行窗口，使之生效。运行接下来的命令来确认其输出所期望的Python版本:
```
python --version
```
从 http://sourceforge.net/projects/pywin32/ 安装 pywin32
请确认下载符合您系统的版本(win32或者amd64)
(只有Python<2.7.9才需要) 从 https://pip.pypa.io/en/latest/installing.html 安装 pip
打开命令行窗口，确认 pip 被正确安装:
```
pip --version
```
到目前为止Python 2.7 及 pip 已经可以正确运行了。接下来安装Scrapy:
```
pip install Scrapy
```

不要使用Ubuntu提供的 python-scrapy ，相较于最新版的Scrapy，该包版本太旧，并且运行速度也较为缓慢。

您可以使用官方提供的 Ubuntu Packages 。该包解决了全部依赖问题，并且与最新的bug修复保持持续更新。

如果您更倾向于本地构建python的依赖,而不是使用系统库(system package), 您需要先安装非python的依赖:

sudo apt-get install python-dev python-pip libxml2-dev libxslt1-dev zlib1g-dev libffi-dev libssl-dev

您可以使用 pip 安装Scrapy:

pip install Scrapy

注解

以上非python的依赖,可以用于在Debian Wheezy (7.0) 及以上的系统中安装Scrpay

您可以依照通用的方式或者从 AUR Scrapy package 来安装Scrapy:

yaourt -S scrapy

构建Scrapy的依赖需要C编译器及开发的头文件(development headers). 在OS X中, 这通常由Apple的Xcode development tools提供. 安装Xcode command line tools, 您需要打开一个终端,并且执行:

xcode-select --install

这里有一个已知的问题阻止 pip 更新system package. 这发生在成功地安装了Scrapy极其依赖之后,以下提供了一些可供参考的解决办法:

(Recommended) 不要使用系统提供的python, 而且安装一个最新的,并且不会与系统冲突的版本. 下面展现了如何使用 homebrew 包管理工具来实现:

依照 http://brew.sh/ 的指示,安装 homebrew
更新您的 PATH 变量, 使得 homebrew的包在system packages之前加载 (修改 .bashrc 为 .zshrc 如果您使用 zsh 作为默认的shell):
```
echo "export PATH=/usr/local/bin:/usr/local/sbin:$PATH" >> ~/.bashrc
```
重新加载 .bashrc 来保证修改已经生效:
```
source ~/.bashrc
```
安装python:
```
brew install python
```
最新版本的python已经捆绑了 pip ,所以您不需要单独安装. 如果不是,则需要更新python:
```
brew update; brew upgrade python
```

(可选) 在单独的python环境中安装Scrpay.
该方法能解决OS X的问题, 不过第一种方式更为优雅.
virtualenv 是一个在python中创建虚拟环境的工具,我们推荐您阅读 http://docs.python-guide.org/en/latest/dev/virtualenvs/ 来了解.

在完成了以上动作后,您将可以安装Scrapy:

pip install Scrapy