PyCharm创建新项目完全指南一步步教你搭建Python开发环境

2026-01-18 01:40:04 装备掉落 6809

引言

PyCharm是由JetBrains公司开发的一款功能强大的Python集成开发环境(IDE)，它提供了智能代码编辑、代码分析、图形化调试器以及集成版本控制系统等功能。无论是Python初学者还是专业开发者，PyCharm都能提供高效的开发体验。本指南将详细介绍如何使用PyCharm创建新项目并搭建完整的Python开发环境，帮助你快速上手这一强大的开发工具。

PyCharm安装指南

在创建新项目之前，首先需要安装PyCharm。PyCharm有两个版本：专业版(Professional)和社区版(Community)。社区版是免费的，适合纯Python开发；专业版是付费的，提供了Web开发、数据库工具等额外功能。

下载PyCharm

访问PyCharm官方网站：https://www.jetbrains.com/pycharm/

点击”Download”按钮

根据你的操作系统选择相应的版本（Windows、macOS或Linux）

选择社区版(Community)或专业版(Professional)进行下载

安装步骤

Windows系统安装：

双击下载的安装文件（.exe）

在安装向导中点击”Next”

选择安装路径，默认路径通常即可，点击”Next”

在安装选项页面，建议勾选以下选项：

Create Desktop Shortcut（创建桌面快捷方式）

Update PATH variable (restart needed)（更新PATH变量）

Update context menu（更新右键菜单）

Create Associations（创建文件关联）

点击”Next”，然后点击”Install”开始安装

安装完成后，点击”Finish”结束安装

macOS系统安装：

打开下载的.dmg文件

将PyCharm拖拽到Applications文件夹

在Applications文件夹中找到PyCharm，双击打开

如果出现安全提示，右键点击PyCharm，选择”Open”，然后点击”Open”确认

Linux系统安装：

解压下载的.tar.gz文件到目标目录

进入bin目录：cd pycharm-*/bin

运行pycharm.sh脚本：./pycharm.sh

可选：创建桌面快捷方式以便快速访问

PyCharm首次启动和基本配置

首次启动

双击PyCharm图标启动应用程序

首次启动时，会显示导入设置的对话框，如果你是第一次使用，选择”Do not import settings”

阅读并同意JetBrains隐私政策

根据提示进行UI主题和其他基本设置的选择

基本配置

外观设置：

通过File > Settings > Appearance & Behavior > Appearance可以调整主题、字体大小等

PyCharm提供了Darcula（深色）和IntelliJ Light（浅色）两种主题

编辑器设置：

通过File > Settings > Editor > General可以配置编辑器行为

通过File > Settings > Editor > Font可以调整编辑器字体和大小

通过File > Settings > Editor > Color Scheme可以自定义语法高亮

版本控制设置：

通过File > Settings > Version Control可以配置Git、SVN等版本控制系统

确保Git路径正确配置，以便后续使用版本控制功能

创建新项目的详细步骤

现在，我们进入本指南的核心部分：创建一个新的Python项目。

步骤1：启动PyCharm并选择创建新项目

启动PyCharm

在欢迎界面，点击”New Project”按钮

如果已经打开了其他项目，可以通过File > New Project来创建新项目

步骤2：配置项目基本信息

在”New Project”对话框中，需要配置以下基本信息：

项目名称和位置：

Name：输入项目名称，例如”my_python_project”

Location：选择项目存储位置，系统会自动在指定位置创建一个与项目名称同名的文件夹

项目类型：

Pure Python：纯Python项目

Django：Web框架项目

Flask：轻量级Web框架项目

Google App Engine：Google云平台项目

Pyramid：另一个Web框架项目

Web2Py：全栈Web框架项目

Ansible：自动化工具项目

Cookiecutter：基于模板的项目

对于初学者，选择”Pure Python”即可。

步骤3：配置Python解释器

Python解释器是执行Python代码的核心组件，正确配置解释器至关重要。

