Python 环境安装及项目构建指南

一、Python 环境管理

1. Python 版本管理工具 - pyenv

安装 pyenv（Windows 11）

下载后运行安装命令：

powershell 复制代码

# 例如：安装到 d:\soft 目录下
.\install-pyenv-win.ps1 d:\soft

# 例如：安装到当前目录下
.\install-pyenv-win.ps1

验证安装是否成功

powershell 复制代码

# 1. 退出当前的 PowerShell 窗口
# 2. 重新打开一个 PowerShell 命令窗口，以便环境变量生效
# 3. 安装 Python（如已自带公司版本可跳过）
pyenv install 3.12
pyenv install 3.10

# 4. 指定 Python 默认版本
pyenv global 3.12

# 5. 验证是否成功
pyenv versions

成功显示示例：

复制代码

  3.10.11
* 3.12.10 (set by d:\share\temp\pyenv\pyenv-win\version)

pyenv 常用命令

命令	功能	示例
`pyenv install <version>`	新安装对应版本 Python	`pyenv install 3.12`
`pyenv global <version>`	设置全局默认 Python 版本	`pyenv global 3.12`
`pyenv local <version>`	设置当前目录使用的版本（创建.python-version 文件）	`pyenv local 3.10`
`pyenv versions`	查看已安装版本（带星号*为当前激活版本）	`pyenv versions`
`pyenv version`	查看当前目录使用的 Python 版本	`pyenv version`

安装 Python

powershell 复制代码

# 安装 Python 3.12 最新版
pyenv install 3.12

# 安装 Python 3.12.4 版本
pyenv install 3.12.4

说明： 公司版本已打包了 Python 3.12 和 Python 3.10 两个版本，可以跳过该步骤。

验证 Python 安装成功

powershell 复制代码

# 1. 打开 PowerShell
# 2. 运行 python
python

# 3. 输入以下代码测试
>>> print("hello world")

# 4. 退出
>>> quit()

2. Python 依赖管理工具 - uv

前提： 建议先安装 Git 版本控制工具

安装 uv（Windows 11）

powershell 复制代码

# 安装到 d:\soft 目录下
.\install-uv-win.ps1 d:\soft

# 安装到当前目录下
.\install-uv-win.ps1

验证安装是否成功

powershell 复制代码

# 1. 退出当前的 PowerShell 窗口
# 2. 重新打开一个 PowerShell 命令窗口，以便环境变量生效
# 3. 运行以下命令
uv --version

uv 常用命令

命令	说明	示例
`uv venv`	创建虚拟环境（默认在当前目录生成 .venv，自动检测当前激活的 Python 版本）	`uv venv` `uv venv --python 3.12`
`uv pip install <pkg>`	在激活的虚拟环境中安装包（兼容传统 pip 工作流）	`uv pip install requests` `uv pip install -r requirements.txt`
`uv add <pkg>`	添加依赖并更新 pyproject.toml（现代替代 pip install）	`uv add requests` `uv add "flask>=2.3"`
`uv add --dev <pkg>`	添加开发依赖	`uv add --dev pytest`
`uv sync`	安装 pyproject.toml 中所有依赖（替代 poetry install）	`uv sync`
`uv run <command>`	在虚拟环境中执行命令（无需手动激活环境）	`uv run python app.py` `uv run pytest`

二、Python 开发工具 - VS Code

1. 安装 VS Code

下载页面： https://code.visualstudio.com/Download

加速提示： 若下载过慢，可将下载路径中的 az764295.vo.msecnd.net 更换为 vscode.cdn.azure.cn 使用国内镜像服务器加速。

2. 创建 Python 工程

powershell 复制代码

# 1. 创建工程目录
mkdir py_test
cd py_test

# 2. 初始化工程
uv init

# 3. 创建 Python 虚拟环境
uv venv

# 4. 进入虚拟环境
.venv\Scripts\activate

# 5. 打开 VS Code 编辑器
code .

3. VS Code 使用指南

首次使用配置

第一次编辑 Python 文件时，会提示安装 Python 插件等，同意即可
中文语言包： 在插件市场中搜索 Chinese (Simplified) (简体中文) Language Pack for Visual Studio Code，安装后重启 VS Code

运行 Python 代码

选中要运行的 Python 文件
点击文件右上角的三角箭头即可运行

调试 Python 代码

展开运行的三角箭头
选择调试选项即可

其他功能

安装插件： 通过左侧扩展图标进入插件市场搜索安装
其他使用问题： 可根据需要自行查询学习

三、快速入门流程

完整的环境搭建流程：

powershell 复制代码

# 1. 安装 pyenv
.\install-pyenv-win.ps1

# 2. 安装 uv
.\install-uv-win.ps1

# 3. 重启 PowerShell 使环境变量生效

# 4. 创建项目目录
mkdir my_project
cd my_project

# 5. 初始化项目
uv init

# 6. 创建虚拟环境
uv venv

# 7. 打开 VS Code
code .

# 8. 在 VS Code 中安装依赖
uv add requests flask

# 9. 运行项目
uv run python main.py

常见问题

环境变量不生效： 安装完成后务必重启 PowerShell 窗口
版本切换： 使用 pyenv local 可在不同项目使用不同 Python 版本
虚拟环境激活： 使用 uv run 命令无需手动激活虚拟环境
依赖管理： 推荐使用 uv add 而非 pip install，可自动更新 pyproject.toml