You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

前端安装与使用Kuroshiro JS库遇阻,寻求技术指导

Kuroshiro JS库前端配置指南

核心问题说明

你控制台报“文件未找到”,是因为没从源码构建出dist/kuroshiro.min.js文件——官方文档里的npm run build就是用来生成这个dist目录下的压缩文件的。下面给你两种实操方案,选一种即可:


方案1:直接用CDN引入(新手首选,无需本地构建)

不用折腾npm安装和构建流程,直接在HTML中添加以下script标签,就能直接调用Kuroshiro:

<!-- 引入Kuroshiro核心库 -->
<script src="https://cdn.jsdelivr.net/npm/kuroshiro@1.2.0/dist/kuroshiro.min.js"></script>
<!-- 必须搭配分词器,这里用官方推荐的kuromoji分词器 -->
<script src="https://cdn.jsdelivr.net/npm/kuroshiro@1.2.0/dist/kuroshiro-analyzer-kuromoji.min.js"></script>

页面加载时会自动从CDN下载文件,不会出现路径错误问题。


方案2:通过npm构建本地文件(适合需要本地部署的场景)

如果必须使用本地文件,按以下步骤操作:

  1. 安装Node.js:先去官网下载安装Node.js,安装完成后打开命令行,输入node -v和npm -v能看到版本号,就说明安装成功。
  2. 初始化项目:打开你的前端项目文件夹对应的命令行窗口,输入npm init -y,会自动生成package.json配置文件。
  3. 安装Kuroshiro:命令行输入npm install kuroshiro,等待依赖安装完成。
  4. 构建生成dist文件:命令行输入npm run build——这就是官方说的“从源码构建”,执行完成后,项目根目录会多出一个dist文件夹,里面包含kuroshiro.min.js和对应的分词器文件。
  5. 引入本地文件:把dist文件夹里的kuroshiro.min.js和kuroshiro-analyzer-kuromoji.min.js复制到你的前端项目目录中,然后在HTML里引入:
<script src="./kuroshiro.min.js"></script>
<script src="./kuroshiro-analyzer-kuromoji.min.js"></script>

注意路径要和你存放文件的位置匹配,比如文件放在js文件夹里,路径就要写成./js/kuroshiro.min.js。


简单测试示例

不管用哪种方式引入,都可以用以下代码验证是否生效:

// 初始化Kuroshiro实例
const kuroshiro = new Kuroshiro();
// 加载分词器
kuroshiro.init(new KuroshiroAnalyzer.KuromojiAnalyzer())
  .then(() => {
    // 将日文转换为罗马音
    return kuroshiro.convert("こんにちは", { to: "romaji" });
  })
  .then(result => {
    console.log(result); // 控制台会输出"konnichiwa"
  });

内容的提问来源于stack exchange,提问作者Vinicius Chinen

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.24 17:57:23