Hướng dẫn cách khắc phục sự cố và sửa chữa cài đặt Node.js và npm trên Windows và macOS

Nếu bạn từng cố gắng khởi chạy một dự án và phát hiện ra rằng thiết bị đầu cuối không nhận ra các lệnh hoặc các gói toàn cục bị lỗi, đừng hoảng sợ. Điều này phổ biến hơn bạn nghĩ. Cài đặt Node.js và npm Chúng có thể bị hỏng hoặc gây ra sự cố, đặc biệt là khi chúng ta chuyển đổi giữa các phiên bản khác nhau hoặc khi quyền truy cập hệ điều hành trở nên phức tạp.

Để lập lại trật tự cho sự hỗn loạn này, điều đầu tiên cần hiểu là Node.js là môi trường cho phép bạn chạy JavaScript bên ngoài trình duyệt, trong khi npm chịu trách nhiệm quản lý tất cả các thư viện. Khi hai thứ này không tương thích, cách tiếp cận tốt nhất không phải là cố gắng "vá lỗi" bản cài đặt hiện tại, mà là... thực hiện vệ sinh sâu và cài đặt lại bằng các công cụ giúp ngăn ngừa sự cố tái diễn trong tương lai.

Nên chọn phiên bản nào: LTS hay phiên bản hiện tại?

Trước khi bắt đầu sửa chữa, bạn phải quyết định chọn phương pháp nào. Phiên bản LTS (Hỗ trợ dài hạn) Đây là sự lựa chọn an toàn; đây là lựa chọn bạn nên sử dụng nếu bạn đang tìm kiếm sự ổn định tuyệt đối trong sản xuất hoặc nếu bạn mới bắt đầu, vì nó đã được kiểm nghiệm rộng rãi và hiếm khi gây ra sự cố bất ngờ.

Mặt khác, chúng tôi có phiên bản CurrentĐây là "phiên bản tiên tiến nhất", nơi tích hợp các tính năng mới nhất. Nó rất phù hợp để thử nghiệm hoặc nếu bạn cần một tính năng tiên tiến từ một framework, nhưng hãy nhớ rằng thời gian hỗ trợ ngắn hơn và đây cũng là nơi dễ xuất hiện nhiều lỗi nhất. lỗi hoặc sự không tương thích với các gói phần mềm cũ hơn.

Sửa chữa và cài đặt trong Windows 11

Khi Node.js gặp lỗi trên Windows, thường là do vấn đề về đường dẫn. Nếu bạn đã sử dụng trình cài đặt .msi chính thức, hãy đảm bảo rằng tùy chọn [thêm tùy chọn vào đây] đã được chọn trong quá trình cài đặt. Thêm nút vào PATHNếu vẫn không được, bạn cần vào Thuộc tính Hệ thống và thêm các đường dẫn theo cách thủ công. y %AppData%\npm trong các biến môi trường người dùng.

Nếu bạn thích phong cách hiện đại và gọn gàng hơn, tôi khuyên bạn nên sử dụng cánhTính năng này đã được tích hợp sẵn trong Windows 10 và 11. Chỉ cần một lệnh đơn giản như sau: Bạn có thể chuẩn bị mọi thứ mà không gặp rắc rối. Ngoài ra còn có Chocolatey, một lựa chọn thay thế rất tốt cho những người yêu thích... tự động hóa gói thông qua dòng lệnh.

Đối với những ai muốn tránh các vấn đề về quyền truy cập và thay đổi phiên bản mà không gây ra lỗi, giải pháp được gọi là... nvm-windowsĐây là một dự án khác với dự án Linux/Mac, cho phép bạn cài đặt nhiều phiên bản Node và chuyển đổi giữa chúng. Ngăn chặn các công cụ toàn cầu trở nên không ổn định.

Giải pháp cho môi trường macOS và Unix

Trên máy Mac, cách phổ biến nhất là sử dụng gói .pkg chính thức, nhưng nếu bạn muốn nâng cao quy trình làm việc của mình lên một tầm cao mới, Homebrew là công cụ Bản cuối cùng. Cho phép cài đặt Node với và dễ dàng cập nhật nó bằng một Tuy nhiên, đôi khi có thể xảy ra xung đột liên kết và xung đột này sẽ được giải quyết bằng lệnh. .

