国内网络环境下 MiniConda + Jupyter + ChromaDB 安装教程

针对国内网络环境，使用国内镜像源加速下载。

第一部分：安装 MiniConda（使用国内下载源）

步骤 1：下载 MiniConda（国内镜像）

1. 清华大学镜像源：

   https://mirrors.tuna.tsinghua.edu.cn/anaconda/miniconda/

2. 中国科学技术大学镜像：

   https://mirrors.ustc.edu.cn/anaconda/miniconda/

3. 推荐下载：

   • Miniconda3-py310_23.5.2-0-Windows-x86_64.exe

   • 对应 Python 3.10 版本

步骤 2：安装 MiniConda

1. 双击运行下载的 .exe 文件

2. 重要选项：

   • ✅ 为所有用户安装（可选）

   • ✅ 添加 Miniconda3 到系统 PATH 环境变量（必须勾选！）

   • ✅ 注册 Miniconda3 为默认 Python

3. 点击 Install，等待安装完成

步骤 3：配置 Conda 国内镜像

打开 Anaconda Prompt（在开始菜单中搜索）：

第二部分：创建 Python 环境

步骤 1：创建新环境（使用国内源）

步骤 2：激活环境

conda activate chroma-env

激活后，提示符前会显示 (chroma-env)

步骤 3：配置 pip 国内镜像

第三部分：安装 Jupyter

步骤 1：安装 Jupyter（使用 Conda 镜像）

步骤 2：配置 Jupyter 中文支持（可选）

步骤 3：生成 Jupyter 配置文件

第四部分：安装 ChromaDB 及依赖

步骤 1：安装 ChromaDB

步骤 2：安装依赖包

第五部分：备用安装方案（如果上述方法失败）

方案 A：使用离线包安装

1. 下载离线包：

   • Jupyter: https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple/jupyter/

   • ChromaDB: https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple/chromadb/

   • 其他包同理

2. 离线安装：

方案 B：手动下载安装（针对特别难装的包）

第六部分：验证安装

步骤 1：创建测试脚本

创建 test_installation.py 文件：

步骤 2：运行测试

python test_installation.py

第七部分：快速使用指南

启动 Jupyter：

创建快捷方式（可选）：

1. 在桌面创建 .bat 文件，内容：

@echo off
call conda activate chroma-env
start jupyter lab
pause