如何实现npm全局安装的可移植性？

Great question—this is exactly the kind of workflow dotfiles were built to solve! Unlike some tools that store configs in a dedicated file, npm doesn’t keep a built-in list of your global packages by default, but it’s super easy to generate one and add it to your Git-hosted dotfiles. Here’s how to do it:

Capture Your Global npm Packages #

First, generate a clean list of your installed global packages. You can choose between two formats based on your needs:

Option 1: Package Names Only (Flexible Versions) #

This creates a list of just package names, so npm will install the latest compatible version when restoring:

# Using jq for clean output (install jq first if you don't have it)
npm list -g --depth=0 --json | jq -r '.dependencies | keys[]' > ~/.npm-global-packages

# If you don't want to install jq, use this awk/grep alternative:
npm list -g --depth=0 | awk -F ' ' '{print $2}' | awk -F '@' '{print $1}' | grep -v 'npm' > ~/.npm-global-packages

The grep -v 'npm' excludes the npm package itself (since most machines will have npm pre-installed or managed via tools like nvm).

Option 2: Exact Versions (Perfect Consistency) #

If you need to match exact versions across machines (great for avoiding unexpected updates that break workflows), generate a list with version numbers:

npm list -g --depth=0 --json | jq -r '.dependencies | to_entries[] | "\(.key)@\(.value.version)"' > ~/.npm-global-packages

Add the List to Your Dotfiles #

Now, integrate this file into your Git-hosted dotfiles repo:

• Move the .npm-global-packages file into your dotfiles directory (e.g., ~/dotfiles/)
• Create a symlink from your home directory to the file in the repo:

  ln -s ~/dotfiles/.npm-global-packages ~/.npm-global-packages
  

• Commit the file to Git:

  git add .npm-global-packages
  git commit -m "Add global npm packages list for cross-machine sync"
  

Restore Packages on a New Machine #

Once you’ve cloned your dotfiles repo on a new computer (and set up the symlink), run this command to install all your global packages:

cat ~/.npm-global-packages | xargs npm install -g

If you used the exact version format, this will install the precise versions you had on your original machine.

Pro Tips #

• If you use nvm to manage Node.js versions, add your .nvmrc file to dotfiles too—this ensures you’re using the same Node/npm version across all machines, avoiding compatibility issues.
• Periodically update your .npm-global-packages file after installing new global packages, then commit the changes to Git to keep your dotfiles in sync.

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