新建项目解释器：

在”New Project”对话框中，找到”Python Interpreter”部分

默认情况下，PyCharm会创建一个新的虚拟环境，这是推荐的做法

“New environment using”选项允许你选择虚拟环境工具：

Virtualenv：Python官方推荐的虚拟环境工具

Conda：Anaconda发行版的虚拟环境工具，适合数据科学项目

Pipenv：现代Python依赖管理工具

Poetry：另一个现代Python依赖管理和打包工具

选择基础解释器：

在”Base interpreter”下拉菜单中，选择已安装的Python解释器

如果列表中没有你需要的解释器，可以点击”…“按钮手动添加解释器路径

使用系统解释器：

如果不想使用虚拟环境，可以选择”Previously configured interpreter”

然后从列表中选择一个已存在的解释器，或点击”…“添加新的解释器

步骤4：配置项目结构（可选）

在”New Project”对话框的底部，可以配置一些额外的项目结构选项：

Create a main.py welcome script：

勾选此项，PyCharm会在项目中创建一个简单的main.py文件

这个文件包含一个基本的”Hello World”程序，适合初学者

Create git repository：

勾选此项，PyCharm会在项目创建后初始化一个Git仓库

这对于版本控制非常有用，特别是对于团队协作项目

步骤5：创建项目

完成上述配置后，点击”Create”按钮，PyCharm将开始创建项目。创建过程可能需要一些时间，具体取决于项目类型和配置。

项目创建完成后，PyCharm会打开项目主界面，你将看到项目结构、编辑器和其他工具窗口。

项目解释器和虚拟环境配置

项目创建后，你可能需要进一步配置Python解释器和虚拟环境。

查看和修改项目解释器

通过File > Settings > Project: [项目名称] > Python Interpreter可以查看和修改当前项目的解释器

在Python Interpreter页面，你可以看到：

当前选择的解释器

已安装的包列表

包的版本信息

添加新的解释器

如果需要添加新的解释器，可以按照以下步骤操作：

在Python Interpreter页面，点击齿轮图标

选择”Add…”

在弹出的对话框中，有几种添加解释器的选项：

System Interpreter：添加系统中已安装的Python解释器

Virtualenv Environment：创建新的Virtualenv环境

Conda Environment：创建新的Conda环境

Pipenv Environment：使用Pipenv创建环境

Poetry Environment：使用Poetry创建环境

Docker：使用Docker容器作为解释器

SSH Interpreter：使用远程服务器上的解释器

WSL Interpreter：使用Windows Subsystem for Linux中的解释器

管理包

在Python Interpreter页面，你可以管理项目所需的Python包：

安装新包：

点击”+“按钮

在搜索框中输入包名

选择包并指定版本（可选）

点击”Install Package”按钮

升级包：

在包列表中选择要升级的包

点击向上箭头图标

确认升级

卸载包：

在包列表中选择要卸载的包

点击”-“按钮

确认卸载

使用requirements.txt：

点击”requirements.txt”风格的依赖管理按钮

可以从requirements.txt文件安装所有依赖

也可以将当前环境中的依赖导出到requirements.txt文件

虚拟环境详解

虚拟环境是Python开发中的最佳实践，它允许你为每个项目创建独立的Python环境，避免包版本冲突。

Virtualenv环境

Virtualenv是Python中最常用的虚拟环境工具：

创建Virtualenv环境：

# 在终端中执行

virtualenv myenv

激活Virtualenv环境：

Windows:

myenv\Scripts\activate

macOS/Linux:

source myenv/bin/activate

停用Virtualenv环境：

deactivate

Conda环境

Conda是Anaconda发行版的一部分，特别适合数据科学项目：

创建Conda环境：

conda create --name myenv python=3.9

激活Conda环境：

conda activate myenv

停用Conda环境：

conda deactivate

Pipenv环境

Pipenv是现代Python项目的依赖管理工具：

