安装chevrotain后仍报ReferenceError: chevrotain not defined的原因

按触发概率从高到低排序：

• 未显式导入模块，直接引用未声明的标识符
  Node.js 环境或经打包工具处理的前端项目中，npm 安装的依赖不会自动注入全局作用域，必须先导入才能使用。
  CommonJS 规范（Node.js 默认）的导入写法：

  const chevrotain = require('chevrotain')
  

  ES Module 规范（package.json 配置"type": "module"或使用webpack/vite等打包工具）的导入写法：

  import * as chevrotain from 'chevrotain'
  // 也可直接按需导入目标方法
  // import { createToken } from 'chevrotain'
  

  缺少导入语句，或者导入时使用了其他别名（比如写为const cv = require('chevrotain')）却在后续代码中用chevrotain调用方法，JS引擎就会判定该标识符未定义，直接抛出对应ReferenceError，这是该问题最常见的触发原因。

• 依赖版本判断逻辑错误，实际安装状态异常
  你使用的版本查询命令npm -v chevrotain存在用法错误：npm -v的作用是查询npm CLI自身的版本，不会返回任何第三方依赖包的版本，你看到的返回值8.1.2是本地安装的npm的版本号，和chevrotain的实际安装版本没有关系。
  正确查询当前目录下chevrotain安装版本的命令是npm ls chevrotain，执行后大概率会发现以下安装异常：

  • 实际安装的chevrotain版本和package.json中声明的^10.1.2不匹配，存在版本冲突
  • node_modules目录损坏，chevrotain包文件缺失
  • 执行npm install chevrotain时所在路径错误，包被安装到了其他上级目录，当前运行目录的node_modules中没有对应包
    这类安装异常通常会抛出「找不到模块」类的错误，和你当前看到的未定义报错有区别，但属于当前环境明确存在的配置偏差，需要同步修正。

• 运行环境与模块规则不匹配
  如果你是直接在浏览器中打开该JS文件运行，必然会触发该错误：浏览器没有Node.js的模块解析能力，不会自动读取node_modules下的依赖，也不会将npm包注入全局作用域。要在浏览器环境使用，要么通过script标签引入chevrotain的浏览器构建版本将chevrotain挂载到window全局对象，要么通过打包工具处理依赖导入后再运行生成的产物。

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