如何运行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
相关产品推荐
相关产品推荐