安装Pipenv：

pip install pipenv

创建Pipenv环境：

pipenv shell

安装包：

pipenv install package_name

生成requirements.txt：

pipenv lock -r > requirements.txt

项目结构和基本设置

了解PyCharm的项目结构和基本设置对于高效开发至关重要。

项目结构

PyCharm项目通常包含以下主要部分：

项目根目录：

包含项目的主要文件和文件夹

通常包括源代码、资源文件、配置文件等

.idea目录：

PyCharm的项目配置目录

包含工作空间设置、运行配置等

通常应该添加到.gitignore文件中，不纳入版本控制

源代码目录：

存放Python源代码文件

可以创建多个包和模块

资源目录：

存放非代码资源，如图片、配置文件等

可以根据项目需求自定义结构

测试目录：

存放测试代码

通常命名为”tests”或”test”

标记目录

在PyCharm中，你可以将目录标记为特定类型，以便获得相应的功能支持：

Sources Root：

标记为源代码根目录

这些目录中的文件会被视为项目的一部分

导入时会获得代码补全和错误检查

Tests Root：

标记为测试根目录

这些目录中的文件会被视为测试代码

可以方便地运行和调试测试

Resources Root：

标记为资源根目录

这些目录中的文件会被视为项目资源

在打包时会包含在内

Excluded：

标记为排除目录

这些目录中的文件不会被索引，不会出现在搜索结果中

适用于临时文件、构建输出等

要标记目录，右键点击目录，选择”Mark Directory as”，然后选择相应的类型。

项目设置

通过File > Settings可以访问项目设置，以下是一些常用的设置类别：

Project Structure：

配置项目结构

标记目录类型

设置输出路径

Modules：

配置项目模块

设置依赖关系

配置SDK

Facets：

配置项目框架支持

如Web框架、Django等

SDKs：

管理Python SDK

添加、删除和配置解释器

文件模板

PyCharm允许你创建和使用文件模板，以便快速创建具有预定义内容的文件：

访问文件模板设置：

File > Settings > Editor > File and Code Templates

常用文件模板：

Python Script：Python脚本模板

HTML File：HTML文件模板

Python Unit Test：Python单元测试模板

创建自定义模板：

在Templates标签页中，点击”+“按钮

输入模板名称、扩展名和内容

可以使用预定义变量，如\({NAME}、\){USER}等

使用模板：

右键点击项目目录

选择New，然后选择相应的模板类型

运行和调试配置

在PyCharm中，你可以创建和管理运行/调试配置，以便轻松运行和调试代码。

创建运行配置

基本运行配置：

打开Python文件

右键点击编辑器区域

选择”Run ‘文件名’”

PyCharm会自动创建一个基本的运行配置

手动创建运行配置：

点击工具栏中的运行配置下拉菜单

选择”Edit Configurations…”

点击”+“按钮

选择”Python”

配置运行参数：

Name：配置名称

Script path：要运行的Python文件路径

Parameters：命令行参数

Working directory：工作目录

Python interpreter：Python解释器

Environment variables：环境变量

Django/Flask运行配置：

对于Web框架项目，PyCharm提供了专门的运行配置类型

选择”Django Server”或”Flask Server”

配置相应的参数，如主机、端口等

调试配置

调试配置与运行配置类似，但提供了额外的调试选项：

设置断点：

在代码行号左侧点击，设置断点

断点会显示为红色圆点

启动调试：

点击工具栏中的调试按钮（虫子图标）

或右键点击文件，选择”Debug ‘文件名’”

调试控制：

程序会在断点处暂停

使用调试工具栏控制执行：

Resume Program (F9)：继续执行

Step Over (F8)：跳过当前行

Step Into (F7)：进入函数

Force Step Into (Alt+Shift+F7)：强制进入函数

Step Out (Shift+F8)：跳出函数

Run to Cursor (Alt+F9)：运行到光标处

查看变量：

在Variables窗口中查看当前变量值

