终端类型快速识别 + 核心命令对照速查表

终端类型快速识别 + 核心命令对照速查表

一、终端类型快速识别（3秒分清）

终端类型	核心识别特征	示例界面片段
Windows CMD（命令提示符）	1. 标题显示“命令提示符”；2. 提示符为 > 或 (dataset-download) C:\>；3. 不支持 $env: 语法	(dataset-download) C:\prog\MDocAgent-main>
Windows PowerShell	1. 标题显示“Windows PowerShell”；2. 提示符为 > 或 PS C:\>；3. 支持 $env: 语法	PS C:\prog\MDocAgent-main> (dataset-download)
Git Bash/Linux/macOS	1. 提示符为 $ 或 (dataset-download) user@xxx:~$；2. 路径用正斜杠 /；3. 支持 export 语法	(dataset-download) user@PC:~/Projects/MDocAgent$

二、核心操作命令对照（直接复制执行）

操作步骤	Windows CMD	Windows PowerShell	Git Bash/Linux/macOS
创建虚拟环境	conda create -n dataset-download python=3.10 -y	conda create -n dataset-download python=3.10 -y	conda create -n dataset-download python=3.10 -y
激活虚拟环境	conda activate dataset-download	conda activate dataset-download	conda activate dataset-download
激活失败修复	conda init cmd.exe → 重启终端	conda init powershell → 重启终端	conda init bash → 重启终端；Linux/macOS额外执行 source ~/.bashrc/source ~/.zshrc
安装核心依赖（清华镜像）	pip install huggingface_hub -i https://pypi.tuna.tsinghua.edu.cn/simple	同CMD	同CMD
配置国内镜像（核心）	set HF_ENDPOINT=https://hf-mirror.com（无引号）	$env:HF_ENDPOINT = "https://hf-mirror.com"	export HF_ENDPOINT="https://hf-mirror.com"
验证镜像是否生效	echo %HF_ENDPOINT%	echo $env:HF_ENDPOINT	echo $HF_ENDPOINT
切换到脚本所在目录（示例）	cd E:\study\Projects\MDocAgent\MDocAgent	cd E:\study\Projects\MDocAgent\MDocAgent	cd /e/study/Projects/MDocAgent/MDocAgent（Git Bash）/ cd ~/Projects/MDocAgent（Linux/macOS）
运行下载脚本	python download_script.py	python download_script.py	python download_script.py
验证依赖安装成功	`pip list	findstr huggingface-hub`	`pip list
退出虚拟环境	conda deactivate	conda deactivate	conda deactivate

三、关键备注（避坑重点）

1. 所有命令需在虚拟环境激活后执行（终端前缀显示 (dataset-download)）；
2. 路径格式：Windows用反斜杠 \（如 E:\xxx），Git Bash/Linux/macOS用正斜杠 /（如 /e/xxx/~/xxx）；
3. 镜像配置仅临时生效，关闭终端后需重新执行；脚本内已内置镜像，终端未配置也不影响下载；
4. 若执行命令提示“命令未找到”，先检查终端是否激活虚拟环境，再确认Anaconda已添加到系统环境变量。