运行GitHub前端代码提示Document is not defined的环境问题排查

环境设置出错原因排查 #

• 错误运行方式：你大概率是直接右键JS文件选择了"Run"，IntelliJ会默认用Node.js环境执行JS，而Node环境里没有document对象，所以触发报错。正确做法是右键HTML文件，选择"Open in Browser"（比如Chrome、Firefox），让浏览器加载完整的HTML页面，JS就能在浏览器环境中正常访问document了。
• 项目类型误识别：检查右下角的项目类型标识，如果显示"Node.js"，点击切换为"Static Web"，IDE会按前端项目处理，默认运行逻辑会指向浏览器而非Node环境。

是否需要额外插件？ #

不需要额外插件。IntelliJ原生支持静态Web项目的浏览器运行，只要确保运行入口是HTML文件而非单独的JS文件即可。

非浏览器环境下模拟document的库推荐 #

如果确实需要在非浏览器环境（比如Node.js测试场景）使用document相关API，推荐以下库：

• jsdom：在Node环境中完整模拟浏览器DOM环境，支持绝大多数浏览器DOM操作API，可直接创建document对象。
• Happy DOM：轻量型DOM模拟库，性能优于jsdom，适合测试场景，同样支持document、window等浏览器核心对象。

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