Python
/
uv
mirror of https://github.com/astral-sh/uv
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Suggest `uv cache clean` prior to `--reinstall` (#14659) 

## Summary

Closes https://github.com/astral-sh/uv/issues/14479.
This commit is contained in:
Charlie Marsh 2025-07-16 12:02:29 -04:00 committed by GitHub
parent 052a74c451
commit 7cdc1f62ee
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 7 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

9
docs/concepts/cache.md
View File

@ -19,12 +19,17 @@ The specifics of uv's caching semantics vary based on the nature of the dependen
If you're running into caching issues, uv includes a few escape hatches: If you're running into caching issues, uv includes a few escape hatches:
- To clear the cache entirely, run `uv cache clean`. To clear the cache for a specific package, run
`uv cache clean <package-name>`. For example, `uv cache clean ruff` will clear the cache for the
`ruff` package.
- To force uv to revalidate cached data for all dependencies, pass `--refresh` to any command (e.g., - To force uv to revalidate cached data for all dependencies, pass `--refresh` to any command (e.g.,
`uv sync --refresh` or `uv pip install --refresh ...`). `uv sync --refresh` or `uv pip install --refresh ...`).
- To force uv to revalidate cached data for a specific dependency pass `--refresh-package` to any - To force uv to revalidate cached data for a specific dependency pass `--refresh-package` to any
command (e.g., `uv sync --refresh-package flask` or `uv pip install --refresh-package flask ...`). command (e.g., `uv sync --refresh-package ruff` or `uv pip install --refresh-package ruff ...`).
- To force uv to ignore existing installed versions, pass `--reinstall` to any installation command - To force uv to ignore existing installed versions, pass `--reinstall` to any installation command
(e.g., `uv sync --reinstall` or `uv pip install --reinstall ...`). (e.g., `uv sync --reinstall` or `uv pip install --reinstall ...`). (Consider running
`uv cache clean <package-name>` first, to ensure that the cache is cleared prior to
reinstallation.)
As a special case, uv will always rebuild and reinstall any local directory dependencies passed As a special case, uv will always rebuild and reinstall any local directory dependencies passed
explicitly on the command-line (e.g., `uv pip install .`). explicitly on the command-line (e.g., `uv pip install .`).