Tuy nhiên, "chén thánh" thực sự trong macOS là nvm (Trình quản lý phiên bản nút)Bằng cách cài đặt Node thông qua nvm, các tệp sẽ được lưu trong thư mục người dùng của bạn chứ không phải trong các thư mục hệ thống bị hạn chế. Điều này giải quyết hoàn toàn vấn đề nan giải đó. Lỗi quyền truy cập EACCES, loại bỏ sự cần thiết phải sử dụng lệnh để cài đặt các gói toàn cầu.

Nếu bạn đang sử dụng Linux (Ubuntu, Debian hoặc Fedora), tốt nhất nên sử dụng các tập lệnh của Nút nguồn Để có được các phiên bản LTS cập nhật. Hãy nhớ rằng nếu bạn sử dụng WSL (Windows Subsystem for Linux), tốt nhất là nên cài đặt Node trực tiếp trong bản phân phối Linux chứ không nên trộn lẫn tệp nhị phân Windows với tệp nhị phân WSL, vì điều này có thể gây ra sự cố. xung đột tuyến đường khá khó chịu.

Khắc phục các lỗi thường gặp và bảo trì

Có khi viết Thiết bị đầu cuối sẽ thông báo rằng lệnh không được nhận dạng; đừng hoảng sợ. Điều đó thường có nghĩa là... thư mục bin toàn cục của npm Nó không có trong biến môi trường PATH của bạn. Trên macOS và Linux, hãy kiểm tra tệp của bạn. o Cấu hình NVM được tải chính xác khi đăng nhập, do đó ngăn chặn... localhost từ chối kết nối hoặc các lỗi máy chủ cục bộ tương tự.

Để duy trì một môi trường lành mạnh, chỉ lắp đặt rồi bỏ mặc là chưa đủ. Việc thực hiện mới là điều thiết yếu. thỉnh thoảng để phát hiện lỗ hổng bảo mật trong bộ phận của bạn. Nếu bạn thấy điều gì đó đã lỗi thời, Nó sẽ cho bạn biết những gói nào cần cập nhật khẩn cấp.

Một thủ thuật dành cho các nhà phát triển là sử dụng npxThay vì làm đầy hệ thống của bạn bằng các cài đặt toàn cục có thể xung đột với nhau, npx cho phép bạn chạy các CLI tạm thời. Ngoài ra, nếu bạn cần quản lý pnpm hoặc Yarn, hãy bật tính năng này. gói cốt lõi với lệnh Để có toàn quyền kiểm soát các trình quản lý gói.

Để làm sạch hệ thống trước khi cài đặt lại, trong Windows, bạn không chỉ phải xóa ứng dụng khỏi phần cài đặt mà còn phải xóa thủ công các thư mục còn sót lại. Trên máy Mac, nếu bạn sử dụng Homebrew, thì... Thông thường chỉ cần như vậy là đủ, mặc dù việc vệ sinh npm cache với Việc ngăn ngừa những sai lầm cũ tái diễn luôn là điều tốt.

Để duy trì một môi trường phát triển lành mạnh, điều quan trọng là luôn ưu tiên các phiên bản LTS, ủy thác việc kiểm soát phiên bản cho các công cụ như NVM hoặc FNM, và tránh sử dụng quyền quản trị để cài đặt thư viện bằng mọi giá. Bằng cách cấu hình đúng các biến môi trường và dọn dẹp các tập tin tạm thời, chúng ta có thể đảm bảo Node.js và npm hoạt động trơn tru trên mọi hệ điều hành.

Bài viết liên quan:

Sửa lỗi Localhost từ chối kết nối trong Windows

Isaac

Người viết đam mê về thế giới byte và công nghệ nói chung. Tôi thích chia sẻ kiến ​​thức của mình thông qua viết lách và đó là những gì tôi sẽ làm trong blog này, cho bạn thấy tất cả những điều thú vị nhất về tiện ích, phần mềm, phần cứng, xu hướng công nghệ, v.v. Mục tiêu của tôi là giúp bạn điều hướng thế giới kỹ thuật số một cách đơn giản và thú vị.