ExtJS 6.5经典工具包bootstrap.js类加载路径错误问题求助

我之前在ExtJS 6.5经典版开发时也碰到过几乎一模一样的问题，结合你描述的情况——构建成功但bootstrap.js加载错误路径、manifest里没有对应类的路径配置，大概率是命名空间映射、构建配置或者文件结构的问题，给你几个具体的排查和解决步骤：

1. 确认类名与物理路径的对应关系 #

ExtJS的类加载严格遵循类名=命名空间+文件路径的规则，你需要检查两个关键点：

• 视图类文件中的Ext.define是否使用了正确的完整类名：

  // 正确类名需对应路径 app/classic/src/view/sample/SampleView.js
  Ext.define('MyAppNs.view.sample.SampleView', {
      extend: 'Ext.panel.Panel',
      // ... 其他组件配置
  });
  

• 物理文件的层级必须和类名完全匹配：类名里的每一个.对应一个目录，MyAppNs.view.sample.SampleView就必须放在[classpath]/view/sample/SampleView.js，这里的classpath就是你配置的经典版源码目录。

2. 检查app.json的核心配置 #

这是最容易出问题的环节，重点关注两个配置项：

命名空间配置 #

确认app.json里的name字段就是你的应用命名空间MyAppNs：

{
    "name": "MyAppNs",
    // ... 其他配置
}

类路径（classpath）配置 #

经典版的源码目录必须被加入到classpath数组中，这样Sencha Cmd才能扫描到里面的类：

{
    "classpath": [
        "${app.dir}/app.js",
        "${app.dir}/app/classic/src", // 对应你的文件路径 app/classic/src
        "${app.dir}/app/shared/src" // 如果有共享代码也需要加上
    ],
    // ... 其他配置
}

如果缺少app/classic/src这一项，Cmd根本不会扫描这个目录下的类，自然不会在manifest里生成对应的路径映射。

3. 清理缓存并重新构建开发模式 #

有时候Sencha Cmd会缓存旧的manifest或bootstrap文件，导致修改配置后不生效，执行以下命令强制清理并重新构建：

sencha app clean
sencha app build development

这会让Cmd重新扫描所有类文件，生成全新的manifest和bootstrap.js，解决缓存导致的路径错误。

4. 显式声明类依赖（针对动态加载场景） #

如果你的视图类是通过Ext.create、Ext.widget或者路由配置在运行时才动态加载的，Sencha Cmd的依赖检测可能会漏掉它，导致manifest里没有对应的路径。这时候可以在app.js里显式声明依赖：

Ext.application({
    name: 'MyAppNs',
    requires: [
        'MyAppNs.view.sample.SampleView' // 把你的视图类加入到requires数组
    ],
    // ... 其他应用配置
});

这样Cmd在构建时就会明确把这个类加入到路径映射中。

5. 确认文件结构符合经典版规范 #

ExtJS 6.5经典版的标准结构中，经典版专属代码应该放在app/classic/src（如果你的appFolder是app）或者根目录下的classic/src，确保你的文件结构和app.json里的配置完全对应，不要出现目录层级错位的情况。

按照上面的步骤逐一排查，应该就能解决bootstrap.js加载错误路径的问题了。

内容的提问来源于stack exchange，提问作者herme 0