一个人用 uni-app 做鸿蒙日语学习 App 的踩坑之旅

缘起：为什么要做这个应用

说起来有点巧合。我学日语断断续续好几年了，试过很多背单词的 App，总觉得差点意思——要么功能太简单，要么塞满了广告，要么离线就废了。去年听说鸿蒙系统要独立成生态，我就想，要不自己搞一个？正好练练手，也给自己学日语用。

就这样，"日语词账"这个项目在我的业余时间里慢慢成型了。从去年 10 月开始写第一行代码，到今年 3 月在华为应用市场上架，前后花了大概半年时间。期间踩了不少坑，也学到了很多东西。今天就来聊聊这个过程。

技术选型：为什么选 uni-app

一开始我是纠结的。做鸿蒙应用，到底该用什么技术？

原生开发我是不敢想的，一个人的精力有限，iOS、Android、鸿蒙三套代码，想想就头大。Flutter 我看了看，鸿蒙支持还不够成熟，社区资源也少。React Native 我倒是熟悉，但对鸿蒙的适配好像也不太行。

最后选了 uni-app，主要是看中了它的跨平台能力。DCloud 团队对鸿蒙的支持确实做得不错，而且我本身就用 Vue，上手很快。更重要的是，写一套代码就能同时跑在多个平台上，这对个人开发者来说太友好了。

功能规划：想清楚再动手

一开始我就给自己定了个原则：功能不求多，但要实用。作为一个学日语的人，我太清楚学习 App 需要什么了。

首先是词汇库。我从网上找了各种资源，最后整理出了 12000 多条词汇，从 N5 到 N1 都有。这个过程挺耗时的，光是数据清洗和格式统一就花了两周。但这是基础，必须做好。

然后是语法。日语语法说复杂也复杂，说简单也简单。我收集了 500 多条常用语法点，每条都配上例句和解释。这个主要是方便自己查询用，毕竟学着学着总会忘。

发音练习这块，我本来想直接用 TTS（文字转语音）技术的，后来发现效果不太好。尤其是五十音，机器合成的声音总感觉怪怪的。最后我找了 103 个高质量的 MP3 音频文件，每个假名都是真人录的，虽然增加了包体积，但效果确实好很多。

测验系统是后来加的。我自己学的时候发现，光看不练很容易忘，必须得有个测验功能来巩固。做了个简单的选择题系统，可以选不同的题量，随机出题，答完立马知道对错。这个功能现在我自己用得最多。

鸿蒙适配：第一次真正的挑战

说实话，在做这个项目之前，我从来没碰过鸿蒙开发。网上的资料也不算特别多，心里还是有点虚的。不过好在 uni-app 把很多底层的东西都封装好了，上手倒也不算太难。

语音这个大坑

最头疼的是语音功能。日语学习 App 没有发音功能，那基本就是个废品。但问题是，不同平台的语音 API 差别太大了，鸿蒙又是个新系统，很多东西都不确定。

我最开始想用 Web Speech API，结果在鸿蒙上根本不work。然后又试了华为的 HMS AI TTS，需要配置一堆东西，还得联网下载语音包，体验不太好。最后我找到了鸿蒙的系统原生 TTS 接口，这个算是比较靠谱的，但也不是百分百可用。

后来我就想了个办法：五十音这些基础发音，我全部用预置的 MP3 文件；复杂的单词句子，再用 TTS 合成。这样既保证了基础发音的质量，又不会让包体积太大。而且万一 TTS 不可用，至少基础功能还在。

这个方案看起来简单，实际做起来挺麻烦的。要判断当前是什么平台，要检测 TTS 是否可用，要处理各种异常情况。不过最后效果还不错，至少我自己用的时候没出过什么问题。

证书签名的折磨

鸿蒙应用必须签名才能装，这个证书配置真的是折磨人。我第一次打包的时候，证书路径配错了，一直提示签名失败。改了半天才发现是相对路径和绝对路径的问题。

还有一次更离谱，我在华为开发者平台上创建了应用，拿到了证书，结果打包的时候又说 bundleName 不匹配。原来是我在不同地方填的包名不一致，有的是点号分隔，有的是下划线。统一改成 com.******.JapaneseWords 之后才搞定。

建议大家一定要保留好证书文件，而且要注意有效期。我有一次差点因为证书过期了无法更新版本，幸好提前发现了。

性能优化的必要性

12000 多条词汇，一次性全加载进来，手机直接卡死。这个问题我也是吃了亏才学乖的。

后来改成分页加载，每次只显示 30 条，往下滑的时候再加载更多。这样首屏速度快多了，从原来的 3 秒多降到了不到 1 秒。虽然实现起来多了点代码，但用户体验提升还是很明显的。

还有就是数据缓存。词汇数据是不会变的，没必要每次都重新加载。我加了个简单的缓存机制，第一次加载完就存在本地，下次直接读缓存。这个优化也很有效。

上架的酸甜苦辣

等代码写得差不多了，就该上架了。这个过程说快也快，说慢也慢，主要看运气。

首先要在华为开发者平台注册账号，创建应用。这一步倒是不难，就是填表格，上传图标、截图什么的。图标我自己用 Figma 画的，简简单单一个日语五十音的"あ"字，配上渐变色，看起来还挺专业。

