[{"data":1,"prerenderedAt":141},["ShallowReactive",2],{"content:\u002Fdebian-pip":3,"surround:\u002Fdebian-pip":135},{"id":4,"title":5,"body":6,"categories":107,"comment":109,"date":110,"description":111,"donation":109,"draft":112,"extension":113,"image":114,"meta":115,"navigation":109,"path":119,"permalink":119,"postfooter":109,"published":120,"readingTime":121,"recommend":126,"references":120,"seo":127,"sitemap":128,"stem":129,"tags":130,"type":133,"updated":120,"__hash__":134},"content\u002Fposts\u002F禁止用pip在系统全局Python环境安装包的解决办法.md","禁止用pip在系统全局Python环境安装包的解决办法",{"type":7,"value":8,"toc":100},"minimark",[9,13,31,41,46,56,63,69,72,78,82,87,93,97],[10,11,12],"h1",{"id":12},"报错原因",[14,15,16,17,21,22,26,27,30],"p",{},"Debian\u002FUbuntu 新版系统（Python3.10+）引入了 ",[18,19,20],"strong",{},"PEP 668","，禁止直接用 ",[23,24,25],"code",{"code":25},"pip"," 在系统全局 Python 环境安装包，防止破坏系统自带 Python，所以抛出 ",[23,28,29],{"code":29},"externally-managed-environment","。",[32,33,34],"blockquote",{},[14,35,36,37,40],{},"不推荐直接加 ",[23,38,39],{"code":39},"--break-system-packages","，容易把系统 Python 搞崩，导致 apt 等工具异常。优先使用虚拟环境。",[42,43,45],"h2",{"id":44},"方案-1使用虚拟环境推荐生产-项目部署首选","方案 1：使用虚拟环境（推荐，生产 \u002F 项目部署首选）",[47,48,53],"pre",{"className":49,"code":51,"language":52},[50],"language-text","# 进入项目目录\ncd \u002Fwww\u002Fwwwroot\u002FFriend-Circle-Lite\n\n# 安装虚拟环境依赖\napt update && apt install python3-venv python3-full -y\n\n# 创建venv\npython3 -m venv venv\n\n# 激活虚拟环境\nsource venv\u002Fbin\u002Factivate\n\n# 此时前面会出现 (venv)，再安装依赖\npip install -r .\u002Frequirements.txt\n","text",[23,54,51],{"__ignoreMap":55},"",[14,57,58,59,62],{},"后续启动项目，",[18,60,61],{},"都需要先激活虚拟环境","：",[47,64,67],{"className":65,"code":66,"language":52},[50],"source venv\u002Fbin\u002Factivate\n# 然后启动项目\n",[23,68,66],{"__ignoreMap":55},[14,70,71],{},"退出虚拟环境命令：",[47,73,76],{"className":74,"code":75,"language":52},[50],"deactivate\n",[23,77,75],{"__ignoreMap":55},[42,79,81],{"id":80},"方案-2临时强制全局安装不推荐仅测试用风险高","方案 2：临时强制全局安装（不推荐，仅测试用，风险高）",[32,83,84],{},[14,85,86],{},"⚠️ 风险：可能损坏系统 Python，apt 命令失效，仅应急测试",[47,88,91],{"className":89,"code":90,"language":52},[50],"pip install -r .\u002Frequirements.txt --break-system-packages\n",[23,92,90],{"__ignoreMap":55},[42,94,96],{"id":95},"方案-3pipx适合独立-python-应用不适合-web-项目","方案 3：pipx（适合独立 Python 应用，不适合 web 项目）",[14,98,99],{},"pipx 适合安装单个可执行程序，这个圈子项目不适用，不推荐。",{"title":55,"searchDepth":101,"depth":101,"links":102},4,[103,105,106],{"id":44,"depth":104,"text":45},2,{"id":80,"depth":104,"text":81},{"id":95,"depth":104,"text":96},[108],"技术",true,"2026-10-19 20:15:00","本文是 Handsome 主题博客的美化记录教程，以插件方式实现站点美化，操作前需做好备份。介绍三款插件：UserAgent 插件，需修改 comments.php 代码展示用户 UA；CommentToMail 用于邮箱评论通知；还有随机循环评论弹窗插件，分别给出下载地址与上传激活步骤。",false,"md","https:\u002F\u002Fimg-upyun.chario.cn\u002Fi\u002F2026\u002F10\u002F17\u002F837976.jpeg",{"aside":116,"slots":118},[117],"toc",{},"\u002Fdebian-pip",null,{"text":122,"minutes":123,"time":124,"words":125},"2 min read",1.36,81600,272,1,{"title":5,"description":111},{"loc":119},"posts\u002F禁止用pip在系统全局Python环境安装包的解决办法",[131,132],"Handsome主题","主题美化","tech","9ZkE4KuvU-mWOZ2GNRtKxYLLIF14lAEc65u_-r7ligs",[136,120],{"title":137,"path":138,"stem":139,"date":140,"type":133,"children":-1},"宝塔面板部署思源笔记","\u002F33","posts\u002F宝塔面板部署思源笔记","2026-09-23 13:14:00",1792491194671]