2. Python 环境搭建:Anaconda安装、Jupyter Notebook配置、必备库安装

在开始自动化良率报告开发之前,必须搭建一个稳定、可复现的 Python 数据科学环境。本章将指导你完成从零开始的完整环境配置,包括 Anaconda 发行版安装、Jupyter Notebook 交互式开发环境配置,以及 pandas、matplotlib、plotly、openpyxl 等核心库的安装与验证。

💡 学习目标: 完成本章后,你将拥有一个可直接运行良率趋势图与 Pareto 分析代码的 Python 环境,并掌握使用 conda 管理虚拟环境的基本技能。

2.1 Anaconda 发行版安装

Anaconda 是一个开源的 Python 发行版,预装了超过 1500 个数据科学包,并自带 conda 包管理器。它能够有效避免不同项目间的依赖冲突,是良率分析项目的最佳起点。

2.1.1 安装步骤

  1. 下载安装包: 访问 Anaconda 官网(https://www.anaconda.com/download),根据操作系统选择对应的 Python 3.9+ 版本安装包。
  2. 运行安装程序:
    • Windows: 双击 .exe 文件,建议勾选“Add Anaconda to my PATH environment variable”(若未勾选,后续需手动配置环境变量)。
    • macOS/Linux: 在终端运行 bash Anaconda3-*.sh,按提示完成安装。
  3. 验证安装: 打开终端(或 Anaconda Prompt),输入以下命令:
conda --version
python --version

若正确显示版本号(如 conda 23.x.x,Python 3.9.x),则安装成功。

⚠️ 常见问题: 若终端提示“conda 不是内部或外部命令”,请检查是否勾选了“Add to PATH”,或手动将 Anaconda 的 Scripts 目录(如 C:\Users\用户名\anaconda3\Scripts)添加到系统环境变量中。

2.1.2 创建独立虚拟环境

为避免不同课程项目间的库版本冲突,建议为良率报告项目创建专属虚拟环境:

conda create -n yield_report python=3.9 -y
conda activate yield_report

激活后,终端提示符前会出现 (yield_report) 字样,表示已进入该环境。

Anaconda 安装与虚拟环境创建流程 下载安装包 运行安装程序 验证安装 conda create -n yield_report conda activate yield_report 💡 虚拟环境隔离项目依赖,避免库版本冲突 激活后终端提示符显示 (yield_report) 即表示成功

2.2 Jupyter Notebook 配置

Jupyter Notebook 是数据科学领域最流行的交互式开发工具,支持代码、可视化图表和说明文本的混合编排,非常适合良率报告的探索性分析与模板开发。

2.2.1 安装与启动

在激活的 yield_report 环境中,执行以下命令:

conda install jupyter notebook -y
jupyter notebook

执行后,浏览器将自动打开 Jupyter 主界面(默认地址:http://localhost:8888)。

2.2.2 核心配置优化

配置项 推荐值 说明
默认工作目录 c.NotebookApp.notebook_dir = 'D:/yield_report' 统一管理项目文件,避免路径混乱
自动保存间隔 c.FileContentsManager.autosave_interval = 60 每 60 秒自动保存,防止数据丢失
密码保护 c.NotebookApp.password = 'sha1:...' 防止未授权访问(可选)

配置文件位于 ~/.jupyter/jupyter_notebook_config.py,若不存在,可通过 jupyter notebook --generate-config 生成。

🔧 实用技巧: 在 Jupyter Notebook 中,按 Shift + Enter 执行当前单元格;按 Esc + M 将单元格切换为 Markdown 模式,用于编写说明文档。
Jupyter Notebook 交互式开发流程 启动 Notebook 新建笔记本 编写代码/文档 运行与调试 迭代开发循环 💡 支持代码、Markdown、可视化混合编排,实时查看结果 Shift+Enter 执行单元格,Esc+M 切换 Markdown 模式

2.3 必备库安装与验证

良率报告自动化需要依赖四个核心库:pandas(数据处理)、matplotlib(静态图表)、plotly(交互式图表)、openpyxl(Excel 读写)。

2.3.1 安装命令

在激活的 yield_report 环境中,依次执行:

conda install pandas matplotlib plotly openpyxl -y

或使用 pip 安装(若 conda 源中版本较旧):

pip install pandas matplotlib plotly openpyxl

2.3.2 库功能对比

库名 版本(建议) 核心功能 在良率报告中的用途
pandas ≥ 1.5.0 数据清洗、聚合、透视表 读取良率 CSV/Excel,计算日/周良率,生成 Pareto 数据
matplotlib ≥ 3.6.0 静态图表绘制 绘制良率趋势折线图、Pareto 柱状图
plotly ≥ 5.12.0 交互式图表 生成可缩放、悬停显示详情的动态良率趋势图
openpyxl ≥ 3.1.0 Excel 文件读写与样式设置 将分析结果写入 Excel 模板,设置单元格格式、图表嵌入

2.3.3 验证安装

在 Jupyter Notebook 中新建一个单元格,输入以下代码并执行:

import pandas as pd
import matplotlib.pyplot as plt
import plotly.express as px
import openpyxl

print("pandas 版本:", pd.__version__)
print("matplotlib 版本:", plt.matplotlib.__version__)
print("plotly 版本:", px.__version__)
print("openpyxl 版本:", openpyxl.__version__)
print("✅ 所有必备库安装成功!")

若输出各库版本号且无报错,则环境搭建完成。

⚠️ 版本兼容性提示: 若后续运行代码时遇到 ImportError 或 AttributeError,请检查库版本是否过旧。建议使用 conda update --all 保持环境最新。
良率报告必备库依赖关系 Python 3.9+ pandas matplotlib plotly openpyxl 💡 四个库各司其职:数据处理 → 静态图表 → 交互图表 → Excel 输出 通过 conda 一次性安装,避免逐个下载的麻烦

2.4 环境验证综合测试

为确认整个环境链路的完整性,运行以下综合测试代码:

import pandas as pd
import matplotlib.pyplot as plt
import plotly.express as px
import openpyxl

# 1. pandas 数据创建
df = pd.DataFrame({
    '日期': ['2024-01-01', '2024-01-02', '2024-01-03'],
    '良率': [0.95, 0.97, 0.96]
})
print("✅ pandas 数据创建成功")

# 2. matplotlib 简单绘图
plt.plot(df['日期'], df['良率'])
plt.title('良率趋势测试')
plt.savefig('test_trend.png')
print("✅ matplotlib 绘图成功")

# 3. plotly 交互式绘图
fig = px.line(df, x='日期', y='良率', title='良率趋势测试(交互式)')
fig.write_html('test_trend.html')
print("✅ plotly 交互图生成成功")

# 4. openpyxl 写入
wb = openpyxl.Workbook()
ws = wb.active
ws['A1'] = '测试通过'
wb.save('test_output.xlsx')
print("✅ openpyxl Excel 写入成功")

print("🎉 环境验证全部通过!")

执行后,当前目录应生成 test_trend.png、test_trend.html、test_output.xlsx 三个文件,且控制台输出全部成功信息。

📁 项目目录建议: 建议将良率报告项目文件统一放在 D:/yield_report(Windows)或 ~/yield_report(macOS/Linux)目录下,并在 Jupyter 配置中将其设为默认工作目录,便于后续课程文件管理。