可以在Watches窗口中添加表达式监视

评估表达式：

在调试过程中，可以评估表达式

使用Alt+F8打开评估表达式对话框

或在Variables窗口中右键点击变量，选择”Evaluate Expression”

测试配置

PyCharm支持多种Python测试框架，如unittest、pytest和nose：

创建测试配置：

点击工具栏中的运行配置下拉菜单

选择”Edit Configurations…”

点击”+“按钮

选择”Python tests”，然后选择测试框架：

Unittests

Pytest

Nosetests

配置测试参数：

Target：要运行的测试（测试类、测试方法或整个目录）

Pattern：测试文件名模式

Python interpreter：Python解释器

运行测试：

右键点击测试文件或测试方法

选择”Run ‘测试名称’”

或使用创建的测试配置

查看测试结果：

测试运行后，会在Run窗口中显示结果

可以查看通过的测试、失败的测试和错误信息

常用插件推荐

PyCharm的功能可以通过插件进行扩展，以下是一些常用的插件推荐：

代码质量和风格

SonarLint：

实时检测代码质量问题

提供修复建议

支持多种编程语言

CodeGlance：

在编辑器右侧显示代码缩略图

类似于Sublime Text的Minimap

方便快速导航

String Manipulation：

提供字符串操作功能

如切换大小写、排序、编码转换等

版本控制

GitToolBox：

增强Git集成

显示行内Blame信息

提供状态栏信息

GitLab Integration：

集成GitLab功能

支持Merge Request、Issues等

GitHub：

集成GitHub功能

支持Gists、Pull Requests等

开发工具

Markdown：

提供Markdown编辑和预览功能

支持语法高亮和表格编辑

Key Promoter X：

帮助学习快捷键

当使用鼠标操作时，提示相应的快捷键

.env files support：

支持.env文件

提供语法高亮和自动补全

数据库和Web开发

Database Navigator：

数据库管理工具

支持多种数据库类型

提供SQL编辑和执行功能

RESTfulToolbox：

REST API开发工具

提供API测试和文档生成功能

Swagger：

支持OpenAPI/Swagger规范

提供API文档编辑和预览

安装插件

要安装插件，按照以下步骤操作：

打开插件设置：

File > Settings > Plugins

浏览插件：

在Marketplace标签页中，可以浏览和搜索插件

在Installed标签页中，可以查看已安装的插件

在Updates标签页中，可以查看可用更新

安装插件：

找到想要的插件

点击”Install”按钮

安装完成后，重启PyCharm

管理插件：

可以启用、禁用或卸载已安装的插件

可以从磁盘安装插件

高级技巧和最佳实践

掌握一些高级技巧和最佳实践可以显著提高你的开发效率：

代码编辑技巧

实时模板：

使用预定义的代码模板快速插入常用代码块

输入缩写后按Tab键展开模板

例如，输入”main”后按Tab键，会插入if __name__ == '__main__':代码块

后缀补全：

在表达式后输入点(.)，然后使用后缀补全

例如，my_list.var会转换为var = my_list

其他后缀包括.if、.for、.return等

多光标编辑：

按住Alt键点击多个位置，创建多个光标

可以同时编辑多个位置的代码

适用于批量修改

列选择模式：

按住Alt+Shift键拖动鼠标，可以进行列选择

适用于编辑表格或对齐的文本

导航技巧

快速导航：

Ctrl+N：快速查找类

Ctrl+Shift+N：快速查找文件

Ctrl+Alt+Shift+N：快速查找符号

Ctrl+Shift+A：快速查找动作

声明和用法导航：

Ctrl+B：跳转到声明

Ctrl+Alt+B：跳转到实现

Ctrl+U：跳转到超类方法

Alt+F7：查找用法

书签：

F11：添加/移除书签

Shift+F11：显示所有书签

Ctrl+数字：添加带数字的书签

Ctrl+数字：跳转到带数字的书签