Frappe/Bench 核心命令使用指南：从安装到日常维护
项目地址: https://gitcode.com/gh_mirrors/be/bench 前言
Frappe框架的Bench工具是开发者管理Frappe应用生态的核心利器。本文将全面解析Bench的核心命令及其应用场景，帮助开发者高效管理Frappe环境。
环境更新与维护
Bench工具自身更新
保持Bench CLI工具处于最新状态是维护环境健康的第一步。根据安装方式不同，更新命令也有所差异：
pip3 install -U frappe-bench
完整环境更新
bench update 是一个全能命令，它会执行以下操作：
- 拉取所有应用的代码更新
- 执行数据库迁移
- 重新构建前端资源
- 重启相关服务
bench update
选择性更新
对于需要精细控制的场景，Bench提供了模块化更新选项：
-
仅更新代码库：
bench update --pull -
仅执行数据库迁移：
bench update --patch -
仅构建前端资源：
bench update --build -
仅更新Bench工具：
bench update --bench -
更新依赖项：
bench update --requirements
环境初始化与配置
创建新Bench环境
初始化命令会创建一个包含Frappe框架的目录结构，并自动配置每日备份和更新：
bench init frappe-bench && cd frappe-bench
站点管理
Frappe应用运行在站点环境中，创建站点的基本命令：
bench new-site site1.local
应用管理
获取远程应用
从Git仓库获取并安装Frappe应用：
bench get-app erpnext https://github.com/frappe/erpnext
安装应用到站点
将应用安装到指定站点：
bench --site site1.local install-app erpnext
开发与调试
启动开发服务器
启动本地开发环境：
bench start
启动后，可通过浏览器访问 http://localhost:8000。默认管理员账号为"Administrator"，密码为创建站点时设置的密码。
高级功能：Bench管理面板
bench setup manager 命令提供了一站式管理解决方案：
- 创建专用管理站点
- 自动获取bench_manager应用
- 在管理站点上安装该应用
bench setup manager
最佳实践建议
- 定期更新：建议至少每周执行一次完整更新，保持环境安全稳定
- 备份策略：在重大更新前手动备份关键站点
- 模块化更新：生产环境建议分步执行更新，便于问题排查
- 环境隔离：为不同项目创建独立的Bench环境
通过掌握这些核心命令，开发者可以高效管理Frappe开发环境，专注于业务逻辑的实现而非环境维护。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
