# python-project-runner

**Repository Path**: wagio_admin/python-project-runner

## Basic Information

- **Project Name**: python-project-runner
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-14
- **Last Updated**: 2025-10-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Python Project Runner

一个简单实用的VSCode插件，让你可以通过状态栏按钮一键启动和停止Python项目。

## 功能特性

- 🚀 **一键启动**: 在VSCode底部状态栏显示启动/停止按钮
- ⚡ **快速切换**: 点击按钮即可启动或停止Python脚本
- 📊 **实时状态**: 按钮会根据运行状态自动更新显示
- 🛠️ **完全可配置**: 支持自定义Python路径、脚本路径和工作目录
- 💻 **跨平台支持**: 支持Windows、macOS和Linux系统

## 使用方法

### 1. 安装插件
在VSCode扩展商店搜索"Python Project Runner"并安装。

### 2. 配置设置
打开VSCode设置（`Ctrl+,` 或 `Cmd+,`），搜索"Python Project Runner"，配置以下选项：

- **Python Path**: Python可执行文件路径（如：`python`、`python3` 或完整路径）
- **Script Path**: 要运行的Python脚本完整路径（必填）
- **Working Directory**: 脚本运行的工作目录（可选，默认使用脚本所在目录）

### 3. 开始使用
1. 配置完成后，VSCode底部状态栏右侧会显示 "▶ Start Python" 按钮
2. 点击按钮启动你的Python项目
3. 运行时按钮变为 "⏹ Stop Python"，再次点击可停止运行

## 配置示例 在.vscode\settings.json 文件中添加如下配置

```json
{
  "pythonRunner.pythonPath": "python",
  "pythonRunner.scriptPath": "/path/to/your/script.py",
  "pythonRunner.workingDirectory": "/path/to/working/directory"
}
```

## 适用场景

- 🌐 **Web开发**: 快速启动Flask、Django等Web服务器
- 🤖 **自动化脚本**: 一键运行数据处理、爬虫等脚本
- 🎮 **游戏开发**: 启动游戏服务器或测试脚本
- 📊 **数据分析**: 运行Jupyter、数据分析脚本

## 系统要求

- VSCode 1.74.0 或更高版本
- Python 环境（任意版本）

## 许可证

MIT License