本机开发环境配置

版本管理工具

1. miniconda - Python 环境和包管理，主要用于深度学习
2. fnm (Fast Node Manager) - Node.js 版本管理，通过 Homebrew 安装
3. rbenv - Ruby 版本管理，当前使用 Ruby 3.3.8

环境变量配置

配置文件位置：~/.zshrc（使用 zsh shell）

主要配置项

PATH 加载顺序（优先级从高到低）

1. fnm 当前激活的 Node 版本
2. WorkBuddy Node.js
3. miniconda3
4. Homebrew (/opt/homebrew/bin)
5. 系统路径 (/usr/local/bin, /usr/bin 等)
6. Cargo (Rust)
7. Flutter SDK ($HOME/flutter/bin)
8. Pub 缓存 ($HOME/.pub-cache/bin)

注意：rbenv 通过 eval "$(rbenv init -)" 动态修改 PATH，将 shims 目录插入到 PATH 最前面

Homebrew 镜像配置

使用阿里云镜像加速：

• HOMEBREW_API_DOMAIN - API 域名
• HOMEBREW_BOTTLE_DOMAIN - 二进制包域名
• HOMEBREW_PIP_INDEX_URL - PyPI 镜像
• HOMEBREW_AUTO_UPDATE_SECS=604800 - 每周自动更新

已安装的包和应用汇总

1. Conda 环境（5个）

base 环境主要包（当前激活）

• 深度学习: torch==2.11.0, torchvision==0.26.0, numpy==2.4.4
• Conda 工具: conda==26.1.1, conda-libmamba-solver
• GUI 框架: customtkinter==5.2.2 (现代 Tkinter 主题)
• 其他: pillow, sympy, requests, click, rich, typer

ml_env 环境主要包

• 可视化: altair, matplotlib (fonttools, contourpy)
• Jupyter: ipython, jupyterlab相关组件
• 数据处理: beautifulsoup4, bleach
• Git 集成: gitpython

mlx-whisper 环境主要包

• MLX 相关: mlx-whisper (Apple Silicon 优化的 Whisper)
• Web UI: gradio==6.12.0, fastapi
• 语音处理: audioread, asteroid-filterbanks, julius
• Hugging Face: huggingface-hub, hf-gradio, hf-xet
• ML 工具: einops, joblib, lazy-loader

2. Homebrew 安装的软件

Formula（命令行工具）

• btop - 系统资源监控工具
• ca-certificates - SSL 证书
• ffmpeg - 音视频处理工具
• fnm - Fast Node Manager（Node.js 版本管理）
• gh - GitHub CLI
• go - Go 语言
• macmon - Mac 系统监控
• mpdecimal - 高精度十进制运算库
• openssl@3 - SSL/TLS 库
• python@3.12 - Python 3.12
• rbenv - Ruby 版本管理
• readline - 命令行编辑库
• ruby-build - Ruby 编译安装工具
• smartmontools - 硬盘健康检测
• sqlite - 轻量级数据库
• xz - 压缩工具
• zeromq - 高性能消息队列库

Cask（图形界面应用）

• antigravity-tools - 反重力工具
• google-cloud-sdk - Google Cloud 开发工具包

3. npm 全局包（使用 fnm 管理）

总结

• 虚拟环境: miniconda（管理 3 个环境）
• Node 版本管理: fnm (Fast Node Manager)
• Python 版本: 3.13.12 (base), 3.11 (ml_env), 3.x (mlx-whisper)
• 主要用途: 深度学习 (PyTorch)、语音转文字 (MLX Whisper)、Web 开发 (Gradio/FastAPI)

更新指南

如需更新本文档，请执行以下命令：

1. 查看 Conda 环境

1

conda env list

2. 查看当前环境已安装的包

1

pip list --format=freeze

3. 查看指定 Conda 环境的包

1
2

conda list -n ml_env
conda list -n mlx-whisper

4. 查看 Homebrew 安装的软件

1
2
3
4
5

# 命令行工具
brew list --formula

# 图形界面应用
brew list --cask

5. 查看 npm 全局包

1

npm list -g --depth=0

6. 查看当前 Python 版本和路径

1

which python && python --version

7. 查看环境变量

1
2
3
4
5
6
7
8
9

# 查看所有环境变量
env

# 查看 PATH
echo $PATH

# 查看特定变量
echo $HOME
echo $SHELL

8. 查看 Ruby 版本（rbenv）

1
2
3
4
5
6
7
8

# 查看当前 Ruby 版本
rbenv version

# 查看所有已安装版本
rbenv versions

# 查看 rbenv 环境变量
echo $RBENV_VERSION