在Node.js中使用music21j报错self is not defined如何解决？

报错根因 #

这个错误既不代表music21j无法在浏览器外运行，也不是你的初始化配置有误，核心问题是：
music21j默认发布的包优先适配浏览器场景，代码内部使用了浏览器端的全局变量self（指向window对象）作为全局上下文访问入口，而Node.js环境默认没有这个全局变量，因此导入阶段就会触发引用错误。

修复方法 #

只需要在导入music21j之前，手动给Node全局对象挂载self属性即可，修改后的代码如下：

// 提前挂载全局self，指向Node环境的全局对象
global.self = globalThis;
const music21 = require('music21j');
const n = new music21.note.Note('F#');
// 测试输出验证正常
console.log(n.pitch.nameWithOctave); // 输出F#4

额外说明 #

• 如果你使用ES Module规范（import语法），只需要把global.self = globalThis这段逻辑放在import music21j的语句之前执行即可，如果是TS项目可以加// @ts-ignore忽略类型报错。
• 库中和浏览器渲染、Web Audio API相关的功能在Node环境下无法使用，但音符、乐谱、音高运算等核心功能都可以正常调用，符合官方支持JS/TS全场景使用的说明。

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