MongoEngine 是一个用来操作 MongoDB 的 ORM 框架，如果你不知道什么是 ORM，可以参考 Flask-SQLAlchemy 一节。在 Flask 中，我们可以直接使用 MongoEngine，也可使用 Flask-MongoEngine ，它使得在 Flask 中使用 MongoEngine 变得更加简单。
### Win系统下为Python3.5安装flask-mongoengine库
#### 一、概述
在Windows环境下，针对Python3.5版本安装`flask-mongoengine`库时可能会遇到一些特殊的挑战。本文将详细介绍安装步骤及过程中可能遇到的问题与解决方法。
#### 二、背景知识
**1. Python**：一种解释型、面向对象、动态数据类型的高级程序设计语言。Python3.5是Python3系列中的一个版本。
**2. Flask**：基于Python的一个Web应用框架。Flask轻量级且灵活，易于上手，适合开发小型到中型规模的应用。
**3. MongoDB**：一种NoSQL数据库，提供了高性能、高可用性和自动扩展功能。
**4. ORM（Object Relational Mapping）**：对象关系映射，是一种编程技术，用于将对象模型与关系型数据库之间的数据进行转换。
**5. MongoEngine**：一个用于操作MongoDB的ORM框架，提供了一个简洁而强大的API来处理数据。
**6. Flask-MongoEngine**：专门为Flask设计的MongoEngine扩展，使得在Flask应用中使用MongoDB更加简便。
#### 三、安装环境
- **操作系统**：Windows 10
- **Python版本**：Python 3.5
- **Flask-MongoEngine版本**：0.8.2 或 0.9.0
#### 四、安装步骤
1. **确保Python环境已安装**：
- 首先确认计算机上已经正确安装了Python3.5，并且添加到了系统的环境变量中。
2. **安装pip**（如果尚未安装）：
- 打开命令提示符，执行命令 `python -m ensurepip --upgrade` 来安装或升级pip。
3. **安装Flask-MongoEngine**：
- 使用pip命令安装 `flask-mongoengine`：
```
pip install flask-mongoengine
```
- 在安装过程中，可能会出现错误提示如：
```
UnicodeDecodeError: 'gbk' codec can't decode byte 0xa6 in position 3978: illegal multibyte sequence
```
#### 五、解决安装错误
1. **定位问题**：
- 错误出现在`flask-mongoengine-0.8.2\setup.py`文件中的第10行：
```python
doc_path = os.path.join(os.path.dirname(__file__), "docs", "index.rst")
long_description = open(doc_path).read()
```
- 这段代码尝试打开并读取`docs/index.rst`文件的内容，但由于文件编码问题导致无法正常解析。
2. **手动下载源码**：
- 访问GitHub下载`flask-mongoengine`的源码包。
3. **修改文件内容**：
- 找到`docs/index.rst`文件，删除其内容或确保文件编码为UTF-8。
4. **重新安装**：
- 使用以下命令重新安装：
```
python setup.py install
```
- 如果仍然出现问题，可以考虑使用虚拟环境来隔离项目依赖，或者尝试安装不同版本的`flask-mongoengine`。
#### 六、其他注意事项
- **环境兼容性**：确保使用的Python版本与Flask-MongoEngine版本兼容，避免因版本不匹配导致的问题。
- **依赖管理**：建议使用虚拟环境（如`virtualenv`或`conda`）来管理项目依赖，避免全局环境中安装的包互相干扰。
- **更新维护**：定期检查是否有新的版本发布，及时更新至最新稳定版本以获取更好的支持和性能优化。
通过以上步骤，您可以在Windows环境下顺利安装并使用`flask-mongoengine`库，实现Flask应用与MongoDB之间的高效交互。
