-
Python
推荐使用
Anaconda作为Python基础环境，推荐前往 清华大学镜像下载 最新版安装包。为避免多个Python环境造成的相互冲突等问题，建议使用Python虚拟环境进行管理。步骤如下：- 打开Anconda终端或者cmd，使用命令
conda create -n MRC python=3.6.5创建一个名为MRC的Python虚拟环境（MRC即Music Recommendation的缩写）； - 输入
conda activate MRC激活MRC虚拟环境，在此虚拟环境下安装需要的Python第三方库； - 使用命令
conda install --yes --file requirements.txt批量所需的Python组件依赖（requirements.txt文件在back-end\recommend_service目录下，建议上述步骤可在该目录下进行），对于有些安装失败的可单独使用conda命令或pip命令安装； - 至此项目所需的Python环境安装完成。
- 打开Anconda终端或者cmd，使用命令
-
SoX
SoX是开源的音频处理软件，本项目使用该工具处理音频文件。本项目tools目录下已提供Windows安装包，安装教程参考 这篇文章，并注意 将SoX添加到环境变量。 -
WAMP
WAMP环境即
Windows操作系统、Apache服务器、MySQL数据库以及PHP语言，可直接使用 phpStudy 或者 appserv 等集成环境一键安装。Linux操作系统请自行安装相应的LAMP环境。MySQL数据库环境需要进行如下设置，新建名为
music_recommender的数据库，数据库用户名为music_system，密码为music_system，并注意给予相应的数据库访问权限，然后导入back-end\DataBase目录下的music_recommender.sql文件中的数据。推荐使用开源的数据库管理客户端 HeidiSQL 管理数据库。 -
Node.js
前端开发环境所需依赖，前往 官网下载 最新稳定版安装包进行安装。安装Node环境后打开终端命令行并且切换到
front-end目录下，使用命令npm install安装前端依赖，出现安装失败问题可尝试设置淘宝镜像源或者使用yarn/cnpm等方式。 -
前端开发工具
-
后台服务端部署
将
back-end整个目录移动到WAMP环境安装目录的www目录下，并将目录重命名为MRC以保证和前端的请求url相同。 -
启动推荐服务
使用
Anconda终端或者命令行切换到back-end\recommend_service或者MRC\recommend_service目录下，运行命令conda activate MRC激活MRC虚拟环境，激活环境后输入python recommend_service.py运行推荐脚本。 -
运行小程序
使用
HBuilderX打开front-end目录，（可选、推荐：将小程序的appID更换为自己的appID），点击工具栏的运行→运行到小程序模拟器→微信开发者工具，uni-app框架将自动打包项目在dist\dev目录下生成为原生微信小程序项目mp-weixin，并自动运行微信开发者工具打开项目，即可在微信开发者工具中查看运行结果。
-
SoX报错
对于
Windows系统下可能会出现的Unable to load MAD decoder library (libmad) function错误，解决方法可参考 这个问题的答案。此报错只需将tools目录下提供的两个库文件，放到SoX安装目录下即可。 -
小程序无内容
- 如出现推荐无内容，需确保推荐脚本
recommend_service.py已正常运行； - 确保
front-end项目代码下的src\config\index.js文件中对应的url地址与实际环境的url地址一致，包括端口等； - 如出现搜索无内容，需确保当前计算机正常联网，以便能正常获取网易云音乐的数据。
- 如出现推荐无内容，需确保推荐脚本
-
HBuilderX无法自动运行微信开发者工具
若出现无法自动运行
微信开发者工具的情况可提前手动运行工具或者参考这个 解决方案。 -
小程序真机运行无内容
想要在真机环境下运行小程序，可将
back-end目录部署到远程服务器或者将本地计算机与手机处在同一局域网内，并在front-end项目代码下的src\config\index.js文件中对应的url地址替换成相应的地址。