必须选对芯片架构：intel mac用x86_64包，apple silicon（m1/m2/m3）用arm64包；装错会导致conda无法执行或报“bad cpu type”；安装后conda命令不可用，多因未运行conda init zsh且未重启终端。
Mac安装Miniconda必须选对架构包
装错架构是新手最常踩的坑——Intel芯片用了arm64包，或M1/M2/M3芯片用了x86_64包，会导致conda命令根本无法执行，甚至终端报Bad CPU type in executable错误。
- Intel Mac：下载
Miniconda3-latest-MacOSX-x86_64.pkg（图形化）或Miniconda3-latest-MacOSX-x86_64.sh（命令行） - Apple Silicon（M1/M2/M3）：必须用
Miniconda3-latest-MacOSX-arm64.pkg或Miniconda3-latest-MacOSX-arm64.sh - 别信Rosetta兼容——虽然能跑，但Python启动慢、Metal加速失效、某些包（如
torch）可能不识别GPU
安装后conda命令找不到？多半是初始化没走完
即使安装成功，conda --version 报 command not found，大概率是Shell初始化中断了。PKG安装时勾选了“Initialize Miniconda”，但脚本安装默认不自动注入.zshrc。
- 先确认是否已运行：
conda init zsh（macOS Catalina及以后默认用zsh） - 运行后必须关闭当前终端，再新开一个——
source ~/.zshrc不等于重载全部初始化逻辑 - 检查
.zshrc末尾是否新增了类似这段内容：# >>> conda initialize >>> # ...（多行conda相关配置） #
- 如果没写入，手动加一行：
export PATH="$HOME/miniconda3/bin:$PATH"（路径以你实际安装位置为准）
安装路径含中文、空格或桌面目录会直接导致后续失败
这不是警告，是硬性限制。conda create、pip install、甚至Jupyter kernel注册，遇到路径里有中文或空格时会静默失败或报OSError: [Errno 2] No such file or directory。
Miniconda Linux版
下载
Miniconda py314_26.5.3-2 Linux x86_64 安装脚本，来自 Anaconda 官方 Miniconda 下载目录，适合服务器、工作站和容器环境配置轻量 Conda 与 Python。
- 推荐路径：
~/miniconda3（用户主目录下）或/opt/miniconda3（需sudo权限，不推荐新手） - 绝对避开：
~/Desktop/Miniconda、/Users/张三/miniconda3、~/My Tools/miniconda - 验证方式：运行
which conda，输出路径中不能出现中文、空格、括号或特殊符号
验证安装是否真正可用，别只看conda --version
只验证版本号容易误判——base环境可能没加载Python解释器，或者PATH指向了系统Python而非Miniconda自带的。
- 依次执行并确认输出合理：
conda --version、python --version、which python -
which python必须返回类似/Users/xxx/miniconda3/bin/python，而不是/usr/bin/python3 - 进Python交互环境后，检查
sys.executable和sys.prefix是否都指向Miniconda安装路径 - 如果
python --version显示系统版本（如3.9.6），说明conda activate base没生效，或初始化失败
安装完成后的第一件事不是建环境，而是立刻配置清华镜像源——否则conda create下载包可能卡在10%，且无进度提示。这个动作比选Python版本还关键。
