You need to enable JavaScript to run this app. 如何运行Webpack打包的Node.js TypeScript应用?运行报require未定义
优惠活动
大模型
产品
解决方案
定价
更多

如何运行Webpack打包的Node.js TypeScript应用?运行报require未定义

配置存在的核心问题
  • Webpack输出配置没做Node环境适配:目前只写了输出的存放路径,既没指定打出来的文件叫什么名字,也没把代码转成Node能识别的CommonJS格式。Webpack默认打出来的是给浏览器用的代码,里面没有Node运行必须的module、require全局对象,跑的时候必然报ReferenceError: require is not defined。
  • 跑错了文件才会出现先打全文件内容的现象:因为没固定输出文件名,Webpack默认会在指定目录下生成叫main.js的文件,如果运行时误指向了带代码块、纯字符串的配置文件、TS源文件,Node会先把文件里所有能输出的字符串全部打印出来,再因为代码格式不对抛异常。
  • 模块规则有潜在冲突:tsconfig里设了输出ES模块的规则,虽然Webpack会自己处理模块转译,但如果配置透传出问题,会直接打乱模块加载逻辑。
  • 配置文件本身可能加载失败:你的webpack.config是用ESM语法写的(用了export default),如果项目的package.json没加"type": "module"配置,Webpack本身连配置文件都读不出来。
修复后的正确配置与运行方法

1. 调整Webpack输出配置

重点补全output段的缺失项,保证产物能被Node直接识别运行,需要改的点:

  • 用path.resolve拼接路径,避免路径解析出错
  • 给输出文件指定明确的名字,方便后续执行
  • 设置输出模块类型为commonjs2,让整个打包文件用Node识别的CommonJS格式包裹
    修改后的output段参考代码:
output: {
    path: path.resolve('D:/asant/Desktop/myproject/bundle'),
    filename: 'app.js',
    library: {
        type: 'commonjs2'
    }
}

2. 修正tsconfig适配规则

把compilerOptions里的"module"值从es6改成commonjs,避免ts-loader处理代码时生成Node不兼容的模块语法。这么改之后,就算不用Webpack,直接用tsc编译出来的TS文件,也能直接在Node下运行。

注意:tsconfig里写的outDir路径,只有直接调用tsc编译的时候才会生效,用Webpack打包的时候根本不会读这个配置,产物的实际路径完全由Webpack的output配置决定。

3. 正确运行打包产物

等Webpack打包完成后,直接执行输出目录下的对应文件就行,执行命令:

node D:/asant/Desktop/myproject/bundle/app.js

不要去运行Webpack的配置文件、src目录下的TS源文件,不然很容易因为文件格式不匹配,出现先打一堆代码内容、再报引用错误的问题。

内容的提问来源于stack exchange,提问作者Antonio Santoro

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.22 10:27:01