开发者模式
QingERP 在后台顶部提供开发者模式快捷入口。需要排查页面或查看技术信息的内部用户,可以在当前业务页面一键开启 Odoo 原生开发者模式(Debug),无需先进入设置页面。
适用条件
本页适用于已安装包含此快捷入口的 Odoo 20 版 Qing Web UI(qing_web_ui) 的实例。是否能看到按钮,以当前实例实际安装的模块版本和登录账号为准。此功能从 qing_web_ui 版本 20.0.1.0.8 加入。
如何一键开启
- 使用内部用户账号登录 QingERP 后台,打开需要检查的业务页面。
- 先保存表单中尚未保存的修改;切换开发者模式会重新加载页面。
- 在页面顶部工具区找到虫子图标。将鼠标移到图标上,可看到“激活开发者模式”的提示;在手机上直接点按图标。
- 点击图标。页面重新加载后进入普通开发者模式,通常会保留当前应用、操作和记录位置。
启用后,原来的快捷按钮会消失,同一位置由 Odoo 原生开发者菜单接替。打开该菜单可以查看当前页面可用的技术工具。
可以用它做什么
开发者模式会显示一些平时隐藏的技术信息和菜单,例如查看视图、字段或动作的相关信息。具体可见选项取决于当前页面、已安装模块及账号权限。它适合实施顾问和技术人员排查界面与配置问题。
开启开发者模式不会自动授予管理员权限。 即使普通内部用户能看到快捷按钮,仍只能访问自己原本有权查看或操作的数据。修改技术配置前,应先确认影响范围。
如何关闭
打开顶部的原生开发者菜单,选择 退出开发者模式。如果无法找到菜单,也可以将当前系统网址的 debug 参数改为 0 后重新打开页面,例如:
https://你的系统地址/odoo?debug=0
关闭后,如果账号仍是内部用户,虫子图标会重新出现。它是开启入口,不是反复点击同一个图标来切换开关。
普通开发者模式与资源调试
快捷按钮开启的是普通开发者模式(debug=1),适合查看页面技术信息。开发者排查 JavaScript 或样式资源时可能使用 debug=assets,这属于另一种模式,快捷按钮不会自动启用资源调试。资源调试加载方式不同,通常只在排查前端问题时使用。
看不到按钮怎么办
| 情况 | 先检查什么 |
|---|---|
| 顶部没有虫子图标 | 是否为内部用户;当前实例是否安装了包含该功能的 qing_web_ui 版本 |
| 原来的虫子图标消失 | 可能已经开启开发者模式;查看同位置是否出现原生开发者菜单 |
| 点击后仍不能打开某个技术菜单 | 当前账号的权限、所在公司和该功能的访问限制 |
| 点击后页面位置变化 | 切换需要重新加载;先确认之前的表单是否已保存,再回到目标记录 |
门户用户和公开访客不会看到这个快捷入口。若已满足条件但仍无法显示,请让管理员核对模块升级、后台资源加载和浏览器刷新情况。