Understanding NPM

NPM serves as the default package manager for the JavaScript runtime environment Node.js. Its functionality parallels that of Maven or Gradle in the Java ecosystem, and pip for Python.

Installation Process

To acquire NPM, install Node.js by downloading the installer from the official website. During installation on Windows, it is advisable to use the default directory (e.g., C drive) to prevent environment variable complications. macOS users can proceed with the standard installation steps.

Since NPM is distributed alongside Node.js, installing Node.js automatically provides NPM. Verify the installation by executing the following commands in your terminal:

node -v
npm -v

Because NPM receives updates more frequently than Node.js, you might need to update it independently:

npm install -g npm@latest

macOS users may encounter permission errors. If this occurs, prefix the command with sudo:

sudo npm install -g npm@latest

Initializing a Project

Before installing external libraries, create a dedicated directory for your project. Avoid using names like node or npm for this folder to prevent conflicts with system commands.

Navigate to your project folder in the terminal and initialize the package manager:

npm init

This command prompts you for metadata regarding the project. To bypass the prompts and generate a file with default values automatically, use:

npm init -y

This process creates a package.json file, which contains crucial configuration details:

• name: The project identifier. It must be lowercase, contain no spaces, and may use hyphens or underscores.
• version: The current project version.
• description: A brief summary of the project's purpose.
• main: The primary entry point for the application, defaulting to index.js.
• scripts: Shortcuts for frequently used command-line tasks.

Managing Dependencies

Libraries installed via NPM are categorized into dependencies (required for the application to run in production) and devDependencies (required only during local development and testing).

To add a package to the production dependencies (in modern NPM versions, --save is the default behavior):

npm install lodash

To add a package strictly for development:

npm install jest --save-dev

Executing these commands downloads the specified packages into a local node_modules directory and automatically updates the package.json file.

Installing Specific Versions

If a specific release of a library is required, append the version number using the @ symbol:

npm install lodash@4.17.21

Removing Packages

To uninstall a library and remove its entry from package.json:

npm uninstall lodash

Alternative Registries

Connecting to the default NPM registry can sometimes be unstable depending on your geographic location. To resolve this, you can utilize the Taobao registry mirror by installing cnpm:

npm install -g cnpm --registry=https://registry.npm.taobao.org

Once installed, you can use cnpm as a direct replacement for npm:

cnpm install axios