PyCharm官方要求最低配置为:4GB RAM(推荐8GB以上)、2GB可用磁盘空间、64位操作系统(Windows 10/11、macOS 12+、Linux Ubuntu 20.04+)。在Windows系统中,若使用WSL2开发,需确保开启Hyper-V并分配至少4GB内存。
特别注意:PyCharm Professional版支持Docker集成与远程开发,社区版仅限本地开发。若需运行Flask/Django项目,建议选择Professional版(30天免费试用期)。
在运行pycharm运行python程序前,必须确保系统已安装Python解释器。推荐使用python.org官方版本,当前稳定版为Python 3.12.3(截至2025年4月)。
验证步骤:
① 打开终端(Windows:cmd/PowerShell;macOS/Linux:Terminal)
② 输入命令:python --version 或 python3 --version
③ 正确输出应为:Python 3.12.3
若提示“不是内部或外部命令”,请检查:
• Windows:将Python安装路径(如C:\Python312\)添加至系统环境变量PATH
• macOS:使用Homebrew安装:brew install python3
• Linux:使用包管理器:sudo apt install python3
下载PyCharm后,安装过程无特殊要求。首次启动时会引导配置:
Dark(深色模式)以减少视觉疲劳~/.PyCharmCE2024.1)File → Settings → Project: <项目名> → Python Interpreter在解释器配置界面,推荐选择以下三种方式之一:
python可执行文件路径→ Create Virtualenv,设置位置如.venv目录创建虚拟环境命令:
python -m venv .venv
激活命令:
• Windows:.venv\Scripts\activate
• macOS/Linux:source .venv/bin/activate
在PyCharm中新建项目流程:
New ProjectEmpty Project(空项目)或Flask/Django(框架模板)D:\projects\py-demo)Create创建完成后,在Project面板右键→ New → Python File,输入文件名如main.py。
编写基础代码:
def hello(name: str) -> str:
"""返回问候语"""
return f"Hello, {name}!"
if __name__ == "__main__":
print(hello("开发者"))
点击右上角绿色▶️按钮运行,或使用快捷键Ctrl+Shift+F10(Windows/Linux)或Ctrl+Shift+R(macOS)。
为提升效率,建议为常用脚本创建专属运行配置:
→ Edit Configurations...+添加新配置,选择Pythonmain.pymain.py路径DEBUG=TrueApply并OK配置后,可在运行下拉菜单中快速选择该配置,无需每次都指定脚本。
More,设置条件如i > 10 and x % 2 == 0Run → View Breakpoints中勾选Any exception调试时,在Watches面板添加表达式:
len(data_list)
user.name.upper()
time.time() - start_time
支持实时修改变量值(右键变量→Set Value...),但需注意:
• 仅支持基本类型(int、str、list等)
• 修改后需继续运行才能生效
• 多线程场景下可能导致数据不一致
当程序暂停时,Frames面板显示调用堆栈。点击不同帧可切换当前作用域,查看对应变量值。
典型调试场景:
1. 程序卡死 → 查看当前执行行
2. 抛出异常 → 检查异常发生前的变量状态
3. 递归函数 → 分析每层调用的参数变化
适用于调试服务器端程序(如Django应用):
pydevd-pycharm:pip install pydevd-pycharm~=241.14494.24Run → Edit Configurations → + → Python Remote DebugOK后,复制生成的启动代码到服务器脚本:import pydevd_pycharm
pydevd_pycharm.settrace('127.0.0.1', port=8000, stdoutToServer=True, stderrToServer=True)原因:Python解释器未找到模块。常见于:
• 虚拟环境未激活
• 模块未安装到当前环境
• 项目路径未添加至PYTHONPATH
解决方案:
① 检查解释器:File → Settings → Project → Python Interpreter确认路径
② 安装模块:pip install requests(在PyCharm Terminal中执行)
③ 添加源码根目录:右键项目根目录 → Mark Directory As → Sources Root
常见于:
• Python 2与3语法混用(如print "Hello")
• 缩进错误(混用Tab与空格)
• 未闭合引号或括号
PyCharm自动检测:
• 编辑时红色波浪线提示
• 代码检查:Code → Inspect Code
修复建议:
• 启用Settings → Editor → Code Style → Python → Use tab character设为False
• 使用Code → Reformat Code统一缩进
典型场景:
• 循环导入(A.py导入B.py,B.py导入A.py)
• 模块路径冲突(如项目名与标准库同名)
• 包内__init__.py缺失
解决方案:
1. 重构代码避免循环依赖(引入中间模块)
2. 重命名项目避免与标准库冲突
3. 确保每个包目录含__init__.py(即使为空)
表示尝试对None使用下标操作(如result[0]),常见于:
• 函数未显式返回值
• 字典键不存在(dict.get('key')返回None)
• 网络请求失败未处理
防御性编程示例:
def get_user_data(user_id: int) -> dict | None:
# 模拟数据库查询
data = {"id": user_id, "name": "张三"}
return data if user_id > 0 else None
user = get_user_data(1)
if user: # 先检查是否为None
print(user["name"])
else:
print("用户不存在")
递归深度超过限制(默认1000层)。常见于:
• 无限递归(缺少终止条件)
• 数据量过大超出栈空间
解决方案:
1. 检查递归终止条件是否满足
2. 改用迭代算法(如循环)
3. 谨慎调整递归深度限制:
import sys(仅临时方案)
sys.setrecursionlimit(2000)
安装路径:Settings → Plugins → Marketplace
操作步骤:
1. 搜索插件名
2. 点击Install按钮
3. 重启PyCharm生效
管理插件:
• 启用/禁用:勾选/取消勾选
• 更新:点击Update按钮
• 卸载:点击Uninstall
安装pytest:
pip install pytest pytest-cov
创建测试文件test_main.py:
import pytest
from main import hello
def test_hello():
assert hello("世界") == "Hello, 世界"
def test_hello_empty():
with pytest.raises(TypeError):
hello()
运行测试:
① 在代码编辑区右键Run 'pytest in test_main.py'
② 使用Alt+Enter快速运行当前测试
配置pytest.ini:
[pytest]
addopts = --cov=. --cov-report=html:coverage_report --cov-report=term-missing
运行后生成coverage_report/index.html,在PyCharm中打开可查看覆盖率热力图。
使用@pytest.mark.parametrize:
@pytest.mark.parametrize("name,expected", [
("张三", "Hello, 张三"),
("李四", "Hello, 李四"),
("", "Hello, ")
])
def test_hello_param(name, expected):
assert hello(name) == expected
测试结果以表格形式展示,便于定位失败用例。
tmp_path fixture创建临时目录requests-mock模拟HTTP响应freezegun冻结时间pytest-asyncio处理异步操作步骤:
1. 确保requirements.txt完整:
pip freeze > requirements.txt
2. 使用pyinstaller打包:
pip install pyinstaller
pyinstaller --onefile --windowed main.py
3. 在dist/目录获取可执行文件
注意:
• Windows生成.exe需在Windows环境打包
• macOS生成.app需在macOS环境打包
• 跨平台打包需用Docker容器
创建Dockerfile:
FROM python:3.12-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
COPY . .
CMD ["python", "main.py"]
构建镜像:
docker build -t py-app .
运行容器:
docker run -p 8000:8000 py-app
阿里云ECS:
1. 上传代码至服务器
2. 安装Python与依赖
3. 使用systemd管理进程:
/etc/systemd/system/pyapp.service
[Unit]
Description=Python App
After=network.target
[Service]
User=www-data
WorkingDirectory=/var/www/pyapp
ExecStart=/usr/bin/python /var/www/pyapp/main.py
Restart=always
[Install]
WantedBy=multi-user.target
使用GitHub Actions示例:
name: Deploy to Server
on: [push]
jobs:
deploy:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Set up Python
uses: actions/setup-python@v5
with:
python-version: '3.12'
- name: Install dependencies
run: pip install -r requirements.txt
- name: Run tests
run: pytest
- name: Deploy via SSH
uses: appleboy/ssh-action@v1.0.3
with:
host: ${{ secrets.HOST }}
username: deploy
key: ${{ secrets.SSH_KEY }}
script: |
cd /var/www/pyapp
git pull origin main
pip install -r requirements.txt
systemctl restart pyapp
Git分支策略:
• main:生产环境稳定版本
• develop:集成测试分支
• feature/*:新功能开发
• hotfix/*:紧急修复
PyCharm操作:
1. 创建分支:Git → New Branch
2. 合并分支:Git → Merge Branch
3. 解决冲突:右键文件 → Resolve Conflicts
使用GitHub Pull Request:
1. 提交前运行代码检查:Code → Inspect Code
2. 提交时填写详细描述:
• 修改内容
• 测试结果
• 潜在风险
3. 评审要点:
• 功能正确性
• 代码可读性
• 性能影响
• 安全隐患
方案1:虚拟环境导出
pip freeze > requirements.txt
团队成员安装:
pip install -r requirements.txt
方案2:Docker Compose
docker-compose.yml:
version: '3'
services:
app:
build: .
volumes:
- .:/app
ports:
- "8000:8000"
使用pylint与flake8:
pip install pylint flake8Settings → Tools → External ToolsPylintpylint$FileName$$ProjectFileDir$Code → Reformat Code(需配置black或autopep8)