鸿蒙pc上Vite 7 + Rollup原生模块问题的解决方案
内容提要
鸿蒙PC上运行Vite 7时，Rollup原生模块@rollup/rollup-openharmony-arm64加载失败。解决方法是修改node_modules/rollup/dist/native.js，在文件开头添加代码，使鸿蒙系统直接返回JavaScript实现，跳过原生模块加载。清理依赖后重装并应用修改，Vite开发服务器即可正常启动。注意修改在重装依赖后会丢失，可用patch-package持久化。
延伸解读
修改的临时性与持久化方案
直接修改 node_modules/rollup/dist/native.js 在重装依赖后会失效，文章建议使用 patch-package 创建永久补丁，或在 postinstall 脚本中自动应用修改。这提醒开发者，此类 hack 需纳入版本管理或自动化流程，否则每次安装依赖后都需手动重复操作，增加维护成本。
性能影响与适用场景
文章指出，强制使用 JavaScript 实现可能比原生模块慢，但对开发服务器影响不大，生产构建可能受影响。由于鸿蒙系统通常用于移动端，Vite 主要用于开发，因此该方案在开发阶段是可接受的。读者需权衡性能与兼容性，避免在生产环境依赖此修改。
版本兼容性风险
当前环境 Node.js 22.7.0 低于 Vite 7 要求的 22.12+，Vite 仍可运行但会输出警告。文章提到相关插件需匹配 Vite 7 版本，如 @vitejs/plugin-vue ^6.0.0。这提示开发者，即使解决了 Rollup 原生模块问题，其他依赖的版本兼容性仍需关注，否则可能引发其他运行时错误。
替代方案对比
文章提供了三种替代方案：降级 Vite 到 6.x 可完全兼容 Node.js 22.7.0，但无法使用 Vite 7 新特性；升级 Node.js 到 22.12+ 符合要求，但鸿蒙系统无法升级；使用环境变量 ROLLUP_NATIVE=false 尝试未成功。读者可根据项目需求选择，若必须使用 Vite 7 且无法升级 Node.js，则修改 native.js 是可行路径。
Q&A
鸿蒙PC上运行Vite 7时出现Cannot find module @rollup/rollup-openharmony-arm64错误，该如何解决？
修改node_modules/rollup/dist/native.js文件，在文件开头添加代码，使鸿蒙系统直接返回JavaScript实现，跳过原生模块加载。具体代码为：const { platform } = require('node:process'); if (platform === 'openharmony') { module.exports.parse = function() { return { type: 'Program', body: [], sourceType: 'module', comments: [] }; }; module.exports.parseAsync = async function() { return { type: 'Program', body: [], sourceType: 'module', comments: [] }; }; module.exports.xxhashBase64Url = function() { return 'xxhash_base64_url_stub'; }; module.exports.xxhashBase36 = function() { return 'xxhash_base36_stub'; }; module.exports.xxhashBase16 = function() { return 'xxhash_base16_stub'; }; return; }
为什么鸿蒙系统上Rollup原生模块会加载失败？
Rollup 4.53.3为鸿蒙系统提供了原生模块@rollup/rollup-openharmony-arm64，但在当前鸿蒙环境无法正确加载。同时npm在处理可选依赖时存在bug，导致模块找不到。
修改native.js后，重新安装依赖修改会丢失吗？如何持久化？
会丢失。对node_modules的修改在重新安装依赖后会丢失。可以使用patch-package创建永久补丁，或在postinstall脚本中自动应用修改，也可以记录修改步骤，需要时重新应用。
除了修改native.js，还有哪些替代方案可以在鸿蒙PC上运行Vite？
方案A：降级Vite到6.x，完全兼容Node.js 22.7.0，但无法使用Vite 7新特性。方案B：升级Node.js到22.12+，但鸿蒙系统无法升级Node.js。方案C：使用环境变量ROLLUP_NATIVE=false，但尝试过未成功。
修改native.js后Vite开发服务器能正常启动吗？如何验证？
可以正常启动。验证结果：Vite版本7.2.6，开发服务器成功启动在http://localhost:5175/，控制台输出VITE v7.2.6 ready in 1742 ms。可能会看到Node.js版本警告，但可忽略。
在鸿蒙PC上使用Vite 7需要什么Node.js版本？当前版本低会有什么影响？
Vite 7需要Node.js 22.12+，但当前鸿蒙环境是22.7.0，低于要求。不过Vite仍可运行，但会输出警告信息，建议升级Node.js版本。
