讲师中心 微信公众号
AI工具推荐 视频效率加速

PyCharm怎么配置 requirements.txt

胖辰酱_9936

胖辰酱_9936

发布时间:2026-08-05 09:24:55

|

406人浏览过

|

来源于php中文网

原创

是,PyCharm 仅在文件名为 requirements.txt 且位于项目根目录时自动识别;否则需手动在 Settings → Python | Tools | Integrated Tools 中绑定该文件,绑定后底部状态栏显示“Requirements: requirements.txt”即生效。

pycharm怎么配置 requirements.txt

PyCharm 会自动识别 requirements.txt 吗?

会,但只在满足两个条件时:文件名必须是 requirements.txt,且放在项目根目录(和 .py 文件同级)。如果文件名写成 reqs.txt 或放在 config/ 子目录下,PyCharm 默认不识别,后续安装、同步、补全等功能都会失效。

常见错误现象:pip install -r requirements.txt 能运行,但 PyCharm 编辑器里 import 的包仍标红、无代码补全、跳转定义失败——根本原因是 PyCharm 没把这文件当“依赖清单”处理。

  • 检查路径:打开 PyCharm 左侧 Project 面板,确认 requirements.txt 和你的主模块(如 main.py)在同一层级
  • 检查后缀:Windows 用户务必开启“显示文件扩展名”,避免误存为 requirements.txt.txt
  • 重命名后需重启 PyCharm 或右键文件 → Reload project,否则缓存可能不更新

怎么让 PyCharm 把 requirements.txt 当作当前项目的依赖源?

PyCharm 不会默认用 requirements.txt 控制解释器,它只是“知道有这个文件”,真正生效要手动绑定。否则你装了包,PyCharm 还是用旧的解释器环境,import 依然报错。

操作路径:Ctrl + Alt + S → 左侧展开 Python | Tools | Integrated Tools → 在 Package requirements file for SDK 输入框里填入 requirements.txt(或点击右侧浏览按钮选中该文件)→ 点击 OK。

  • 如果项目用了虚拟环境,确保这个配置指向的是虚拟环境对应的解释器,而不是系统 Python
  • 如果填了路径但提示“File not found”,说明 PyCharm 当前打开的是父目录而非项目根目录,需重新 File → Open 到正确路径
  • 绑定后,PyCharm 底部状态栏会显示 “Requirements: requirements.txt”,这是生效标志

PyCharm 能不能自动生成 requirements.txt?

能,但 pip freeze > requirements.txt 是最常用也最危险的方式——它会把当前环境中所有已装包都写进去,包括你只临时用来调试的 jupyter、black 等无关依赖。

PyCharm 2026.2
PyCharm 2026.2

PyCharm 2026.2是 JetBrains PyCharm 的指定版本安装包,下载地址指向官方 Windows 安装包直链,可用于旧项目兼容、版本回退和环境测试。

下载

更稳妥的做法是用 pipreqs,它只扫描项目代码中实际 import 的包:

pip install pipreqs
pipreqs . --encoding=utf-8

注意:. 表示当前目录,命令必须在项目根目录下运行;如果报 UnicodeDecodeError,加 --encoding=utf-8 参数可解决。

  • pipreqs 不识别动态导入(如 importlib.import_module),对这类包得手动补进 requirements.txt
  • 生成后建议人工核对:删掉 setuptools、wheel、pip 这类构建工具,它们不是运行时依赖
  • 版本写法推荐用 ~=(兼容版本),比如 requests~=2.31.0,既锁定主版本又允许小版本升级修复

安装 requirements.txt 时 PyCharm 终端没反应或报错

最常见原因是终端没激活虚拟环境,或当前 Python 解释器不是你期望的那个。PyCharm 底部状态栏显示的 Python 版本,就是终端默认使用的解释器。

执行前先确认:

  • 终端左上角是否显示类似 (venv) 或 (myenv) 的前缀?没有就说明没激活,先运行 source venv/bin/activate(Linux/macOS)或 venv\Scripts\activate.bat(Windows)
  • 如果终端里 which python(macOS/Linux)或 where python(Windows)输出路径不是你项目配置的解释器路径,说明终端没继承 PyCharm 的环境变量
  • 直接用 PyCharm 内置终端(Alt + F12),比外接 CMD/PowerShell 更可靠;若仍不行,在终端里先运行 python -m pip install -r requirements.txt,强制走当前 Python 的 pip

复杂点在于:PyCharm 的“自动识别 + 手动绑定 + 实际执行”是三层独立机制,漏掉任何一层都会导致依赖看似装了,实则没进对的环境。尤其多人协作时,别人改了 requirements.txt 却没同步绑定设置,你就容易踩坑。

热门AI工具

更多
蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

相关专题

更多
pip安装使用方法
pip安装使用方法

安装步骤:1、确保Python已经正确安装在您的计算机上;2、下载“get-pip.py”脚本;3、按下Win + R键,然后输入cmd并按下Enter键来打开命令行窗口;4、在命令行窗口中,使用cd命令切换到“get-pip.py”所在的目录;5、执行安装命令;6、验证安装结果即可。大家可以访问本专题下的文章,了解pip安装使用方法的更多内容。

3110

2023.10.09

更新pip版本
更新pip版本

更新pip版本方法有使用pip自身更新、使用操作系统自带的包管理工具、使用python包管理工具、手动安装最新版本。想了解更多相关的内容,请阅读专题下面的文章。

7103

2024.12.20

pip设置清华源
pip设置清华源

设置方法:1、打开终端或命令提示符窗口;2、运行“touch ~/.pip/pip.conf”命令创建一个名为pip的配置文件;3、打开pip.conf文件,然后添加“[global];index-url = https://pypi.tuna.tsinghua.edu.cn/simple”内容,这将把pip的镜像源设置为清华大学的镜像源;4、保存并关闭文件即可。

8722

2024.12.23

python升级pip
python升级pip

本专题整合了python升级pip相关教程,阅读下面的文章了解更多详细内容。

4467

2025.07.23

pycharm怎么改成中文
pycharm怎么改成中文

PyCharm是一种Python IDE(Integrated Development Environment,集成开发环境),带有一整套可以帮助用户在使用Python语言开发时提高其效率的工具,比如调试、语法高亮、项目管理、代码跳转、智能提示、自动完成、单元测试、版本控制。此外,该IDE提供了一些高级功能,以用于支持Django框架下的专业Web开发。php中文网给大家带来了pycharm相关的教程以及文章,欢迎大家前来学习和阅读。

3009

2023.07.25

pycharm安装教程
pycharm安装教程

PyCharm是一款由JetBrains开发的Python集成开发环境(IDE),它提供了许多方便的功能和工具。本专题为大家带来pycharm安装教程,帮助大家解决问题。

5697

2023.08.21

如何解决pycharm找不到模块
如何解决pycharm找不到模块

解决pycharm找不到模块的方法:1、检查python解释器;2、安装缺失的模块;3、检查项目结构;4、检查系统路径;5、使用虚拟环境;6、重启PyCharm或电脑。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

738

2023.12.04

如何安装pycharm
如何安装pycharm

安装pycharm的步骤:1、访问PyCharm官方网站下载最新版本的PyCharm;2、下载完成后,打开安装文件;3、安装完成后,打开PyCharm;4、在PyCharm的主界面中等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

874

2024.02.23

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

0

2026.10.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Codebuddy 插件
Codebuddy 插件

共0课时 | 0人学习

PyCharm配置Conda环境官方文档
PyCharm配置Conda环境官方文档

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn