环境配置

环境配置#

欢迎来到 FEALPy 用户手册的环境配置章节！

本章节将详细介绍如何在本地正确配置和安装 FEALPy，帮助您顺利搭建开发与运行环境。无论您是初学者还是有经验的开发者，都可以通过本节内容快速完成环境准备，为后续的学习和项目实践打下坚实基础。

1. 克隆仓库#

从 GitHub 克隆 FEALPy 仓库到本地，可选择 HTTPS 或 SSH 方式：

# HTTPS 方式（推荐新手使用）
git clone https://github.com/weihuayi/fealpy.git

# SSH 方式（需配置 GitHub SSH 密钥）
git clone git@github.com:weihuayi/fealpy.git

访问说明：
建议访问 FEALPy GitHub 仓库 查看最新版本和文档

2. 环境初始化#

推荐：创建虚拟环境#

# 创建虚拟环境（可选但推荐）
python -m venv fealpy-env

# 激活虚拟环境
# Windows:
fealpy-env\Scripts\activate
# Linux/macOS:
source fealpy-env/bin/activate

安装 FEALPy#

# 进入项目目录
cd fealpy

# 标准安装（推荐普通用户）
pip install .

# 开发模式安装（推荐贡献者）
pip install -e .  # 代码修改后无需重新安装

模式对比：

安装方式

适用场景

特点

pip install .

生产环境/常规使用

代码修改后需重新安装

pip install -e .

开发/调试

实时反映代码修改

3. 安装验证#

# 验证安装
python -c "import fealpy; print(f'Success! FEALPy version: {fealpy.__version__}')"

故障排除：
若导入失败，请检查：

  1. 虚拟环境是否激活

  2. 是否在项目目录中执行安装

  3. 使用 pip list | grep fealpy 确认安装

4. 代码同步与更新#

更新策略选择#

# 方式1：强制更新（丢弃所有本地修改）
git fetch --all
git reset --hard origin/main

# 方式2：保留本地修改（可能需解决冲突）
git pull origin main
Contents