编译报错“Cannot read properties of undefined (reading 'split')”
===========================================================

*   场景一：
    
    **问题现象**
    
    当前使用的DevEco Studio版本与SDK版本不配套，导致DevEco Studio抛出异常：“TypeError: Cannot read properties of undefined (reading 'split')”。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/a9/v3/6JVtwGDkRxmSZ_7nwbrIkA/zh-cn_image_0000002624478688.png?HW-CC-KV=V1&HW-CC-Date=20260709T134401Z&HW-CC-Expire=86400&HW-CC-Sign=804A721B175B436EE994F3565B5511033DAA3E0958CDD5DCB2DD01E376789950)
    
    **解决措施**
    
    1.  访问华为[开发者官网](https://developer.huawei.com/consumer/cn/download/deveco-studio)下载最新版DevEco Studio。
    2.  使用新版本DevEco Studio打开待迁移项目。
    3.  根据DevEco Studio自动弹出的迁移提示进行操作。
        
        *   点击“Migrate Assistant”功能。
        
        ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/5e/v3/xy2mfU_BSTyfWUdgMZIoYg/zh-cn_image_0000002654798047.png?HW-CC-KV=V1&HW-CC-Date=20260709T134401Z&HW-CC-Expire=86400&HW-CC-Sign=59009DD170209C2F1AB1A320B54E579E0F8898EFB2979E66D5721CE046529EAD)
        
        *   从版本列表中选择目标迁移版本。
        
        ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/ae/v3/PTc-anUtR3iTBmLam1pTww/zh-cn_image_0000002624638598.png?HW-CC-KV=V1&HW-CC-Date=20260709T134401Z&HW-CC-Expire=86400&HW-CC-Sign=2A31426E4CA5DAD716B463C2972E785934F021F9A88317D63A214E795E405B9D)
        
        *   按照向导完成项目迁移流程。
        
*   场景二：
    
    **问题现象**
    
    当工程级 build-profile.json5 文件未配置工程外模块依赖，而模块级 oh-package.json5 声明了工程外模块依赖并在代码中实际引用时，编译阶段会抛出异常：”Error: Cannot read properties of undefined (reading 'split')”。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/3c/v3/lXJhRLEGTkaGkkBe8_rDzw/zh-cn_image_0000002654838005.png?HW-CC-KV=V1&HW-CC-Date=20260709T134401Z&HW-CC-Expire=86400&HW-CC-Sign=4944E8AFB6BC79729D9BEAF2AEBA5BFA13FE175D1142B357E5379F1FAF301DB5)
    
    **解决措施**
    
    1.  检查下报错子模块中所引用的依赖，确保目标模块已在工程级 build-profile.json5 文件的 modules 字段中正确声明。
        
        ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/42/v3/qhRI-C4QSSC4oeVQjn0zpA/zh-cn_image_0000002624478692.png?HW-CC-KV=V1&HW-CC-Date=20260709T134401Z&HW-CC-Expire=86400&HW-CC-Sign=FD229698AA2B2A4610CD7B25D7BEA22D54C98CC8A454EFCF4231DF0D57A0D6FA)
        
    2.  确认当前子模块的 oh-package.json5 中，该模块已添加到 dependencies 依赖列表。
        
        ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/b6/v3/RbWrBuwJT0SR1v-R31tzuQ/zh-cn_image_0000002654798051.png?HW-CC-KV=V1&HW-CC-Date=20260709T134401Z&HW-CC-Expire=86400&HW-CC-Sign=CDF80C4CAA80E6BBB5BFE83F9649AE665D256BC71AB4C5854F7B0FEDF3D1A661)
        
    3.  若发现配置缺失，请手动补充完整。删除项目中的 oh\_modules 缓存目录，然后重新执行编译。
        
*   场景三：
    
    **问题现象**
    
    在HAP依赖字节码HAR进行编译的场景下，当import语句中的模块别名与dependencies中声明的别名大小写不一致时，编译系统将无法正确识别该依赖为字节码HAR，进而导致编译错误。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/39/v3/00EX0go3RTyCrI8hIE9fBQ/zh-cn_image_0000002624638602.png?HW-CC-KV=V1&HW-CC-Date=20260709T134401Z&HW-CC-Expire=86400&HW-CC-Sign=C11567614DADDC8B60837AFFE38A0E818D4A2F96E4FF15660F296EC77A39DDE0)
    
    **解决措施**
    
    请检查并确保所有import语句的模块别名与其在dependencies中的声明保持完全一致的大小写格式。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/db/v3/AnRCM8B6QyOH9Esvs2oBEA/zh-cn_image_0000002654838009.png?HW-CC-KV=V1&HW-CC-Date=20260709T134401Z&HW-CC-Expire=86400&HW-CC-Sign=6CA635BD4A648A476D0B4BCE4B47EA5C6A44AC2D174A3444F648C8721AAA36DC)
    
*   场景四：
    
    **问题现象**
    
    在编译字节码HAR时，若将依赖配置于devDependencies下，hvigor构建系统在编译阶段不会收集devDependencies中的依赖项，导致依赖解析失败并引发编译错误。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/1f/v3/ctlSBNgxTPOO37gXDW2EnA/zh-cn_image_0000002624478696.png?HW-CC-KV=V1&HW-CC-Date=20260709T134401Z&HW-CC-Expire=86400&HW-CC-Sign=74EB0196D8474DC4537ABA4F6AAD58B856286B521F82C2591DF8D36867FBE1C4)
    
    **解决措施**
    
    请将依赖项从devDependencies移至dependencies。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/0f/v3/Dzp3VvDHQyKnEIR5HGvcmA/zh-cn_image_0000002654798055.png?HW-CC-KV=V1&HW-CC-Date=20260709T134401Z&HW-CC-Expire=86400&HW-CC-Sign=B366FDBA15CB45E721BBB95B2911302CBDFEA373AD39C994F82DC566378379CF)