JSDoc运行失败并提示Unexpected token错误的解决咨询

算力阿峰

2026-4-28

回答

你遇到的SyntaxError: Unexpected token ...错误，本质是当前conda环境中的Node.js版本过低，不支持ES6的对象扩展运算符（...）。JSDoc依赖的mkdirp库使用了这个语法特性，但旧版Node.js无法解析该语法，导致执行失败。

检查当前Node.js版本
先确认环境里的Node.js版本：
```
node --version
```
如果版本低于v8.6.0（对象扩展运算符在该版本才正式被Node.js支持），就需要升级。
升级conda环境中的Node.js
通过conda安装一个较新的Node.js版本（推荐v14及以上，兼容性更好）：
```
conda install -c conda-forge nodejs>=14
```
安装完成后再次运行node --version，确认版本已成功升级。
重新安装JSDoc（可选但推荐）
为了确保JSDoc的所有依赖都适配新版Node.js，先卸载全局的JSDoc，再重新安装：
```
npm uninstall -g jsdoc
npm install -g jsdoc
```
验证修复效果
运行以下命令测试JSDoc是否正常工作：
```
jsdoc --version
jsdoc main.js
```
此时应该不会再出现语法错误，能够正常生成文档。