Create-React-App에서 Vite로 마이그레이션: 레거시 애플리케이션의 성능 향상

저희 직장에서 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와 함께

단점:

• 개발 및 생산을 위한 다양한 번들러:Vite는 개발에 esbuild를 사용하고 생산에 Rollup을 사용하는데, 이는 상당한 문제점이었습니다. 일부 페이지는 개발 단계에서는 완벽하게 작동했지만 프로덕션 단계에서는 충돌이 발생했습니다. 이러한 불일치로 인해 수동 테스트와 문제 해결이 필요했지만 전체적으로는 문제가 많지 않았습니다.

전환 계획: CRA에서 Vite로 마이그레이션하는 방법

조사해 보세요:

가장 중요한 단계입니다. 광범위한 연구가 필수적입니다. 나는 CRA에서 Vite로 전환한 다른 개발자의 경험에 대해 읽기 위해 Reddit을 검색했습니다. 대부분의 사람들은 그 과정이 까다롭지만 노력할 가치가 있다는 데 동의했습니다. 또한 현재 이 주제에 대한 공식 튜토리얼이나 문서가 없기 때문에 CRA 앱을 Vite로 이동하는 데 필요한 단계에 대한 여러 블로그 게시물을 읽었습니다.

실행 계획 수립:

• .js 파일을 .jsx로 변환:Vite는 Webpack처럼 .js 파일을 지원하지 않기 때문에 이것은 놀라운 도전이었습니다. 모든 .js 파일을 .jsx로 수동으로 변환하는 것은 불가능했지만 운 좋게도 프로세스를 자동화하는 CLI 도구를 찾았습니다.
• Removereact-script, installvite, createvite.config.js:Node.js 버전과 호환되는 Vite 버전을 사용하고 있는지 확인하세요. 그런 다음 반응 스크립트를 제거하고 vite를 설치한 후 vite.config.js 파일을 생성합니다.

으아아아

그리고 프로젝트 루트

으아아아

• Moveindex.html을 프로젝트 루트로 이동하고 글꼴을 공용 디렉터리로 이동한 다음 그에 따라 글꼴에 대한 참조 경로를 업데이트하세요.
• Remove%PUBLIC_URL% 링크에서index.html.

으아아아

• 프로젝트 진입점을 가리키는 스크립트를 추가하세요index.html

으아아아

• 환경 변수 교체:.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를 업데이트하여 플러그인을 포함하세요.

으아아아 으아아아

• GitHub 워크플로 재검증:vite를 사용하려면 반응 스크립트를 참조하는 워크플로 단계를 업데이트하세요.

환경 관련 문제 수정:

1. 모두 변경모듈을 가져오려면 이미지가 필요합니다.

• 문제:CRA에서는 일반적으로 require 문을 사용하여 이미지를 로드했는데, 이는 Vite에서는 작동하지 않습니다.
• 해결책:require를 ES 모듈 가져오기로 바꾸세요. 예를 들어:

으아아아 으아아아

2. Resolveglobal이 정의되지 않았습니다.

• 문제:Vite는 globalThis를 자동으로 제공하지 않습니다. 이는 코드가 이에 의존하는 경우 문제를 일으킬 수 있으며 Webpack이 이를 폴리필하고 있었습니다.

Webpack 애플리케이션의 전역 변수 “globalThis”

• 해결책:index.jsx 파일에 globalThis에 대한 수동 정의를 추가하세요.

으아아아

3. 오류 모니터링을 위한 소스 맵을 생성합니다.

• 문제:기본적으로 Vite는 오류 모니터링 도구를 사용할 때 디버깅에 필수적인 소스 맵을 생성하지 않을 수 있습니다.
• 해결책:vite.config.js에서 소스 맵을 활성화하세요.

으아아아

4. 전역 SASS 변수를 수정하세요.

• 문제:Vite는 CRA처럼 :export로 정의된 전역 SASS 변수를 처리하지 못할 수 있습니다.
• 해결책:전역 SASS 변수를 JavaScript 파일로 이동합니다. 예를 들어:

으아아아

다음으로 대체됩니다

으아아아

5. .jsx 파일에 대한 절대 가져오기를 처리합니다.

• 문제:절대 가져오기가 Vite에서 제대로 작동하지 않을 수 있습니다.
• 해결책:vite.config.js에서 별칭을 구성하세요.

으아아아

6. **.scss 파일에 대한 절대 가져오기를 처리합니다.**

• 문제:Vite는 프로덕션 환경에서 SCSS 파일에 대한 절대 가져오기를 올바르게 해결하지 못할 수 있습니다. 예를 들어 아래 코드는 app.[ 대신 app.[hash].js(내 빌드의 일부가 아님)라는 파일을 가져오고 있었습니다. hash].css 제작 중

으아아아

• 해결책:파일의 상대 경로로 돌아가려고 했지만 작동하지 않았습니다.♂️, 이러한 클래스가 애플리케이션을 통해 공유되었기 때문에 SCSS 파일을 전역으로 가져오기로 선택했습니다.

으아아아

그럼 바닐라 CSS처럼 사용하겠습니다

으아아아

7. 타사 라이브러리 문제를 해결하세요.

• Problem:Einige Bibliotheken sind möglicherweise nicht vollständig mit Vite kompatibel.
• Lösung:Aktualisieren oder ersetzen Sie inkompatible Bibliotheken. In meinem Fall musste ich:  — Ersetzen Sie jsonwebtoken durch jsonwebtoken-esm  — Ersetzen Sie React-Notifications durch React-Toastify  — Verwenden Sie lodash-es anstelle von lodash  — Aktualisieren Sie Bibliotheken wie React-Bootstrap-Sweetalert und Recharts auf ihre neuesten Versionen

Abschluss

Der Übergang von der Create-React-App zu Vite war eine herausfordernde, aber lohnende Erfahrung. Allein die Leistungsverbesserungen haben dafür gesorgt, dass sich der Aufwand gelohnt hat, und ich glaube, dass dies sowohl die Entwicklerproduktivität als auch die allgemeine Wartbarkeit des Projekts erheblich steigern wird. Indem Sie diese Probleme sorgfältig angehen, können Sie die modernen Tools von Vite optimal nutzen und die Effizienz Ihres Entwicklungsworkflows verbessern.

위 내용은 Create-React-App에서 Vite로 마이그레이션: 레거시 애플리케이션의 성능 향상의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!