技能档案

Switch To Pnpm

Name: Switch To Pnpm
Author: wKovacs64

Convert a project from npm to pnpm package management. Use when switching package managers, setting up pnpm, or when user mentions migrating from npm to pnpm.

wKovacs640 星标2026年3月23日

职业
分类: 打包与分发

技能内容

Migrate from npm to pnpm

Convert a project from npm to pnpm for package management.

Steps

Analyze project structure:
- Check if monorepo (multiple package.json files, workspaces config)
- Identify npm-specific files: package-lock.json, .npmrc
- Check for npm scripts that need updating
- Look for CI/CD configs referencing npm
Clean existing npm artifacts:
```
rm -rf node_modules
rm -f package-lock.json
```
- For monorepos, also remove node_modules from all workspace packages
Configure pnpm workspace (monorepos only):
- Create pnpm-workspace.yaml:

相关技能

Switch To Pnpm | Skills Pool

packages:
  - 'packages/*'
  - 'apps/*'

Add packageManager field to package.json before dependencies:

"packageManager": "[email protected]"

Use pnpm info pnpm to identify the latest version and use that version in the packageManager field.
Insert right before the first dependencies section (peerDependencies, dependencies, or devDependencies - whichever comes first)
This tells tools (including pnpm/action-setup) which version to use

Install dependencies with pnpm:

pnpm install

This creates pnpm-lock.yaml
Review any peer dependency warnings
IMPORTANT: pnpm may warn about ignored build scripts and suggest running pnpm approve-builds. Never run this command - ignore the warning.

Handle MSW (if using Mock Service Worker):

Remove the msw section from package.json (e.g., "msw": { "workerDirectory": "public" })

Add a postinstall script in approximate alphabetical order within scripts:

"scripts": {
  "postinstall": "msw init ./public --no-save || true",
  ...
}

GitHub Actions: Update workflow files in .github/workflows/

- name: ≡ƒôª Install pnpm
  uses: pnpm/action-setup@v4

- name: ΓÄö Setup node
  uses: actions/setup-node@v4
  with:
    cache: pnpm
    node-version-file: '.nvmrc'

- name: ≡ƒôÑ Install deps
  run: pnpm install

- name: ≡ƒö¼ Generate Prisma client
  run: pnpm exec prisma generate

- name: ≡ƒöÄ Type check
  run: pnpm typecheck

Replace npm run X with pnpm X
Update cache from npm to pnpm
Note: pnpm install automatically uses --frozen-lockfile in CI environments

Install pnpm as its own RUN command right after NODE_ENV: RUN npm install -g [email protected]
Do NOT append pnpm install to other RUN commands (e.g., system dependencies)
Copy pnpm-lock.yaml instead of package-lock.json
Use pnpm install --frozen-lockfile for reproducible builds
Use pnpm install --frozen-lockfile --prod for production-only deps
Copy package.json before running pnpm exec prisma generate (pnpm requires it)

Example:

FROM node:24-slim AS base
ENV NODE_ENV="production"

# install pnpm
RUN npm install -g [email protected]

FROM base AS deps
COPY package.json pnpm-lock.yaml .npmrc ./
RUN pnpm install --frozen-lockfile

FROM base AS prod-deps
COPY package.json pnpm-lock.yaml .npmrc ./
RUN pnpm install --frozen-lockfile --prod

FROM base AS build
COPY --from=deps /app/node_modules node_modules
COPY package.json package.json
COPY prisma prisma
RUN pnpm exec prisma generate
COPY . .
RUN pnpm build

Check for scripts like start.sh, entrypoint.sh, etc.
Replace npm run with pnpm
Replace npx with pnpm exec

Example:

# Before
npx prisma migrate deploy
npm run start

# After
pnpm exec prisma migrate deploy
pnpm start

Add customManagers section right before packageRules to keep Dockerfile pnpm version in sync:

"customManagers": [
  {
    "customType": "regex",
    "managerFilePatterns": ["Dockerfile", "Dockerfile.*"],
    "matchStrings": ["npm install -g pnpm@(?<currentValue>[^\\s]+)"],
    "depNameTemplate": "pnpm",
    "datasourceTemplate": "npm"
  }
],
"packageRules": [

npm	pnpm
`npm install`	`pnpm install`
`npm install <pkg>`	`pnpm add <pkg>`
`npm install -D <pkg>`	`pnpm add -D <pkg>`
`npm install -g <pkg>`	`pnpm add -g <pkg>`
`npm uninstall <pkg>`	`pnpm remove <pkg>`
`npm run <script>`	`pnpm <script>` or `pnpm run <script>`
`npm ci`	`pnpm install --frozen-lockfile`
`npx <installed-pkg>`	`pnpm exec <pkg>`
`npx <one-off-pkg>`	`pnpm dlx <pkg>`
`npm update`	`pnpm update`
`npm audit`	`pnpm audit`

Switch To Pnpm

Migrate from npm to pnpm

Steps

Switch To Pnpm

Migrate from npm to pnpm

Steps

Command Reference

Monorepo Considerations

Bun Runtime

Bun Runtime

Python Patterns

Python Patterns

Publish Extension

Minecraft Modpack Server