كيفية إصلاح أمر npm الذي لم يتم العثور عليه بعد تثبيت Node.js

الخطأnpm: لم يتم العثور على الأمر (أولم يتم التعرف على ‘npm’ كأمر داخلي أو خارجيعلى نظام التشغيل Windows) يعني أن shell الخاص بك لا يمكنه تحديد موقع npm على الرغم من أنك قد قمت بتثبيت Node.js. إنها دائمًا مشكلة PATH. وإليك كيفية إصلاحها على كل منصة.

لماذا يحدث هذا

يأتي npm مع Node.js. إذاnpm لم يتم العثور عليه، إما أن Node.js لم يتم تثبيته بشكل صحيح، أو أن الدليل يحتوي علىnpm ليس موجودًا في PATH الخاص بنظامك – قائمة المواقع التي يبحث فيها Shell عن الأوامر.

الخطوة 1: التحقق من تثبيت Node.js فعليًا

# Check if node exists
node --version
# v20.11.0  → Node is installed, npm PATH issue
# command not found → Node itself isn't installed/in PATH

# Check npm
npm --version
which npm    # macOS/Linux — shows npm location
where npm    # Windows

الإصلاح 1: إعادة تثبيت Node.js (الأبسط)

إذا لم يكن هناكnode ولاnpm تم العثور عليه، أعد تثبيت Node.js بشكل صحيح:

# Download the LTS installer from nodejs.org and run it
# The official installer adds Node and npm to PATH automatically

# Verify after install (open a NEW terminal window)
node --version
npm --version

هام: افتح دائمًانافذة طرفية جديدة بعد التثبيت – لا تنطبق تغييرات PATH على المحطات الطرفية المفتوحة بالفعل.

الإصلاح 2: استخدم nvm (موصى به للمطورين)

يتعامل Node Version Manager مع تثبيت Node وPATH بشكل صحيح، ويتيح لك تبديل الإصدارات بسهولة:

# macOS/Linux — install nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

# Restart your terminal, then:
nvm install --lts      # install latest LTS Node
nvm use --lts          # use it
node --version         # verify
npm --version          # npm comes with it

# Windows — use nvm-windows instead
# Download from github.com/coreybutler/nvm-windows

الإصلاح 3: إضافة عقدة إلى PATH يدويًا (نظام التشغيل MacOS/Linux)

# Find where node is installed
which node
# /usr/local/bin/node  or  /opt/homebrew/bin/node

# Add its directory to PATH in your shell config
# For zsh (~/.zshrc):
echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# For bash (~/.bashrc or ~/.bash_profile):
echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

الإصلاح 4: إصلاح PATH على نظام التشغيل Windows

# 1. Find Node's install location (usually):
#    C:\Program Files
odejs
# 2. Add to PATH:
#    - Search "Environment Variables" in Start menu
#    - Click "Environment Variables"
#    - Under "System variables", select "Path", click "Edit"
#    - Click "New", add: C:\Program Files
odejs#    - Click OK on all dialogs

# 3. Open a NEW Command Prompt/PowerShell and verify:
node --version
npm --version

الإصلاح 5: عقدة Homebrew على نظام التشغيل macOS

# If you installed via Homebrew but it's not found
brew install node

# On Apple Silicon Macs, Homebrew is in /opt/homebrew
# Ensure it's in PATH:
echo 'export PATH="/opt/homebrew/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# Relink if needed
brew link --overwrite node

السبب الشائع: الأذونات أو مشكلات الدليل العالمي

# If npm works but global installs fail with permission errors,
# configure a user-level global directory (avoids sudo):
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc

الأسئلة المتداولة

س: لقد قمت بتثبيت Node ولكن لم يتم العثور على npm بعد. لماذا؟
ج: في أغلب الأحيان، تحتاج إلى فتح نافذة طرفية جديدة – لا تؤثر تغييرات PATH على المحطات الطرفية المفتوحة بالفعل. إذا لم ينجح ذلك، فهذا يعني أن دليل Node ليس موجودًا في PATH الخاص بك، أو أن التثبيت غير مكتمل. أعد تثبيت أو استخدم nvm.

س: هل يجب أن أستخدم nvm أم المثبت المباشر؟
ج: يوصى باستخدام nvm للمطورين — فهو يدير PATH بشكل صحيح، ويتجنب مشكلات الأذونات، ويتيح لك تبديل إصدارات Node لكل مشروع. يعد المثبت المباشر مناسبًا لإعدادات الإصدار الفردي البسيطة.

س: العقدة تعمل ولكن npm لا تعمل. كيف يكون ذلك ممكنا؟
ج: نادرًا، ولكن يمكن أن يحدث إذا تم كسر الارتباط الرمزي npm أو إزالته. أعد تثبيت Node.js، أو قم بتشغيلnpm install -g npm إذا كانت العقدة تعمل. باستخدام nvm، أعد تثبيت إصدار Node.

س: لماذا أحصل على أخطاء في الأذونات عند تثبيت npm -g؟
ج: أنت تقوم بالتثبيت على دليل نظام يحتاج إلى حقوق المسؤول. لا تستخدم أبدًاsudo npm – بدلاً من ذلك، قم بتكوين دليل البادئة على مستوى المستخدم (كما هو موضح أعلاه) أو استخدم nvm، مما يتجنب المشكلة تمامًا.

س: كيف أعرف ملف PATH المطلوب تحريره — .zshrc، أو .bashrc، أو .bash_profile؟
ج: افحص قوقعتك باستخدامecho $SHELL. إذا كان zsh (الافتراضي في نظام التشغيل macOS الحديث)، فقم بتحرير~/.zshrc. إذا باش، تحرير~/.bashrc (لينكس) أو~/.bash_profile (ماك).

الخلاصة

“npm: لم يتم العثور على الأمر” هي مشكلة PATH: لا يمكن لـ Shell الخاص بك العثور على موقع npm. أسرع حل يمكن الاعتماد عليه هوتثبيت Node.js عبر nvm، الذي يتعامل مع PATH والأذونات بشكل صحيح ويتيح لك تبديل الإصدارات. بخلاف ذلك، أعد تثبيت Node من المثبت الرسمي وافتح دائمًانافذة طرفية جديدة بعد ذلك. إذا تم تثبيت Node ولكن ليس في PATH، فأضف دليلها (الموجود عبرwhich node) إلى ملف تكوين Shell الخاص بك. يتم حل تسعين بالمائة من الحالات باستخدام nvm أو فتح محطة طرفية جديدة.