第1章:开发环境搭建
说实话,每次带新人做项目,我最怕听到的一句话就是:「老师,我环境装好了,但跑不起来。」
嗯,环境搭建这事儿,看着简单,坑是真不少。我自己踩过的雷,少说也有十来个。今天咱们就把这事一次性捋清楚。
1.1 Python版本选择——别小看这一步
我个人习惯用 Python 3.8 到 3.10 之间的版本。为什么?
TextBlob 和 NLTK 这两个库,在 3.11 以上版本偶尔会有兼容性问题。我在项目中遇到过一回,折腾了整整一下午,最后发现是 Python 版本太高了。
所以我的建议是:用 Python 3.9。稳定,兼容性好,社区支持也最全。
推荐版本:Python 3.9.13
下载地址:python.org 直接下载安装包就行
1.2 虚拟环境——每个项目都该有自己的小窝
你想想看,如果所有项目都共用一套 Python 环境,那不乱套了?
A 项目需要 Flask 2.0,B 项目需要 Flask 1.0,装来装去迟早出问题。
虚拟环境就是干这个的——给每个项目一个独立的空间。
创建虚拟环境的命令很简单:
# 打开终端,进入你的项目文件夹
cd news_sentiment_analyzer
# 创建虚拟环境(我习惯叫 venv)
python -m venv venv
# 激活虚拟环境
# Windows 下:
venv\Scripts\activate
# Mac / Linux 下:
source venv/bin/activate
激活成功后,终端前面会出现 (venv) 字样。看到这个,就说明你已经在虚拟环境里了。
小技巧:我习惯在项目根目录下建一个 .gitignore 文件,把 venv/ 加进去。这样虚拟环境就不会被提交到 Git 仓库里,省得队友们下载一堆没用的文件。
1.3 核心依赖库安装——一个一个来
好,环境有了,虚拟环境也激活了。接下来装库。
咱们这个项目主要用三个库:
| 库名 | 用途 | 版本建议 |
|---|---|---|
| TextBlob | 情感分析核心库,封装了 NLTK 的很多功能 | 0.17.1 |
| NLTK | 自然语言处理基础库,TextBlob 依赖它 | 3.8.1 |
| Flask | Web 框架,用来搭建 API 接口 | 2.3.3 |
安装命令如下:
# 先升级 pip,这个习惯我一直保持
python -m pip install --upgrade pip
# 安装核心库
pip install textblob==0.17.1
pip install nltk==3.8.1
pip install flask==2.3.3
# 一次性安装也可以
pip install textblob==0.17.1 nltk==3.8.1 flask==2.3.3
注意:安装 TextBlob 之后,还需要下载它的语料库。这一步很多人会忘。
运行下面这行代码:
python -m textblob.download_corpora
这个过程会下载一些英文词典和情感分析模型,大概几十 MB。网速慢的话,等个几分钟也正常。
1.4 验证安装——跑个小测试
装完了,怎么知道好不好使?
我一般会写个最简单的测试脚本:
# test_env.py
from textblob import TextBlob
# 随便写句话试试
text = "I love this product! It's amazing."
blob = TextBlob(text)
# 输出情感极性(-1 到 1 之间)
print(f"情感极性: {blob.sentiment.polarity}")
print(f"主观性: {blob.sentiment.subjectivity}")
如果输出类似这样的结果,说明环境搭建成功了:
情感极性: 0.625
主观性: 0.6
极性为正数,说明这句话是正面情感。0.625 算是比较积极的了。
避坑指南:我曾经遇到过一个问题——TextBlob 安装成功了,但运行时报错说找不到语料库。后来发现是下载语料库时网络中断了。解决办法是重新运行 python -m textblob.download_corpora,或者手动下载后放到指定目录。
1.5 本章知识体系
来,我画了张图,把这一章的核心逻辑串起来:
这张图把整个流程串起来了。说白了就是:装 Python → 建虚拟环境 → 装库 → 下语料 → 验证。一步都不能少。
1.6 常见问题与解决
最后,我把自己踩过的坑整理一下:
- pip 安装超时:国内网络问题,可以加镜像源。比如
pip install textblob -i https://pypi.tuna.tsinghua.edu.cn/simple - 虚拟环境激活失败:Windows 下如果报「无法加载文件」,用管理员身份打开 PowerShell,执行
Set-ExecutionPolicy RemoteSigned - TextBlob 找不到语料库:重新运行
python -m textblob.download_corpora,或者检查网络连接 - Flask 启动报端口占用:换个端口就行,比如
app.run(port=5001)
总结一下:环境搭建是开发的第一步,也是最重要的一步。别着急,慢慢来。我当年第一次搭环境也折腾了两天。现在你照着这个流程走,半小时应该就能搞定。
公众号:蓝海资料掘金营,微信deep3321