目录
- 前置准备:安装 Python
- 推荐方式:使用 pip 安装
- 可选方式:从源码编译安装
- 安装验证
- 常见问题与解决方案
- 开发环境推荐:虚拟环境
前置准备:安装 Python
Tornado 是一个 Python Web 框架,因此您必须首先确保您的系统上安装了 Python。
如何检查是否已安装 Python?
打开您的终端(在 Windows 上是 cmd 或 PowerShell,在 macOS 或 Linux 上是 Terminal),输入以下命令:
python --version # 或者 python3 --version
- 如果您看到类似
Python 3.10.8的版本号,说明 Python 已经安装,请确保您的版本是 Python 3.6 或更高版本,因为 Tornado 6.x 及以上版本不再支持 Python 2。 - 如果提示
command not found或'python' is not recognized,说明您需要先安装 Python。
如何安装 Python?
最推荐的方式是访问 Python 官网 python.org 下载并安装最新稳定版,在安装过程中,请务必勾选 "Add Python to PATH" 选项,这样您就可以在命令行中直接使用 python 命令。
推荐方式:使用 pip 安装
pip 是 Python 的官方包安装器,这是安装 Tornado 最简单、最常用的方法。
基础安装
在您的终端中,运行以下命令:
pip install tornado
如果您系统上同时有 Python 2 和 Python 3,并且您想为 Python 3 安装,请使用:
python3 -m pip install tornado
或者
pip3 install tornado
升级安装
如果您已经安装了旧版本的 Tornado,并希望升级到最新版本,可以使用 --upgrade 标志:
pip install --upgrade tornado
可选方式:从源码编译安装
虽然不常用,但了解如何从源码安装也很有用,这通常在需要安装开发版本或进行特殊定制时使用。
-
安装编译工具
- 在 Linux (Debian/Ubuntu):
sudo apt-get update sudo apt-get install python3-dev build-essential
- 在 macOS (使用 Homebrew):
brew install python3
- 在 Windows: 安装 Microsoft C++ Build Tools。
- 在 Linux (Debian/Ubuntu):
-
下载 Tornado 源码 您可以从 Tornado 的 GitHub Releases 页面 下载最新的源码压缩包(
.tar.gz),或者使用git克隆仓库:git clone https://github.com/tornadoweb/tornado.git cd tornado
-
编译和安装 在 Tornado 源码目录下,运行以下命令:
python3 setup.py build python3 setup.py install
安装验证
安装完成后,您可以运行一个简单的 "Hello, World!" 程序来验证 Tornado 是否已正确安装。
-
创建一个名为
hello.py的文件,并粘贴以下代码:import tornado.ioloop import tornado.web class MainHandler(tornado.web.RequestHandler): def get(self): self.write("Hello, Tornado World!") if __name__ == "__main__": app = tornado.web.Application([ (r"/", MainHandler), ]) # 指定端口,默认为 8888 app.listen(8888) print("Server is running at http://localhost:8888") tornado.ioloop.IOLoop.current().start() -
在终端中运行这个 Python 文件:
python hello.py
-
打开您的网页浏览器,访问
http://localhost:8888。
如果您在页面上看到 "Hello, Tornado World!",那么恭喜您,Tornado 已经成功安装并可以正常运行了!
常见问题与解决方案
问题 1: pip 命令未找到
- 现象: 终端提示
'pip' is not recognized as an internal or external command... - 原因: Python 的
Scripts目录没有被添加到系统的环境变量PATH中。 - 解决方案:
- 找到 Python 的安装路径(
C:\Python39\)。 - 将
C:\Python39\和C:\Python39\Scripts\添加到系统的PATH环境变量中。 - 重启终端,然后再次尝试
pip install tornado。
- 找到 Python 的安装路径(
问题 2: 权限错误 (Permission denied)
- 现象: 在 Linux 或 macOS 上,安装时提示
Permission denied。 - 原因: 您没有权限向系统级的 Python 环境写入文件。
- 解决方案:
- 推荐做法: 使用用户级安装,这通常不需要管理员权限。
pip install --user tornado
这会将包安装到您用户目录下的
~/.local/lib/python3.x/site-packages中,您可能需要将~/.local/bin添加到PATH中才能使用通过--user安装的命令行工具。 - 不推荐做法: 使用
sudo获取管理员权限(可能会破坏系统环境)。sudo pip install tornado
- 推荐做法: 使用用户级安装,这通常不需要管理员权限。
问题 3: SSL/TLS 错误
- 现象: 在安装依赖时(如
pyca/cryptography),出现 SSL/TLS 相关的错误,导致下载失败。 - 原因: 系统缺少 CA 证书包。
- 解决方案:
- 在 Debian/Ubuntu 上:
sudo apt-get install libssl-dev
- 在 CentOS/RHEL 上:
sudo yum install openssl-devel
- 在 macOS 上: 如果您使用 Homebrew 安装的 Python,通常会自动处理。
- 在 Debian/Ubuntu 上:
开发环境推荐:虚拟环境
在实际开发中,强烈建议为每个项目创建一个独立的虚拟环境,这可以避免不同项目之间的库版本冲突,并保持全局环境的干净。
-
创建虚拟环境
- 确保您安装了
venv模块(Python 3.3+ 默认自带)。 - 在您的项目文件夹中,运行:
# 创建一个名为 'venv' 的虚拟环境文件夹 python3 -m venv venv
- 确保您安装了
-
激活虚拟环境
- 在 Windows (cmd):
venv\Scripts\activate
- 在 Windows (PowerShell):
.\venv\Scripts\Activate.ps1
- 在 Linux/macOS:
source venv/bin/activate
激活后,您会看到终端提示符前出现
(venv)字样。
- 在 Windows (cmd):
-
在虚拟环境中安装 Tornado 您可以在激活的虚拟环境中使用
pip安装库,这些库只会安装到当前环境中:pip install tornado
-
退出虚拟环境 当您完成工作后,可以使用以下命令退出虚拟环境:
deactivate
| 步骤 | 命令 | 说明 |
|---|---|---|
| 检查 Python | python --version |
确保已安装 Python 3.6+ |
| 基础安装 | pip install tornado |
最简单、最推荐的安装方式 |
| 验证安装 | python hello.py |
运行测试程序确认安装成功 |
| 推荐实践 | python3 -m venv venv source venv/bin/activate pip install tornado |
为项目创建独立的虚拟环境,避免冲突 |
希望这份指南能帮助您顺利安装 Tornado!
