Webpack Encore 使用教程

2024-08-26 04:16:05作者：齐冠琰

A simple but powerful API for processing & compiling assets built around Webpack

项目地址：https://gitcode.com/gh_mirrors/we/webpack-encore

项目介绍

Webpack Encore 是一个简单但强大的 API，用于处理和编译基于 Webpack 的资产。它是 Symfony 项目的一部分，但可以轻松用于任何语言的应用程序。Encore 提供了干净的 API，用于打包 JavaScript 模块、预处理 CSS 和 JS，以及编译和压缩资产。它旨在解决最常见的 Webpack 用例，并提供了一个专业的资产系统，使用起来非常愉快。

项目快速启动

安装

首先，确保你已经安装了 Node.js 和 Yarn。然后，通过以下命令安装 Webpack Encore：

yarn add @symfony/webpack-encore --dev

配置

在你的项目根目录下创建一个 webpack.config.js 文件，并添加以下内容：

const Encore = require('@symfony/webpack-encore');

Encore
    // 项目输出目录
    .setOutputPath('public/build/')
    // 公共路径，用于访问输出文件
    .setPublicPath('/build')
    // 入口文件
    .addEntry('app', './assets/js/app.js')
    // 启用 React 支持
    .enableReactPreset()
    // 启用 Sass 支持
    .enableSassLoader()
    // 启用 PostCSS 支持
    .enablePostCssLoader()
    // 启用 Source Maps
    .enableSourceMaps(!Encore.isProduction())
    // 压缩 CSS 和 JS
    .enableVersioning(Encore.isProduction())
;

module.exports = Encore.getWebpackConfig();

编译

运行以下命令来编译你的资产：

yarn encore dev

或者，如果你需要进行生产环境的编译：

yarn encore production

应用案例和最佳实践

案例一：Symfony 项目中的使用

在 Symfony 项目中，Webpack Encore 可以与 Twig 模板引擎无缝集成。你可以在 Twig 模板中使用 encore_entry_link_tags 和 encore_entry_script_tags 函数来加载 CSS 和 JS 文件。

<!DOCTYPE html>
<html>
<head>
    <title>My Symfony App</title>
    {{ encore_entry_link_tags('app') }}
</head>
<body>
    <h1>Welcome to My Symfony App</h1>
    {{ encore_entry_script_tags('app') }}
</body>
</html>

最佳实践

模块化管理：将你的 JS 和 CSS 文件模块化，便于管理和维护。
代码分割：使用 Webpack 的代码分割功能，提高页面加载速度。
持续集成：在 CI/CD 流程中集成 Webpack Encore，确保每次部署都能自动编译最新的资产。

典型生态项目

Symfony 项目

Webpack Encore 是 Symfony 官方推荐的资产处理工具，与 Symfony 框架完美集成，提供了丰富的功能和优秀的开发体验。

React 项目

通过启用 React 预设，Webpack Encore 可以轻松支持 React 项目，提供高效的开发和生产环境编译。

其他语言项目

虽然 Webpack Encore 是由 Symfony 开发的，但它并不局限于 Symfony 项目。你可以将其用于任何语言和框架的项目，只需简单的配置即可。

通过以上内容，你应该能够快速上手并使用 Webpack Encore 来处理和编译你的项目资产。希望这篇教程对你有所帮助！

A simple but powerful API for processing & compiling assets built around Webpack

项目地址：https://gitcode.com/gh_mirrors/we/webpack-encore

登录后查看全文

项目优选

收起

deepin linux kernel

OpenHarmony documentation | OpenHarmony开发者文档

Ascend Extension for PyTorch

本项目是CANN提供的数学类基础计算算子库，实现网络在NPU上加速计算。

flutter_flutter

openEuler内核是openEuler操作系统的核心，既是系统性能与稳定性的基石，也是连接处理器、设备与服务的桥梁。

昇腾LLM分布式训练框架

Nop Platform 2.0是基于可逆计算理论实现的采用面向语言编程范式的新一代低代码开发平台，包含基于全新原理从零开始研发的GraphQL引擎、ORM引擎、工作流引擎、报表引擎、规则引擎、批处理引引擎等完整设计。nop-entropy是它的后端部分，采用java语言实现，可选择集成Spring框架或者Quarkus框架。中小企业可以免费商用

🔥LeetCode solutions in any programming language | 多种编程语言实现 LeetCode、《剑指 Offer（第 2 版）》、《程序员面试金典（第 6 版）》题解

🎉 (RuoYi)官方仓库基于SpringBoot，Spring Security，JWT，Vue3 & Vite、Element Plus 的前后端分离权限管理系统