Hey there, let's work through this frustrating node-gyp error you're hitting when running npm install on your React course files. The error points to a failure building fsevents (a macOS-specific file watching library), which usually stems from missing system dependencies needed for compiling native Node.js modules.

Here are targeted steps to resolve this:

Step 1: Ensure Xcode Command Line Tools are Installed and Configured #

node-gyp relies on macOS's build tools provided by Xcode. Let's make sure they're set up correctly:

• Run this command to install (or reinstall) the tools:

  xcode-select --install
  

• If you already have them installed, reset the path to fix any misconfiguration:

  sudo xcode-select --reset
  

• Finally, accept the Xcode license agreement (required to use the build tools):

  sudo xcodebuild -license accept
  

Step 2: Configure Python for node-gyp #

node-gyp requires Python (v2.7 or v3.6+ for newer versions). Let's ensure npm uses the correct Python version:

• First, check which Python versions are available on your system:

  which python3 python
  

• Set npm to use the appropriate Python path (replace with your actual path from the above command):

  # For Python 3
  npm config set python /usr/bin/python3
  # Or for Python 2.7 if that's what your system uses
  npm config set python /usr/bin/python
  

Step 3: Clean and Reinstall Dependencies from Scratch #

Corrupted node_modules or lock files can often trigger this issue. Let's start fresh:

• Delete existing dependencies and lock file:

  rm -rf node_modules package-lock.json
  

• Clear npm's cache completely:

  npm cache clean --force
  

• Reinstall your project dependencies:

  npm install
  

Step 4: Temporary Workaround – Skip Optional Dependencies #

Since fsevents is an optional dependency for macOS, you can try installing without optional packages to bypass the build error temporarily:

npm install --no-optional

Note: This is a quick fix—ideally, you should resolve the build environment issue so all dependencies work properly long-term.

Step 5: Fix npm Permissions (If You've Used sudo Before) #

If you've ever run sudo npm install, you might have permission issues that break dependency installation. Fix this by setting up a user-specific npm directory:

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc # Use ~/.bash_profile if you use Bash
source ~/.zshrc # Or source ~/.bash_profile

Start with Steps 1 and 2—missing build tools and Python misconfiguration are the most common culprits on macOS Catalina (Darwin 19.4.0). Let me know if any of these steps resolve your issue!

内容的提问来源于stack exchange，提问作者jibaro