{ "componentChunkName": "component---src-templates-issues-tsx", "path": "/issues/403", "result": {"data":{"issuesJson":{"id":"4255e5eb-c181-5b80-b711-f4839394755c","title":"voidcosmos/npkill: 该工具可以列出系统中的任何 node_modules 目录，以及它们占用的空间。然后，您可以选择要清除哪些文件以释放空间","number":403,"bodyHTML":"
\n



\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Reposvoidcosmos/npkill
Views\"views\"
Stars\"stars\"
Forks\"forks\"
License\"license\"
UpdatedAt\"last-commit\"
CreatedAt\"create-at\"
\n\n

\"\"

\n\n
\n

\n \"npkill\n \"npkill\n

\n

\n\"npm\"\n\"Donations\n\"npm\n\"NPM\"\n

\n

Easily find and remove old and heavy node_modules folders ✨

\n

\n \"npkill\n

\n

This tool allows you to list any node_modules directories in your system, as well as the space they take up. You can then select which ones you want to erase to free up space. Yay!

\n

i18n

\n

We're making an effort to internationalize the Npkill docs. Here's a list of the available translations:

\n\n

Table of Contents

\n\n

\n

✔️ Features

\n\n

\n

☁️ Installation

\n

You don't really need to install it to use it!
\nSimply use the following command:

\n
$ npx npkill
\n

Or if for some reason you really want to install it:

\n
$ npm i -g npkill\n# Unix users may need to run the command with sudo. Go carefully
\n
\n

NPKILL does not support node<v14. If this affects you you can use npkill@0.8.3

\n
\n

\n

📋 Usage

\n
$ npx npkill\n# or just npkill if installed globally
\n

By default, npkill will scan for node_modules starting at the path where npkill command is executed.

\n

Move between the listed folders with ↓ ↑, and use Space or Del to delete the selected folder.
\nYou can also use j and k to move between the results.

\n

You can open the directory where the selected result is placed by pressing o.

\n

To exit, Q or Ctrl + c if you're brave.

\n

Important! Some applications installed on the system need their node_modules directory to work and deleting them may break them. NPKILL will highlight them by displaying a ⚠️ to be careful.

\n

\n

Options

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
ARGUMENTDESCRIPTION
-c, --bg-colorChange row highlight color. (Available: blue, cyan, magenta, white, red and yellow)
-d, --directorySet the directory from which to begin searching. By default, starting-point is .
-D, --delete-allAutomatically delete all node_modules folders that are found. Suggested to be used together with -x.
-e, --hide-errorsHide errors if any
-E, --excludeExclude directories from search (directory list must be inside double quotes \"\", each directory separated by ',' ) Example: \"ignore1, ignore2\"
-f, --fullStart searching from the home of the user (example: \"/home/user\" in linux)
-gbShow folders in Gigabytes instead of Megabytes.
-h, --help, ?Show this help page and exit
-nu, --no-check-updateDon't check for updates on startup
-s, --sortSort results by: size, path or last-mod
-t, --targetSpecify the name of the directories you want to search (by default, is node_modules)
-x, --exclude-hidden-directoriesExclude hidden directories (\"dot\" directories) from search.
--dry-runIt does not delete anything (will simulate it with a random delay).
-v, --versionShow npkill version
\n

Warning: In future versions some commands may change

\n

\n

Examples

\n\n
npkill -d ~/projects\n\n# other alternative:\ncd ~/projects\nnpkill
\n\n
npkill --target dist -e
\n\n
npkill --color magenta
\n\n
npkill -d '~/more projects' -gb --sort size --target vendor
\n\n
npkill -d 'projects' --exclude \"progress, ignore-this\"
\n\n
npkill -d ~/backups/ --delete-all
\n

\n

📟 Set Up Locally

\n
# -- First, clone the repository\ngit clone https://github.com/voidcosmos/npkill.git\n\n# -- Navigate to the dir\ncd npkill\n\n# -- Install dependencies\nnpm install\n\n# -- And run!\nnpm run start\n\n\n# -- If you want to run it with some parameter, you will have to add \"--\" as in the following example:\nnpm run start -- -f -e
\n

\n

🔮 Roadmap

\n\n

\n

🐛 Known bugs 🐛

\n\n
\n

If you find any bugs, don't hesitate and open an issue :)

\n
\n

\n

💞 Contributing

\n

If you want to contribute check the CONTRIBUTING.md

\n

\n

☕ Buy us a coffee

\n

\nWe have developed npkill in our free time, because we are passionate about the programming sector.\nTomorrow we would like to dedicate ourselves to this, but first, we have a long way to go.\n

We will continue to do things anyway, but donations are one of the many ways to support what we do.

\n

\"Open

\n

Thanks!!

\n

A huge thank you to our backers ❤️

\n

\n
\n

Crypto alternative

\n\n

\n

📜 License

\n

MIT © Nya García Gallardo and Juan Torres Gómez

\n

🐱🐤

\n
","updatedAt":"2025-05-21T16:13:38Z","upvoteCount":null,"author":{"login":"eryajf","avatarUrl":"https://avatars.githubusercontent.com/u/33259379?u=e4a4090a38ac2473aaed4ef9945233636776c6c3&v=4","url":"https://github.com/eryajf"},"category":null,"labels":{"edges":[{"node":{"name":"更多","color":"25B472"}},{"node":{"name":"命令行工具","color":"e05879"}},{"node":{"name":"voidcosmos","color":"039630"}}]},"comments":{"edges":[]}}},"pageContext":{"number":403,"previous":{"title":"hanshuaikang/Nping: 一个基于 Rust 开发的终端可视化 Ping 工具, 支持多地址并发 Ping, 可视化图表展示, 数据实时更新等特性","number":402},"next":{"title":"ehang-io/nps: 一款轻量级、高性能、功能强大的内网穿透代理服务器。支持 tcp、udp、socks5、http 等几乎所有流量转发，可用来访问内网网站、本地支付接口调试、ssh 访问、远程桌面，内网 dns 解析、内网 socks5 代理等，并带有功能强大的 web 管理端。","number":404}}}, "staticQueryHashes": ["151096407","2861350382"]}