自动摘要: 学习官网:[https://www.jetbrains.com/help/pycharm/quickstartguide.html](https://www.jetbrains.com/help/ ……..
学习官网:https://www.jetbrains.com/help/pycharm/quick-start-guide.html
1、简介
PyCharm是一个专用的Python集成开发环境(IDE),有三个版本:
- 社区版 Community (免费和开源):用于智能和智能的Python开发,包括代码帮助,重构,可视化调试和版本控制集成。
- 专业版 Professional (付费):用于专业的Python,Web和数据科学开发,包括代码辅助,重构,可视化调试,版本控制集成,远程配置,部署,支持流行的Web框架,如Django和Flask,数据库支持,科学工具(包括Jupyter笔记本支持),大数据工具。
- Edu (免费和开源):用于通过集成的教育工具学习编程语言和相关技术。
有三个选项可用于在 IDE 中开始处理项目:
- 打开现有项目:Open an existing project
- 从版本控制中签出项目:Check out a project from version control
- 创建新项目:Create a new project
1.0 初界面介绍
PyCharm 会在未打开任何项目时显示欢迎屏幕。例如,当您首次运行 PyCharm 时,或者当您关闭项目的唯一打开实例时。在此屏幕中,您可以创建新项目,使用PyCharm Edu开始学习路径,导入,打开或从版本控制中签出现有项目。
使用“自定义”选项卡配置工作环境,使用“插件”选项卡管理 IDE 插件。打开“学习 PyCharm”选项卡以查找大量资源以熟悉 IDE。展开可用交互式课程列表以选择要尝试的课程。PyCharm将打开一个特定的学习项目,在真实环境中逐步研究该主题。按照“学习”视图中的说明,在实际编码示例上测试您的新技能。如果您之前在 PyCharm 中打开过项目,则会在右侧窗格中看到它们的列表。您可以开始键入以查找项目,单击以将其打开,或者使用上下文菜单或螺母图标(红色框)从列表中删除任何项目。
从“帮助”菜单中,可以打开帮助页面、每日提示和默认键盘映射引用、编辑平台属性、收集日志和诊断数据以及检查更新。如果要在工作结束后返回到“欢迎”屏幕,请关闭所有打开的项目。
1.1 打开现有项目:Open an existing project
打开存储在计算机上的现有项目之一 。您可以在“欢迎”(welcome to PyCharm)屏幕上的最近项目列表中选择一个,或单击“打开”(open):
否则,可以为现有源文件创建项目。在“文件”(File)菜单上选择命令“打开”(Open),然后指定源所在的目录。然后,PyCharm将从您的源代码为您创建一个项目。有关详细信息,请参阅从现有源代码导入项目部分。
1.2 从版本控制中签出项目:Check out a project from version control
您还可以从 VCS 存储或存储库下载源。选择”Git(GitHub)”, “Mercurial”, “Subversion”, “Perforce (仅在专业版中受支持)”,然后输入您的凭据以访问存储。然后,输入源的路径并将存储库克隆到本地主机:
有关详细信息,请参阅版本控制部分。
1.3 创建新项目:Create a new project
要创建项目,请执行下列操作之一:
- 从主菜单中,选择“文件|新建项目“;
- 在“欢迎”屏幕上,单击“新建项目”;
在 PyCharm社区版中,您只能创建 Python 项目,而使用 PyCharm 专业版,您可以使用多种选项来创建 Web 框架项目。
有关更多详细信息,请参阅创建 Python 项目。创建新项目时,需要指定 Python 解释器来执行项目中的 Python 代码。您的计算机上至少需要一个 Python 安装可用。对于一个新项目,PyCharm创建了一个孤立的虚拟环境:venv, pipenv, poetry, 或 Conda。在工作时,您可以更改它或创建新的解释器。您还可以快速预览为解释器安装的包,并在 Python Package工具窗口中添加新包。
有关更多详细信息,请参阅配置 Python 解释器。具体步骤如下:
虽然您可以在PyCharm中创建各种类型的项目,但在本教程中,让我们创建一个简单的纯Python项目。此模板将创建一个空项目。
选择项目位置。单击位置(Location) 字段旁边的“
”按钮并指定项目的目录。此外,请取消选中“创建 main.py 欢迎脚本”复选框,因为您将为本教程创建一个新的 Python 文件。
Python的最佳实践是为每个项目创建一个虚拟env。在大多数情况下,PyCharm会自动创建一个新的虚拟环境,您无需进行任何配置。不过,您可以预览和修改venv选项。展开“Python 解释器:新建虚拟环境”( **Python Interpreter: New Virtualenv Environment)节点,然后选择用于创建新的虚拟环境的工具。让我们选择虚拟环境(Virtualenv)**工具,并指定环境的位置和用于新虚拟环境的基本Python解释器。配置基本解释器时,需要指定 Python 可执行文件的路径。如果 PyCharm 在您的计算机上没有检测到任何 Python,它将提供以下选项:Windows操作系统
有关更多详细信息,请参阅配置 Python 解释器。现在,单击“新建项目”对话框底部的“创建”按钮。
- 指定 Python 可执行文件的路径(在非标准安装的情况下)
- 从 python.org 下载并安装最新的Python版本
- 使用命令行开发人员工具安装 Python(仅限 macOS)。
1.4 项目界面介绍
打开项目时,您会看到主窗口分为几个逻辑区域。让我们花点时间看看这里的关键UI元素:
- 左侧的项目工具窗口(Project tool window )显示您的项目文件。
- 右侧的编辑器(Editor),您实际编写代码的位置。它具有选项卡,可在打开的文件之间轻松导航。
- 此外,编辑器上方的导航栏还允许您快速运行和调试应用程序以及执行基本的 VCS 操作。
- 装订线(Gutter),编辑器旁边的垂直条纹,显示您拥有的断点(breakpoints),并提供一种在代码中导航(navigate through the code)的便捷方式,例如转到定义(definition)/声明(declaration)。它还显示行号和每行 VCS 历史记录。
- 滚动条(Scrollbar),位于编辑器的右侧。PyCharm 会持续监控代码的质量,并始终在装订线中显示其代码检查的结果:错误(errors)、警告(warnings)等。右上角的指示器(indicator)显示整个文件的代码检查的总体状态。
- 工具窗口(Tool windows)是附加到工作区底部和侧面的专用窗口,提供对典型任务(如项目管理(project management)、源代码搜索(source code search)和导航(navigation)、与版本控制系统集成(integration with version control systems)等)的访问。
- 默认情况下,工具窗口停靠在主窗口的两侧和底部,可以根据需要对它们进行排列、取消停靠、调整大小、隐藏等等。右键单击工具窗口的标题,或单击排列选项的标题按钮
。 - 您可以指定快捷方式以快速访问您经常使用的工具窗口。默认情况下,其中一些具有快捷方式。例如,要打开“项目”工具窗口,请按Alt+1 ,然后按Alt+F12打开“终端”工具窗口。要从编辑器跳转到上一个活动工具窗口,请按F12。
- 默认情况下,工具窗口停靠在主窗口的两侧和底部,可以根据需要对它们进行排列、取消停靠、调整大小、隐藏等等。右键单击工具窗口的标题,或单击排列选项的标题按钮
- 状态栏(status bar)指示项目和整个 IDE 的状态,并显示各种警告和信息消息,如文件编码、行分隔符、检查配置文件等。它还提供对Python解释器设置的快速访问。
- 此外,在 PyCharm 窗口的左下角的“Status bar”栏中,您会看到
或
,此按钮用于切换工具窗口条的显示。如果将鼠标指针悬停在此按钮上,将显示当前可用的工具窗口列表。 - 状态栏还显示后台任务的进度。可以单击
以显示后台任务管理器。Widget Description 52:11 显示编辑器中当前插入符号位置的行号和列号。单击这些数字可以将插入符号移动到特定的行和列。如果您在编辑器中选择一个代码片段,PyCharm 还会显示所选片段中的字符数和换行符数。 LF 当前文件中断开行的行结束符,单击可更改行分隔符 用于查看当前文件的编码,单击可使用另一种编码。 Column 当前编辑器标签启用列选择模式,你可以按下Alt + Shift +Insert切换。 单击此处可锁定文件不进行编辑(设置为只读),如果要编辑文件,请解除锁定 Python 解释器的选择器,它展示了当前python的版本。单击它可以添加一个新的 Python 解释器,选择一个现有的解释器,或者打开解释器设置列表。 master 如果启用了版本控制集成,此小部件将显示当前的 VCS 分支。单击它可以管理 VCS 分支。 显示当前文件中使用的缩进样式。单击此处可为当前文件类型配置标签和设置缩进。 显示 PyCharm 从堆内存总量中消耗的内存量。有关更多信息,请参考增加 IDE 的内存堆。 单击此处可将任何已配置的部署服务器或服务器组设置为默认值,以执行部署操作。
- 此外,在 PyCharm 窗口的左下角的“Status bar”栏中,您会看到
使用导航栏右上侧的按钮去生成(build)
、运行(Run)
和调试(debug)
你的程序,并执行基本的版本控制操作(如果配置了版本控制集成)。它还包含“运行任何内容
”(按两次Ctrl) 和“搜索所有位置
”(按两次Shift)的按钮。默认情况下,带有用于打开和保存文件,撤消(undo)和重做(redo)操作的按钮的主工具栏处于隐藏状态。若要显示它,请选择“查看|外观|工具栏(View | Appearance | Toolbar)”。
1.5 智能辅助进行编码
1.5.1 意图动作Intention actions:
PyCharm会密切关注您当前正在做的事情,并提出明智的建议,称为意图行动(intention actions),以节省更多时间。使用灯泡指示的意图操作允许您对正确的代码应用自动更改(与为可能不正确的代码提供快速修复的代码检查相反)。您是否忘记向构造函数添加一些参数和字段初始值设定项?PyCharm没有问题。单击灯泡(或按Alt+Enter),然后选择建议的选项之一:
可用意图行动的完整列表可在文件(File)|设置(Settings)|编辑器(Editor)|意图(Intentions),或 PyCharm|首选项(Preferences)|编辑器(Editor)|意图(Intentions)针对苹果操作系统用户。
1.5.2 保持代码整洁
PyCharm 会监控您的代码,并尝试保持其准确和干净。它可以检测潜在的错误和问题,并提出快速修复(quick-fixes)建议。每当 IDE 发现未使用的代码、无限循环以及许多其他可能需要您注意的内容时,您都会看到一个灯泡。单击它,或按Alt+Enter,以应用修补程序。可用检查(inspections)的完整列表可在设置(Settings)|编辑器(Editor)**|**检查(Inspections)(或PyCharm|首选项(Preferences)|编辑器(Editor)|检查(Inspections)是对苹果操作系统用户)。禁用其中一些,或启用其他检查,并调整每个检查的严重性。您决定是应将其视为错误还是仅将其视为警告。
1.5.3生成一些代码
当您使用PyCharm中提供的代码生成选项(code generation options)时,编写代码可以更容易、更快捷。代码(Code) | 生成(Generate)菜单Alt+Insert将帮助您从使用中创建符号,并建议覆盖或实现一些功能:
使用实时模板(选择“代码(Code) | 插入实时模板(Insert Live Template)或按Ctrl+J)生成整个代码构造。您可以在“设置(Settings)/首选项(Preferences)”(Ctrl+Alt+S)对话框中浏览可用的即用型实时模板(Settings | Editor | Live templates 或 PyCharm | Preferences | Editor | Live Templates 用于 macOS 用户)。如果在开发中发现缺少特别重要的内容,请使用自己的模板扩展这组模板。此外,请考虑使用完整的构造快速包围代码(选择Code | Surround With 或按Ctrl+Alt+T。例如,使用if语句:
1.6 寻找信息
当您的项目很大时,或者当您必须使用其他人的代码时,能够快速找到您要查找的内容并深入研究代码至关重要。这就是为什么PyCharm带有一组导航(navigation)和搜索(search)功能的原因,这些功能可以帮助您找到任何代码,无论它多么纠结。
1.6.1 基本搜索
基本搜索:使用这些搜索工具,您可以在当前打开的文件中(Ctrl+F)或在整个项目中(Ctrl+Shift+F)找到并替换任何代码片段,例:为了找到特定符号的使用位置,PyCharm建议通过查找用法(Find Usages)Alt+F7进行全面搜索:
1.6.2 项目导航
只需查看文件结构及其导入或调用层次结构,您就可以知道很多信息:
此外,您还可以导航到:
- 按名称排列的类(Class)、文件(file)或符号(symbol);
- 声明(Declaration) Ctrl+B;
- 基类(Base class)/基函数(base function) Ctrl+U;
左侧装订线中的图标还可以帮助您进行导航:
1.6.3 在时间轴中导航
记住您在项目中的所有活动,PyCharm可以轻松地将您导航到 最近使用的文件(Ctrl+E) 或 最近更改的文件(Alt+Shift+C) 。要浏览更改历史记录,请尝试使用“后退(Ctrl+Alt+Left)/前进(Ctrl+Alt+Right)”导航 和/或转到上次编辑位置(Ctrl+Shift+Backspace)。
1.6.4 搜索无处不在
如果您对要查找的内容有大致的了解,则始终可以使用现有导航功能之一找到相应的元素。但是,如果您想在每个角落和缝隙中寻找一些东西,该怎么办?答案是使用“无处不在的搜索”!若要尝试此操作,请单击窗口右上角的放大镜按钮,或使用“双移”(Double Shift) (按 Shift 两次)调用它。
1.7 运行、调试和测试
现在,当你玩完代码并发现可以使用它做什么时,就可以运行、调试和测试你的应用了。
1.7.1 运行Run
运行应用程序的最简单方法是在编辑器中右键单击,然后从上下文菜单中选择“Run
如果 Python 脚本包含__main__,则可以单击装订线中的
按钮,然后选择所需的命令。您可以在”运行(Run)”工具窗口中查看脚本执行情况。
使用 PyCharm 执行运行、调试或测试操作时,始终使用其参数基于现有运行/调试配置之一启动进程。当您第一次运行应用程序时,PyCharm 会自动创建临时运行/调试配置。您可以修改它以指定或更改默认参数,并将其另存为永久的运行/调试配置。请参阅运行/调试配置中的如何优化运行/调试配置。
1.7.2 调试Debug
您的应用程序是否偶尔发生运行时错误?要找出导致它的原因,您必须进行一些调试。PyCharm 支持所有平台上的调试器。调试从放置断点开始,程序执行将暂停,以便您可以浏览程序数据。只需单击要显示断点的行的装订线。若要开始调试应用程序,请按Shift+F9。然后逐步执行程序(请参阅“运行”菜单或“调试”工具窗口中的可用选项),计算任意表达式,添加监视,并手动设置变量的值。
有关详细信息,请参阅调试部分。单击按钮
图标继续执行脚本,然后在控制台选项卡中输入S,按Enter:
继续运行脚本。这里的异常。还出现了另一个断点:默认情况下,PyCharm 将因代码中未捕获的任何异常而停止,并且它将显示带有闪电的断点图标。
1.7.4 测试Test
测试应用程序是非常有必要的,PyCharm帮助尽可能简单地做到这一点。使用PyCharm,您可以:
- 创建测试
- 创建特殊的测试运行(testing run)/调试配置(debug configurations)。
- 使用测试运行/调试配置,直接从 IDE 运行和调试测试。
- 最后,最重要的是 - 您可以在“运行”工具窗口的“测试运行程序”选项卡中浏览测试结果:
若要了解这些数字,请阅读“测试运行程序”选项卡部分。PyCharm 支持所有专业python测试框架:
- 单元测试
- 文档测试
- 鼻子测试
- 测试
对于这些框架中的每一个,PyCharm都提供了自己的运行/调试配置。请参阅教程步骤 3。测试您的第一个 Python 应用程序,并转到运行测试部分了解详细信息。使用 PyCharm 专业版,您可以远程运行、调试和测试您的 Python 代码。您可以将本地应用程序部署到某个远程服务器。若要了解有关部署服务器的信息,请参阅配置与 Web 服务器的同步部分。PyCharm 专业版还有助于比较本地和远程文件夹,并将本地副本与服务器上部署的副本同步。
1.8 将源代码保留在版本控制下
1.8.1 VCS
如果您将源代码置于版本控制之下,您会很高兴知道PyCharm与许多流行的版本控制系统进行集成:Git(或GitHub)、Mercurial、Perforce(仅在专业版中受支持)、Subversion。要指定特定 VCS 的凭据和一些设置,请转到 **设置(Settings) | 版本控制(Version Control)(或PyCharm | Preferences | Version Control(如果您是 macOS 用户)。VCS 菜单为您提供了有关可用命令的线索。例如,您可以从本地更改视图中查看所做的更改、提交这些更改、创建更改列表等:VCS |显示更改(Show Changes)**(或按Alt+9 )。另外,在编辑器上方的导航栏中查找一些 VCS 基本命令:
有关详细信息,请参阅版本控制部分。
1.8.2 本地历史
除了传统的版本控制之外,您还可以使用本地历史记录。使用本地历史记录,PyCharm 会自动跟踪您对源代码所做的更改、重构结果等本地历史记录始终处于启用状态。要查看文件或文件夹,请通过选择 **VCS |当地历史(Local History)|显示历史记录(Show History)**。在这里,您可以查看更改、还原更改或创建修补程序。
1.9 数据处理
PyCharm有一个交互式Python控制台,可以通过检查,大括号和引号匹配以及代码完成来动态语法检查来对数据执行智能操作。您还可以从对python的内置支持中受益。使用PyCharm专业版,您可以分析和可视化各种科学和统计数据。Jupyter Notebook 集成支持编辑、执行和调试笔记本源代码,并检查执行输出,包括流数据、图像和其他媒体。
使用PyCharm中安装的R插件,您可以使用R语言执行各种统计计算,并使用编码辅助,可视化调试,智能运行和预览工具以及其他流行的IDE功能。
您可能已经注意到,创建各种类型的项目(例如Django)需要数据源。您也很有可能将SQL语句注入源代码中。PyCharm 专业版不允许您创建数据库,但提供管理和查询数据库的工具。授予对某个数据库的访问权限后,您可以在 PyCharm 中配置一个或多个数据源,以反映数据库的结构并存储数据库访问凭据。根据这些信息,PyCharm建立与数据库的连接,并提供检索或更改其中包含的信息的能力。“数据库”窗口提供对数据库的访问(查看(View )|工具窗口(Tool Windows)|数据库(Database))。此工具窗口允许您使用数据库,允许您查看和修改数据库中的数据结构,并执行其他关联的任务。
有关详细信息,请参阅数据库工具和 SQL。
1.10 自定义IDE
Python开发人员长期以来一直使用各种工具来编写代码。虽然界限模糊,但这些工具分为两大阵营:文本编辑器和集成开发环境(IDE)。文本编辑器,过度简化,专注于单个文件的编辑,提供非常精益和刻薄的体验。IDE:开发环境,IDE具有更广阔的视野,可以查看您的整个项目以及所有与编码相关的活动,并将这些活动统一到一个一致、强大的 UI 中。UI:用户界面您可以随意调整IDE,使其完全满足您的需求,并尽可能有用和舒适。转到文件|设置(PyCharm | Preferences对于macOS 用户)以查看可用自定选项的列表。
1.10.1 外观Appearance
首先通常要微调的是“外观和感觉”。转到文件|设置|外观和行为(Appearance and Behavior)|外观(PyCharm | Preferences | Appearance and Behavior | Appearance 对于macOS 用户)以选择 IDE 主题:浅色主题或Darcula(如果您更喜欢较暗的设置)。
1.10.2 编辑器Editor
在文件|设置|编辑(PyCharm | Preferences | Editor对于macOS用户)下面有许多页面可帮助您调整编辑器性能的各个方面。这里有很多选项,从常规设置(如拖放启用,滚动配置等),到每种可用语言和用例的颜色配置,到选项卡和代码折叠设置,到代码完成行为,甚至后缀模板。有关详细信息,请参阅配置 PyCharm 设置部分。
1.10.3 代码风格Code style
可以在 文件|设置|编辑器|代码样式 File | Settings | Editor | Code Style下为每种语言定义代码样式(PyCharm | Preferences | Editor | Code Style适用于 macOS 用户)。您还可以创建并保存自己的编码风格方案。
有关详细信息,请参阅配置代码样式和代码质量帮助提示和技巧,或如何使代码看起来漂亮?
1.11 键盘映射Keymap — 快捷键
PyCharm 使用以键盘为中心的方法,这意味着 IDE 中几乎所有可能的操作都映射到键盘快捷键。设置快捷键是你工作中的私人习惯 — 你的手指会“记住”某些键组合,改变此习惯说起来容易做起来难。PyCharm 为您提供默认的键盘映射(选择“Help | Keyboard Shortcuts PDF从主菜单)使您的编码真正高效和方便。但是,您始终可以在 File | Settings | Keymap(PyCharm | Preferences | Keymap用于苹果操作系统用户)更改。还有一些预定义的键盘映射(如Emacs, Visual Studio, Eclipse, NetBeans等),您还可以基于现有键盘映射创建自己的键盘映射。如果您觉得 vi/Vim 最有效率,仿真模式将为您提供两全其美的体验,在IDE启动IdeaVim插件选择vim快捷键。有关详细信息,请参阅配置键盘快捷键部分。
1.11.1 常用快捷键
下表列出了一些最有用的快捷方式:
捷径 | 行动 |
---|---|
双Shift | 搜索无处不在在 PyCharm、项目和当前 Git 存储库中快速查找任何文件、操作、类、符号、工具窗口或设置。 |
Ctrl+Shift+A | 查找操作查找命令并执行它,打开工具窗口或搜索设置。 |
Alt+Enter | 显示上下文操作快速修复突出显示的错误和警告,用于改进和优化代码的意图操作。 |
F2Shift+F2 | 在代码问题之间导航跳转到下一个或上一个突出显示的错误。 |
Ctrl+E | 查看最近打开的文件从列表中选择最近打开的文件。 |
Ctrl+WCtrl+Shift+W | 扩展或收缩选择根据特定的代码构造增加或减少选择范围。 |
Ctrl+/Ctrl+Shift+/ | 添加/删除行注释或块注释注释掉一行或代码块。 |
Alt+F7 | 查找用法显示在整个项目中使用代码元素的所有位置。 |
在没有鼠标的情况下调整工具窗口的大小: | 要调整垂直工具窗口的大小请按:Ctrl+Alt+Shift+LeftCtrl+Alt+Shift+Right要调整水平工具窗口的大小请按:Ctrl+Alt+Shift+UpCtrl+Alt+Shift+Down |
1.11.2 弹出菜单Popup menus
弹出菜单提供对与当前上下文相关的操作的快速访问。以下是一些有用的弹出菜单及其快捷方式:
- Alt+Insert打开**“生成(Generate)**”弹出窗口,以便基于上下文生成样板代码。
- Ctrl+Alt+Shift+T打开“**重构(**Refactor )”此弹出窗口,其中包含上下文可用的重构列表。
- Alt+Insert在“项目”工具窗口中打开“新建(New)”弹出窗口,用于向项目添加新文件和目录。
- Alt+` 打开“VCS 操作(VCS Operations)”弹出窗口,其中包含版本控制系统的上下文可用操作。
2、配置PyCharm
2.1 创建新的python项目介绍
纯python项目适用于python编程。项目可帮助您在单个单元中组织源代码、测试、使用的库和个人设置。如果您不需要项目,可以在轻度编辑模式下编辑文件。
要创建项目,请执行下列操作之一:将打开“新建项目”对话框。
- 从主菜单中,选择“文件|新建项目
- 在“欢迎”屏幕上,单击“新建项目”
在“新建项目”对话框中,指定项目名称及其位置。对话框可能因 PyCharm 版本而异。社区和教育专业的
接下来,单击
以展开“Python 解释器(Python Interpreter)”节点,然后单击相应的单选按钮选择新环境或现有解释器。以下步骤取决于您的选择:创建一个 main.py 欢迎脚本:如果您希望 PyCharm 将文件添加到您的项目中,请保持选中此选项。此文件包含一个非常简单的 Python 代码示例,可以作为项目的起点。main.py
新环境使用(New environment using):如果已选择此选项,请选择要用于创建虚拟环境的工具。为此,请单击列表并选择Virtualenv, Pipenv, Poetry, 或 Conda。接下来,指定新虚拟环境的**位置(Location)和基本解释器(Base interpreter)。如果希望将计算机上安装的全局 Python 中的所有包添加到要创建的虚拟环境中,请选中“继承全局站点包(Make available to all projects)”复选框,此复选框–system-site-packages对应于虚拟env工具的选项。如果要在 PyCharm 中创建 Python 解释器时重用此环境,请选中“可供所有项目使用(Make available to all projects)**”复选框。配置基本解释器时,需要指定 Python 可执行文件的路径。如果 PyCharm 在您的计算机上没有检测到任何 Python,它将提供以下选项:
- 指定 Python 可执行文件的路径(在非标准安装的情况下)
- 从 Python.org 下载并安装最新的 Python 版本
- 使用命令行开发工具(仅限 macOS)安装 Python。
**以前配置的解释器(Previously configured interpreter):如果已选择此选项,请从列表中选择所需的解释器,或者(如果未找到所需的解释器),单击“添加解释器(Add Interpreter)**”并选择解释器。有关详细信息,请参阅配置 Python 解释器。当PyCharm停止支持任何过时的Python版本时,相应的Python解释器被标记为不受支持。
创建一个 main.py 欢迎脚本:如果您希望 PyCharm 将文件添加到您的项目中,请保持选中此选项。此文件包含一个非常简单的 Python 代码示例,可以作为项目的起点。main.py
创建项目后,可以继续配置项目结构。
2.2 打开、关闭和删除python项目
打开python项目:
- 打开python项目,请执行下列操作之一:
- 在欢迎屏幕上,单击“打开”链接。
- 从主菜单中,选择文件|打开。
- 在打开的“打开文件”或“项目”对话框中,找到所需项目目录的位置。PyCharm 项目标记为 ,
在其他 IDE 或专用编辑器中创建的项目标记为
。如果选择非 PyCharm 目录,PyCharm 将创建一个新的 IDE 项目并设置一个 Python 解释器。 - 单击“确定”。
关闭python项目:如果只需要关闭一个项目,则可以关闭项目窗口或选择“文件|关闭项目”。如果使用多个项目,请使用下列操作一次关闭多个项目:关闭所有项目
- 从主菜单中,选择“**文件(**File**)|关闭所有项目(**Close All Projects**)”**。此操作将关闭当前在 PyCharm 中打开的所有项目。
关闭除当前项目之外的所有项目
- 从主菜单中,选择**文件(**File**)|关闭其他项目(**Close Other Projects**)**。此操作将关闭除当前项目之外的所有已打开项目。
当您只有一个打开的项目并关闭它时,PyCharm 将显示欢迎屏幕。在多个项目的情况下,每个项目都用其框架关闭。删除python项目:从最近项目列表中删除项目
- 单击“文件(File)”菜单上的“打开最近使用的项目(Open Recent)”,然后单击最近使用的项目列表最底部的“管理项目**(**Manage Projects)”。
- 单击要删除的项目的结束图标。
所选项目将从“项目”窗口和“欢迎”屏幕中最近的项目列表中删除。若要仅从欢迎屏幕上的列表中删除项目,请右键单击目标项目,然后选择“从欢迎屏幕中删除所选内容”。
2.3 配置PyCharm中的Python 解释器和conda
2.3.1 前言:
项目解释器(Project interpreter):File | Settings | Project:
2.3.2 Python 解释器
要在 PyCharm 中使用你的 Python 代码,你需要配置至少一个 Python 解释器。您可以使用 Python 安装中可用的系统解释器。您还可以创建 Virtualenv, Pipenv, Poetry, or Conda 虚拟环境。虚拟环境由基本解释器和已安装的软件包组成。使用 PyCharm 专业版,您还可以配置解释器以在远程环境中执行 Python 代码: SSH, Vagrant, WSL (only for Windows), Docker, and Docker Compose
配置 Python 解释器时,需要指定系统中 Python 可执行文件的路径。因此,在配置Python解释器之前,您需要确保已下载Python并将其安装在系统中,并且您知道它的路径。您可以基于同一个 Python 可执行文件创建多个 Python 解释器。当您需要创建不同的虚拟环境来开发不同类型的应用程序时,这非常有用。例如,您可以创建一个基于 Python 3.10 的虚拟环境来开发 Django 应用程序,并创建另一个基于相同 Python 3.10 的虚拟环境来使用科学库。可以为新项目或当前项目配置Python解释器(您可以创建新的解释器或使用现有的解释器之一)。
2.3.3 设置现有的python解释器
a. 在任何时候,您都可以使用Python解释器选择器或在项目设置(Settings)/首选项(Preferences)中切换Python解释器。b. 使用Python解释器选择器更改 Python 解释器
- Python 解释器选择器位于状态栏上。这是切换Python解释器的最方便,最快捷的方法。只需单击它并选择目标解释器:
c. 在项目设置中更改Python解释器:按Ctrl+Alt+S键打开 IDE 设置,然后选择“项目<项目名称> |python解释器(Project
选择目标解释器:
当PyCharm停止支持任何过时的Python版本时,相应的Python解释器被标记为不受支持。d. 修改python解释器按Ctrl+Alt+S键打开 IDE 设置,然后选择“项目<项目名称> |python解释器(Project
选择目标解释器,然后单击编辑。
您可以为所选解释器指定备用解释器名称。在“名称”字段中指定的 Python 解释器名称在可用解释器列表中可见。单击“确定”以应用更改。
2.3.4 创建一个新的python解释器
a. 向当前项目添加新的解释器:请执行下列操作之一:
- 单击 [Python 解释器选择器](https://www.jetbrains.com/help/pycharm/configuring-python-interpreter.html#widget),然后选择**添加新解释器**。
- 按键打开项目**设置/首选项**,然后转到**项目:<项目名称> |python解释器**。单击可用**解释器**列表旁边的添加解释器链接。Ctrl+Alt+S
选择要添加并执行特定设置的解释器类型。对于虚拟环境和系统解释器,请选择“添加本地解释器”。对于远程解释器,请选择特定类型。b. 设置默认解释器在PyCharm中,您可以指定一个解释器,该解释器将自动为所有新创建的项目设置:
- 从主菜单中,选择文件|新建项目设置|新项目(windows和 Linux 上)或文件|的设置新建项目设置|“新项目”的偏好设置(在 macOS 上)。
- 选择“Python解释器设置”。然后从 Python 解释器列表中选择一个现有的解释器,单击
以添加新的解释器。单击“确定”保存更改。此更改将对 PyCharm 中所有新创建的项目生效。
2.3.5 Conda 环境配置:
a. 确保已下载并安装 Anaconda 或 Miniconda,并且您知道其可执行文件的路径。有关更多详细信息,请参阅安装说明。b. 请执行下列操作之一:
- 单击 Python 解释器选择器,然后选择添加新解释器。
- 按键Ctrl+Alt+S打开项目设置/首选项,然后转到项目:<项目名称> |python解释器。单击可用解释器列表旁边的添加解释器链接。
c. 从可用解释器类型列表中选择“添加本地解释器”。
d. 在“添加 Python 解释器(Add Local Interpreter)”对话框的左侧窗格中,选择“Conda 环境”。以下操作取决于 Conda 环境以前是否存在。
e. 如果选择了“新建虚拟(New Virtualenv)”:如果从解释器列表中选择任何现有的虚拟环境,则该虚拟环境将重新用于当前项目。
- 在文本字段中指定新 Conda 环境的位置,或单击
并查找文件系统中的位置。请注意,新 Conda 环境应位于的目录必须为空! - 从列表中选择 Python 版本。
- 在文本字段中指定 Conda 可执行文件的位置,或在 Conda 安装目录中单击
并查找位置。您基本上是在寻找在计算机上安装Conda时使用的路径。 - 如果要在 PyCharm 中创建 Python 解释器时重用此环境,请选中“可供所有项目使用”复选框。
- 单击“确定”完成任务。
有关更多详细信息,请参阅配置 Conda 虚拟环境。
2.4 安装、卸载和升级软件包
PyCharm 为特定的 Python 解释器提供了安装、卸载和升级 Python 包的方法。默认情况下,PyCharm 使用 pip 来管理工程包。对于 Conda 环境,您可以使用 conda 包管理器。在 PyCharm 中,您可以在 Python 包工具窗口和 Python 解释器设置/首选项中预览和管理包。
2.4.1 在 Python工具窗口中管理包
Python 工具窗口提供了最快、最简洁的方式来预览和安装当前选定的 Python 解释器的包。默认情况下,此窗口处于启用状态,您可以在工具窗口的下一组中找到它。您可以随时使用主菜单打开它:查看|工具窗口|python包(View | Tool Windows | Python Packages)。Python 工具窗口显示已安装的包和 PyPI 存储库中可用的包。使用“搜索”字段筛选出可用包的列表。
您可以在文档区域中预览包文档,也可以单击“**文档(Documentation)**”链接并在浏览器中打开相应的资源。要删除已安装的软件包,请单击
Python 软件包工具窗口的右上角。
2.4.1.1 从存储库安装包
开始在 Python 工具窗口的“搜索”字段中键入包名称。您应该能够看到匹配包的数量。
展开工具窗口右上角的可用版本列表。选择所需的版本或将其保留为最新版本。单击版本列表旁边的**安装(Install)**按钮。一旦 PyCharm 通知您安装成功,您应该会在已安装软件包的列表中看到该软件包。
如果需要,请单击
并提供要从中安装的任何自定义存储库的路径。
2.4.1.2 管理存储库包
要指定自定义存储库(包括开发
或 PyPi
),请单击“
Python Packages”工具栏。
在“Python 包存储库(Python Packages Repositories)”对话框中,单击
以添加新的存储库。如果不需要授权(例如,对于本地存储库),请输入目标 URL 并单击“确定”。
如果要从需要 HTTP 授权的存储库安装 Python 包,请单击“基本(Basic) HTTP”,然后输入存储库 URL 和登录凭据。单击“确定”完成任务。
添加存储库后,它将出现在 Python 包工具窗口的存储库列表中。
2.4.2 在 Python 解释器设置中管理包
若要管理 Python 解释器的 Python 包,请在项目“设置/首选项”中选择“Python 解释器”页,或在状态栏上的“Python 解释器”选择器中选择“解释器设置”。
如果选择具有已配置的 Conda 环境的 Python 解释器,则“使用 Conda 包管理器( Use Conda Package Manager )”开关将显示在包区域工具栏中。
使用此开关可以管理 Conda 环境存储库中的包。默认情况下,此切换对于 Conda 环境处于启用状态。
2.4.3 安装软件包
a. 单击
按钮在包工具栏上:
b. 在打开可用包(Available Packages)对话框中,预览可用包的列表,并在“搜索”框中输入要安装的包名称。
c. 如果需要,请选中以下复选框:指定版本(Specify version):如果选中此复选框,则可以从可用版本列表中选择所需的版本。默认情况下,采用最新版本。选项(Options):如果选中此复选框,则可以在文本栏中输入pip install命令行选项。安装到用户的站点包目录
2.4.4 卸载软件包
在包列表中,选择要删除的包,单击卸载 (
)。选定的包将从磁盘中删除。PyCharm 通过显示当前安装的软件包版本(版本列)和最新可用版本(最新版本列)的数量,智能地跟踪包的状态并识别过时的版本。当检测到软件包的较新版本时,PyCharm会用箭头符号
标记它并建议升级它。默认情况下,“最新版本”列仅显示包的稳定版本。如果要将最新可用版本的范围扩展到任何预发布版本(如 Beta 版或候选版本),请单击“显示早期版本”。
2.4.5 升级软件包
在包列表中,选择要升级的包。单击升级 (
)。
选定的包将升级到最新的可用版本。单击“确定”完成升级。您可以一次升级多个包。按住 Cmd (macOS) 或 Ctrl (Unix 或 Windows),左键单击以选择程序包列表中的多个项目,然后单击“升级”。
2.4.6 命令行安装包
如果您习惯于从命令行安装程序包,则可以使用“终端”继续执行工作流。重用已安装的软件包
创建新的虚拟环境并安装要在其他项目中使用的包。然后,您可以将此虚拟环境指定为目标项目的 Python 解释器,并且所有需要的包都将可用。
在“终端”窗口中,执行以下命令:
1
pip freeze > requirements.txt
然后将创建的文件requirements.txt添加到目标项目,PyCharm将提示您安装文件中列出的软件包。