在Visual Studio Code中安装AgML数据集时遇到报错问题

针对带main分支命令的编码错误 #

错误原因是Windows环境下Python默认用GBK编码读取文件，而AgML项目部分文件采用UTF-8编码，导致解码失败。可以通过强制Python使用UTF-8编码解决：

在.ipynb单元格中先执行：

import os
os.environ['PYTHONUTF8'] = '1'

再执行安装命令：

!pip install -e git+https://github.com/Project-AgML/AgML.git@main#egg=agml

或者直接在VS Code终端中先设置环境变量再安装：

set PYTHONUTF8=1
pip install -e git+https://github.com/Project-AgML/AgML.git@main#egg=agml

针对无分支命令的超时问题 #

不带分支的命令会默认拉取仓库所有历史提交和分支，国内网络环境下易超时。可以指定分支并启用浅克隆只拉取最新版本：

!pip install -e git+https://github.com/Project-AgML/AgML.git@main#egg=agml --config-settings "git+https://github.com/Project-AgML/AgML.git@main#egg=agml.vcs.clone=--depth 1"

也可以手动克隆后安装：

1. 浅克隆仓库：

git clone --depth 1 https://github.com/Project-AgML/AgML.git

2. 进入仓库目录执行开发模式安装：

cd AgML
pip install -e .

额外建议 #

• 确保虚拟环境激活后执行安装命令，避免影响全局Python环境。
• 若网络仍不稳定，可在pip命令后添加国内镜像源参数：-i https://pypi.tuna.tsinghua.edu.cn/simple

内容的提问来源于stack exchange，提问作者温泽海