Create-React-App에서 Vite로 마이그레이션: 레거시 애플리케이션의 성능 향상
- 王林원래의
- 2024-08-18 07:34:02650검색
저희 직장에서 CRA(create-react-app)에서 Vite로 성공적으로 전환하고 있다는 소식을 공유하게 되어 기쁩니다! ?
전환은 간단하지 않았지만 필요했습니다. 우리 앱은 점점 느려지고, 개발자 경험(DX)도 악화되고 있었습니다. 앱을 다시 시작하는 것이 너무 느려서 하루 종일 노트북을 켜두었습니다. node_modules를 제거하고 다시 설치하고 앱을 시작하려고 시도한 경우 모든 것이 다운로드되고 다시 시작될 때까지 기다리는 데 한 시간을 낭비할 수 있습니다. 앱을 시작하는 데 일반적으로 12~15분이 소요됩니다. 이는 특히 긴급 버그 보고서를 처리할 때 상당한 지연입니다. 또한 CRA는 더 이상 사용되지 않으며 React 애플리케이션 부트스트래핑에 더 이상 권장되지 않습니다.
Vite를 선택해야 하는 이유
처음에는 Rspack을 사용하는 것을 고려했습니다.
보다 강력한 기능과 탁월한 생산성을 갖춘 webpack의 드롭인 대체품입니다.
하지만 전환은 기대했던 것만큼 원활하지 않았습니다. Rspack이 생산 준비 상태에 가까워지고 있지만(이 글을 쓰는 시점에서 버전 1.0.0-beta.4) 저는 보다 성숙하고 전투 테스트를 거친 솔루션인 Vite를 선택하기로 결정했습니다.
Webpack과 CRA에서 벗어나 이러한 도구와 그 뒤에 숨은 노력에 대해 새롭게 감사하게 되었습니다. 개발 프로세스의 상당 부분을 단순화하고 바로 사용할 수 있는 설정을 제공합니다.
언젠가는 CRA 및 Webpack에 대한 진정한 드롭인 대체품이 출시되어 Vite와 같은 도구로 전환할 때 광범위한 파일 변경이 필요하지 않기를 바랍니다.
Webpack, Vite 또는 Rspack이 무엇인지 모르신다면 지난 게시물에서 이 토끼 굴로 들어가 Webpack과 그 기능을 살펴보았습니다. Vite와 Rspack은 비슷한 작업을 수행하지만 더 효율적인 최신 도구입니다.
Vite에 대한 나의 경험: 장점과 단점
기존 앱을 Vite로 전환한 방법에 대해 알아보기 전에 개발 및 생산 환경에서 Vite를 사용하면서 간략하게 경험한 장단점을 공유하고 싶습니다.
장점:
- 빠른 시작: 새로 설치한 후 서버 시작 시간이 대폭 단축되었습니다. Webpack을 사용하면 최대 30분이 걸렸습니다. Vite를 사용하면 이제 약 8.5분이 소요됩니다. 이후 스타트업 시간은 12~15분에서 단 1.5분으로 단축되었습니다. 여전히 느린 것처럼 보일 수 있지만 프로젝트의 복잡성을 고려하면 성공입니다.
참고: 제가 테스트하고 있는 노트북은 꽤 오래되었습니다. 더 나은 사양을 갖춘 최신 시스템에서는 두 번째 시작 시 시작 시간이 20~30초 정도로 낮았습니다.
- 더 빨라진 빌드 시간: GitHub 워크플로 빌드 시간이 12~13분에서 단 7분으로 단축되었습니다. — 시간의 거의 절반! 이러한 전환을 통해 우리 개발팀은 매일 개발자당 최소 20분을 절약할 수 있습니다.
웹팩으로
비테와 함께
단점:
- 개발 및 생산을 위한 다양한 번들러: Vite는 개발에 esbuild를 사용하고 생산에 Rollup을 사용하는데, 이는 상당한 문제점이었습니다. 일부 페이지는 개발 단계에서는 완벽하게 작동했지만 프로덕션 단계에서는 충돌이 발생했습니다. 이러한 불일치로 인해 수동 테스트와 문제 해결이 필요했지만 전체적으로는 문제가 많지 않았습니다.
전환 계획: CRA에서 Vite로 마이그레이션하는 방법
조사해 보세요:
가장 중요한 단계입니다. 광범위한 연구가 필수적입니다. 나는 CRA에서 Vite로 전환한 다른 개발자의 경험에 대해 읽기 위해 Reddit을 검색했습니다. 대부분의 사람들은 그 과정이 까다롭지만 노력할 가치가 있다는 데 동의했습니다. 또한 현재 이 주제에 대한 공식 튜토리얼이나 문서가 없기 때문에 CRA 앱을 Vite로 이동하는 데 필요한 단계에 대한 여러 블로그 게시물을 읽었습니다.
실행 계획 수립:
- .js 파일을 .jsx로 변환: Vite는 Webpack처럼 .js 파일을 지원하지 않기 때문에 이것은 놀라운 도전이었습니다. 모든 .js 파일을 .jsx로 수동으로 변환하는 것은 불가능했지만, 운 좋게도 이 프로세스를 자동화하는 CLI 도구를 찾았습니다.
- 제거 react-script, 설치 vite, 생성 vite.config.js: Node.js 버전과 호환되는 Vite 버전을 사용하고 있는지 확인하세요. 그런 다음 반응 스크립트를 제거하고 vite를 설치한 후 vite.config.js 파일을 생성합니다.
yarn remove react-scripts yarn add vite @vitejs/plugin-react --dev
그리고 프로젝트 루트
import react from '@vitejs/plugin-react';
import { defineConfig } from 'vite';
export default defineConfig({
plugins: [react()],
build: { // to output your build into build dir the same as Webpack
outDir: 'build',
},
server: {
open: true,
port: 3000,
},
});
- index.html을 프로젝트 루트로 이동하고 글꼴을 공용 디렉터리로 이동한 다음 그에 따라 글꼴에 대한 참조 경로를 업데이트합니다.
- index.html의 링크에서 %PUBLIC_URL%을 제거
<link rel="icon" href="%PUBLIC_URL%/favicon.ico" /> ❌ <link rel="icon" href="/favicon.ico" /> ✅
- index.html에서 프로젝트 진입점을 가리키는 스크립트를 추가하세요.
<body> <noscript>You need to enable JavaScript to run this app.</noscript> <div id="root"></div> <script type="module" src="/src/index.jsx"></script> </body>
- 환경 변수 교체: .env에서 REACT_APP를 VITE로 바꾸고, 코드에서 process.env.NODE_ENV를 import.meta.env.MODE로, process.env.REACT_APP를 import.meta.env.VITE로 업데이트하세요.
- 구성 eslint: vite-plugin-eslint를 설치하고 vite.config.js를 업데이트하여 플러그인을 포함하세요.
yarn add vite-plugin-eslint --dev
import react from '@vitejs/plugin-react';
import { defineConfig } from 'vite';
import eslintPlugin from 'vite-plugin-eslint';
export default defineConfig({
plugins: [react(), eslintPlugin()],
build: {
outDir: 'build',
},
server: {
open: true,
port: 3000,
},
});
- GitHub 워크플로 재검증: vite를 사용하려면 반응 스크립트를 참조하는 워크플로 단계를 업데이트하세요.
환경 관련 문제 수정:
- 모두 변경 모듈 가져오기에 이미지가 필요합니다.
- 문제: CRA에서는 일반적으로 require 문을 사용하여 이미지를 로드했는데, 이는 Vite에서는 작동하지 않습니다.
- 해결책: require를 ES 모듈 가져오기로 교체하세요. 예를 들어:
<img src={require('assets/images/logo.svg')}/> ❌
import Logo from 'assets/images/logo.svg';
<img src={Logo}/> ✅
2. 해결 globalThis가 정의되지 않았습니다.
- 문제: Vite는 globalThis를 자동으로 제공하지 않습니다. 이는 코드가 이에 의존하는 경우 문제를 일으킬 수 있으며 Webpack이 이를 폴리필했습니다.
Webpack 애플리케이션의 전역 변수 “globalThis”
- 해결책: index.jsx 파일에 globalThis에 대한 수동 정의를 추가하세요.
window.global ||= window; // just double checked my code and I'm a bit skeptical of why I'm not using // `window.globalThis`and why my code is working with `window.global` ?
3. 오류 모니터링을 위한 소스 맵을 생성합니다.
- 문제: 기본적으로 Vite는 오류 모니터링 도구를 사용할 때 디버깅에 필수적인 소스 맵을 생성하지 않을 수 있습니다.
- 해결책: vite.config.js에서 소스 맵을 활성화합니다.
import react from '@vitejs/plugin-react';
import { defineConfig } from 'vite';
import eslintPlugin from 'vite-plugin-eslint';
export default defineConfig({
plugins: [react(), eslintPlugin()],
build: {
outDir: 'build',
sourcemap: true,
},
server: {
open: true,
port: 3000,
},
});
4. 전역 SASS 변수를 수정합니다.
- 문제: Vite는 CRA처럼 :export로 정의된 전역 SASS 변수를 처리하지 못할 수 있습니다.
- 해결책: 전역 SASS 변수를 JavaScript 파일로 이동합니다. 예를 들어:
//theme.scss ❌
:export {
primaryColor: $app-primary;
secondaryColor: $secondary;
....
}
import theme from '../styles/theme.scss';
<div style={{ color: theme.primaryColor }}>Hello World</div>
다음으로 대체됩니다
// theme.js ✅
const theme = {
primaryColor: '#10142a',
secondaryColor: '#2695a2',
.....
}
export default theme;
import theme from '../styles/theme.js';
<div style={{ color: theme.primaryColor }}>Hello World</div>
5. .jsx 파일에 대한 절대 가져오기를 처리합니다.
- 문제: Vite에서는 절대 가져오기가 제대로 작동하지 않을 수 있습니다.
- 해결책: vite.config.js에서 별칭을 구성합니다.
import react from '@vitejs/plugin-react';
import { defineConfig } from 'vite';
import eslintPlugin from 'vite-plugin-eslint';
export default defineConfig({
plugins: [react(), eslintPlugin()],
build: {
outDir: 'build',
sourcemap: true,
},
resolve: {
alias: [
{ find: 'actions', replacement: '/src/actions' },
{ find: 'assets', replacement: '/src/assets' },
{ find: 'components', replacement: '/src/components' },
.....
{ find: 'styles', replacement: '/src/styles' },
],
},
server: {
open: true,
port: 3000,
},
});
6. **.scss 파일에 대한 절대 가져오기를 처리합니다.**
- 문제: Vite가 프로덕션 환경에서 SCSS 파일에 대한 절대 가져오기를 올바르게 해결하지 못할 수 있습니다. 예를 들어 아래 코드는 대신 app.[hash].js(내 빌드의 일부가 아님)라는 파일을 가져오고 있었습니다. app.[hash].css 제작 중
import MyComponent from 'components/MyComponent';
import styles from 'styles/app.scss';
<MyComponent className={styles.someClassName} />
- 해결책: 파일의 상대 경로로 돌아가려고 했지만 작동하지 않았습니다. ♂️, 이러한 클래스는 애플리케이션을 통해 공유되었기 때문에 SCSS 파일을 전역적으로 가져오기로 선택했습니다.
// index.jsx
import React from 'react';
import { render } from 'react-dom';
import Main from './pages/Main';
// Import SCSS globally
import './global.scss';
render(<Main/>, document.querySelector('#root'));
// global.scss
.class1{...}
.class2{...}
...
// cut & paste classes from styles/app.scss here
// then drop that cursed file
그럼 바닐라 CSS처럼 사용하겠습니다
<MyComponent className='someClassName' />
7. 타사 라이브러리 문제를 해결합니다.
- 문제: 일부 라이브러리는 Vite와 완전히 호환되지 않을 수 있습니다.
- 해결책: 호환되지 않는 라이브러리를 업데이트하거나 교체하세요. 내 경우에는 다음이 필요했습니다. — jsonwebtoken을 jsonwebtoken-esm으로 교체 — react-notification을 React-toastify로 대체하세요. — lodash 대신 lodash-es를 사용하세요. — react-bootstrap-sweetalert와 같은 라이브러리를 업데이트하고 최신 버전으로 다시 차트를 업데이트하세요
결론
create-react-app에서 Vite로 전환하는 것은 어렵지만 보람 있는 경험이었습니다. 성능 향상만으로도 노력할 가치가 있으며, 이것이 개발자 생산성과 전체 프로젝트 유지 관리성을 크게 향상시킬 것이라고 믿습니다. 이러한 문제를 주의 깊게 해결함으로써 Vite의 최신 도구를 최대한 활용하고 개발 워크플로우의 효율성을 향상시킬 수 있습니다.
위 내용은 Create-React-App에서 Vite로 마이그레이션: 레거시 애플리케이션의 성능 향상의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!