截图是个细节活。我特意选了几个最能展示功能的页面，词汇学习、发音练习、测验系统，每个都截得清清楚楚。还专门买了个模拟器，确保截图尺寸标准，没有状态栏杂乱的信息。

然后就是隐私政策。这个是必须的，哪怕你的 App 压根不收集用户数据。我就用 GitHub Pages 搭了个简单的隐私政策页面，说明应用不收集任何个人信息，所有数据都存在本地。链接填上去就行。

提交审核的时候，心里还是有点紧张的。第一次提交，过了两天被打回来了，说是权限说明不够详细。我赶紧补充了权限使用说明，说明白为什么需要网络权限（在线 TTS）、为什么需要麦克风权限（未来可能加语音识别）。第二次提交，又等了三天，终于通过了！

看到应用状态变成"已上架"的那一刻，说实话挺激动的。虽然只是个小小的学习工具，但毕竟是自己从零到一做出来的。

上架后的意外收获

应用上架一周后，下载量就破百了。虽然不多，但对个人开发者来说已经很满足了。更让我惊喜的是，有用户给我留言，说这个 App 很实用，离线能用特别好，界面也挺干净。

还有人问能不能加词组功能，能不能加听力练习。这些反馈让我意识到，原来真的有人在用我做的东西，而且还有改进的空间。这种感觉挺奇妙的。

当然也有bug反馈。有个用户说测验系统偶尔会重复出题，我查了半天才发现是随机算法的问题。还有人说暗色主题的某些文字看不清，我赶紧改了颜色对比度。

这些反馈虽然有时候挺头疼的，但也让应用越来越好。到现在我还在坚持更新，每个月至少修一两个bug，加一点小功能。

一些经验和感悟

做完这个项目，回头看看，确实学到了不少东西。

关于技术选型，我觉得 uni-app 对个人开发者真的很友好。虽然有人说它性能不如原生，但对于工具类、内容类应用来说完全够用。而且一套代码多端运行，这个优势太明显了。我现在这个 App，不仅跑在鸿蒙上，iOS 和 Android 也没问题，微信小程序版本我也在计划中。

关于鸿蒙开发，其实没有想象中那么难。很多人觉得鸿蒙是新系统，资料少，不敢尝试。但实际上，华为的文档还是挺全的，DCloud 社区也很活跃，遇到问题基本都能找到答案。而且鸿蒙生态还在快速发展，现在入局正是好时机。

关于产品设计，我学到最大的一点就是：功能要简单，体验要好。我一开始想加很多功能，听力、阅读、作文，什么都想做。后来发现根本做不过来，而且用户也不一定需要。不如把核心功能做扎实，让用户真正能用起来。

关于性能优化，这个真的不能忽视。我一开始觉得，12000 条数据也不算多吧，结果直接卡死。后来才知道，前端优化是门学问，分页加载、虚拟列表、懒加载，这些都是必须的。现在应用打开速度快了，用户体验也好了很多。

还有一点，就是要舍得删代码。我写了很多功能，后来发现有些根本没人用，反而让应用变复杂了。后来狠心删了一些，应用反而更简洁了。

给想做鸿蒙应用的朋友一些建议

如果你也想做鸿蒙应用，我的建议是：别想太多，直接开始！

技术方面，如果你会 Vue，uni-app 上手很快。不会也没关系，uni-app 官网教程挺详细的，跟着做一遍基本就能上手了。

工具方面，HBuilderX 是必备的，虽然有点笨重，但鸿蒙开发离不开它。真机调试最好准备一台鸿蒙手机，模拟器有时候不太靠谱。

资源方面，多逛逛 DCloud 社区论坛，很多问题都有前人踩过坑。GitHub 上也有不少开源项目可以参考。遇到问题别憋着，该提 issue 提 issue，该发帖发帖。

心态方面，做个人项目不要给自己太大压力。能做成最好，做不成也当学习了。我这个项目断断续续做了半年，中间也有好几次想放弃，最后还是坚持下来了。

未来的计划

这个应用目前还在持续更新中。短期内，我打算加上语音识别功能，让发音练习可以自动评分。再优化一下 UI，现在看起来还是有点朴素。

长期来看，我想做个听力练习模块，再加一个阅读理解功能。如果用户量上来了，可能还会考虑做个 Web 版，让大家在电脑上也能用。

至于商业化，暂时还没想那么多。我更希望这是一个真正对学习者有帮助的工具，而不是一个赚钱的产品。如果哪天用户量真的起来了，再考虑做个会员功能，加一些高级特性也不迟。

写在最后

从去年 10 月到现在，"日语词账"这个项目陪我度过了好多个周末和深夜。有时候改一个bug改到凌晨两点，有时候为了一个功能想破头。但看到应用慢慢成型，看到有人在用，这种成就感真的无法形容。

做独立开发者不容易，但也很有乐趣。如果你也有什么想法，不妨试试看。鸿蒙生态还在发展，机会很多。uni-app 让跨平台开发变得简单，个人开发者也能做出不错的产品。

最重要的是，开始行动。不要等到一切都准备好了才开始，边做边学，边学边改，慢慢就会越来越好。

我的这个应用已经在 GitHub 开源了，代码、数据都在上面。如果你感兴趣，可以去看看。如果有什么问题，也欢迎交流。

一起加油吧！

写于2025年11月，深圳，一个普通的周末下午