### 创建 Orcaflax Python 开发环境指南 #### 1. 安装依赖工具 为了创建一个隔离的开发环境，建议安装 `pyenv` 和 `virtualenv` 工具来管理多个 Python 版本以及虚拟环境[^3]。 ```bash brew update brew install pyenv echo 'if command -v pyenv 1>/dev/null 2>&1; then\n eval "$(pyenv init -)"\nfi' >> ~/.zshrc source ~/.zshrc ``` #### 2. 设置 Git 配置 确保全局 Git 用户名和邮箱已设置，这对于版本控制非常重要[^5]： ```bash git config --global user.name "Your Name" git config --global user.email "you@example.com" ``` #### 3. 初始化项目结构 建立项目的根目录并初始化必要的文件夹结构: ```bash mkdir orcaflax && cd $_ touch README.md LICENSE .gitignore requirements.txt git init . ``` #### 4. 构建虚拟环境 使用 `venv` 或者 `virtualenv` 来构建独立于系统的 Python 运行时环境[^1]: ```bash python3 -m venv env_orcaflax source env_orcaflax/bin/activate pip install --upgrade pip setuptools wheel ``` #### 5. 添加依赖包 编辑 `requirements.txt` 文件以定义所需的库列表，并通过命令安装这些依赖项： ```plaintext # requirements.txt numpy==1.21.0 pandas>=1.3.0,<2.0.0 matplotlib>=3.4.0,<4.0.0 scikit-learn>=0.24.0,<1.0.0 jupyterlab>=3.0.0,<4.0.0 ``` 运行如下命令完成依赖安装： ```bash pip install -r requirements.txt ``` #### 6. 测试环境配置 启动 Jupyter Notebook 并验证所有组件是否正常工作： ```bash jupyter notebook ``` 打开浏览器访问 http://localhost:8888 查看服务状态。