一、安装uv
1、windows下安装
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
2、ubuntu下安装
curl -LsSf https://astral.sh/uv/install.sh | sh
如果ubuntu上因为网络问题无法安装,可以在本地下载安装包:
https://release-assets.githubusercontent.com/github-production-release-asset/699532645/a034e752-ce48-4b91-ac8e-148a7fa3f4f7?sp=r&sv=2018-11-09&sr=b&spr=https&se=2025-11-06T06%3A56%3A01Z&rscd=attachment%3B+filename%3Duv-x86_64-unknown-linux-gnu.tar.gz&rsct=application%2Foctet-stream&skoid=96c2d410-5711-43a1-aedd-ab1947aa7ab0&sktid=398a6654-997b-47e9-b12b-9515b896b4de&skt=2025-11-06T05%3A55%3A46Z&ske=2025-11-06T06%3A56%3A01Z&sks=b&skv=2018-11-09&sig=GgGOo%2BFFNfQvzGOJSIbZ%2FevuBMFySqoIknFJqAO0%2FlI%3D&jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmVsZWFzZS1hc3NldHMuZ2l0aHVidXNlcmNvbnRlbnQuY29tIiwia2V5Ijoia2V5MSIsImV4cCI6MTc2MjQxMTYwOCwibmJmIjoxNzYyNDA5ODA4LCJwYXRoIjoicmVsZWFzZWFzc2V0cHJvZHVjdGlvbi5ibG9iLmNvcmUud2luZG93cy5uZXQifQ.EZIcoE1vsJHZ4X-7Dd583nIPB8EtjeGz2-UjlF3eiNI&response-content-disposition=attachment%3B%20filename%3Duv-x86_64-unknown-linux-gnu.tar.gz&response-content-type=application%2Foctet-stream
上传到服务器后部署:
mkdir -p ~/.local/bin # 确保目录存在tar -zxvf uv-x86_64-unknown-linux-gnu.tar.gzmv uv ~/.local/bin/
最后将 ~/.local/bin加入环境变量即可:
vim ~/.bashrc# 在文件末尾添加export PATH="$HOME/.local/bin:$PATH"# 生效配置source ~/.bashrc
3、配置国内加速镜像
国内常用镜像有:
清华源:https://pypi.tuna.tsinghua.edu.cn/simple阿里云源:https://mirrors.aliyun.com/pypi/simple/豆瓣源:https://pypi.douban.com/simple/中国科学技术大学:https://pypi.mirrors.ustc.edu.cn/simple
windows增加环境变量UV_INDEX_URL,设置成上面的值即可,如:
UV_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple/
linux下同理:
echo 'export UV_INDEX_URL="https://pypi.tuna.tsinghua.edu.cn/simple/"' >> ~/.bashrc
source ~/.bashrc
二、使用uv
1、使用命令 uv init 生成 pyproject.toml 和 uv.lock
2、通过 uv add 命令添加依赖,使用该命令不需要执行 uv lock来更新uv.lock文件,只有当手动修改 pyproject.toml 文件时才需要执行 uv lock 命令。
3、使用 uv run manage.py runserver 0.0.0.0:10000 运行服务,用 uv run 的方式来运行可以自动激活虚拟环境。
4、如果是在 pycharm 中运行,需要先编辑一下 ”运行/调试配置“,将 “环境变量” 里的内容删除。是因为如果有多个django项目都使用了config作为配置文件夹名称,它在找路由时,会通过config.urls去找,容易串项目而出错。
三、部署到服务器
1、配置uv国内镜像加速
1、同步依赖环境
uv sync
2、运行django
uv run manage.py runserver 0.0.0.0:10000