Bubbly修改项目名称方法

作者:技术拾光时间:2026-06-15 13:27:02浏览:196

在Bubbly项目中修改项目名称时,需同步更新文件夹名、.bubblyproj文件及内部标签、源码中的硬编码引用、构建配置文件等,否则会导致构建失败或主类找不到。最后执行清理、构建并验证页面标题及文件名称。

在Bubbly项目中修改项目名称,看似简单,但如果不同步更新所有关联位置,轻则构建失败,重则运行时甚至无法找到主类。这项操作涉及工程文件名、配置文件中的标识符、源码中的硬编码引用以及构建产物的显示名称,任何一处遗漏都可能引发问题。 以下梳理标准流程,帮助您避免常见错误。

第一步:关闭编辑器并重命名项目文件夹

首先,务必关闭Bubbly IDE、VS Code等编辑器。然后在文件管理器中找到项目文件夹,右键重命名为新名称,例如将hello-world改为my-bubbly-app,按回车确认。这一步是后续所有操作的基础——路径不统一将使后续修改因找不到路径而失效。

同步重命名工程配置文件

项目根目录下有一个与文件夹同名的、扩展名为.bubblyproj的工程配置文件。例如原文件为hello-world.bubblyproj,现在必须一并改为my-bubbly-app.bubblyproj。否则Bubbly加载时会直接报错“Project file not found”。 Bubbly修改项目名称方法

第二步:修改项目配置文件中的名称字段

使用文本编辑器打开.bubblyproj文件,找到标签,将旧名称(例如HelloWorld)替换为新名称(例如MyBubblyApp),保存。随后继续查找和两个标签,确保其值也与新项目名完全一致。若存在,同样更新为匹配的新命名空间(如MyBubblyApp)。这三个字段缺一不可,漏掉任何一个都会导致最终生成的文件名或程序集名称错误。

第三步:更新源码中硬编码的项目引用

打开src/Program.bbl(或项目的主入口文件),检查其中是否包含类似project "HelloWorld"或appname: "HelloWorld"的声明,全部替换为新名称。 然后在整个项目内搜索旧名称:按Ctrl+Shift+F,关键词带英文引号(例如"HelloWorld"),排除node_modules和dist目录。重点检查以下文件:
  • package.json中的"name"字段
  • build.config.js中的output.dir和appInfo.title
每一处都需要替换为新项目名。如果项目启用了模块化路由或资源加载,不要遗漏public/manifest.json和public/index.html中的name、short_name、标签,否则浏览器标签页仍会显示旧名称,导致更新无效。

第四步:清理缓存并验证构建

完成所有修改后,按以下顺序验证:
  1. 在终端进入项目根目录,执行bubbly clean。
  2. 然后执行bubbly build。
  3. 如果构建时报错Error: Cannot find module './dist/HelloWorld.js',说明某处路径未更新——立即检查build.config.js中entry字段和output.filename是否还残留旧名称。
  4. 构建成功后,运行bubbly serve,访问http://localhost:8080,确认页面标题、控制台输出、打包后的JS文件名都已显示新名称。
整个过程并不复杂,但每一步环环相扣。只要按照这个清单执行一遍,项目改名就不会出现问题。