Pycharm 或 VSCode 开发本地和远程Python项目（使用虚拟环境，避免Anaconda!）（包含 pip install 换源）

原创于 2025-10-02 09:33:52 发布 · 1.4k 阅读

26 ·

CC 4.0 BY-SA版权

文章标签：

#python #pycharm #vscode

介绍

手把手从0开始教你使用PyCharm开发本地和远程Python项目（使用虚拟环境），新手必看！

拒绝下载Anaconda，繁重，占用空间，环境管理混乱。

使用PyCharm的虚拟环境可以一个项目一个独立的环境，需要什么包就下载什么包，互不干扰，特别是包的版本问题。

注意，都是在Windows平台，Linux平台可以在Windows平台远程开发即可，尽管提供了Linux版本（见后）。

一、Python下载安装

进入Python官网的下载区，https://www.python.org/downloads/，目前最新是3.13.0版本

在这里插入图片描述

双击下载下来的 python-3.13.0-amd64.exe（3.13版本是当前最新的（一般最新的刚出来先别用），更推荐3.11版本，兼容性强，点击下面的Windows就能找到）

在这里插入图片描述

这里默认下一步next即可（注意pip一定要勾选，因为要使用它下载别的包）

在这里插入图片描述

点击Browse修改Python安装位置，这里为 D:\Python，注意记住（能找到）这个位置，然后点击 Install，等待…

在这里插入图片描述

出现此页面，successful，点击close，Python安装完毕。

二、PyCharm下载安装

PyCharm 是由 JetBrains 开发的一款功能强大的 Python 集成开发环境（IDE）。提供了丰富的工具和功能。

PyCharm 是一个非常适合 Python 开发者的 IDE，无论是初学者还是经验丰富的开发者都能从中受益。

强烈推荐 PyCharm 作为 Python 开发首选 IDE ！！！

进入官网，https://www.jetbrains.com.cn/pycharm/download/?section=windows

在这里插入图片描述

注意，请下载专业版（Professional），选择Windows版本，下面也有社区版，是免费的，但是不支持远程开发，为此这里选择专业版，最新版本 2024.2.4

双击下载下来的 pycharm-professional-2024.2.4.exe

在这里插入图片描述

下一步

在这里插入图片描述

下一步

在这里插入图片描述

下一步

在这里插入图片描述

安装，等待…

在这里插入图片描述

完成

三、Pycharm 创建第一个项目并配置环境

Windows本地项目开发

双击桌面Pycharm打开

会提示你激活，激活的办法这里不说明，请支持正版！！！，激活后先退出

开始创建项目：

第一种方法，你可以进入Pycharm，左上角，文件，新建项目…

第二种方法，你可以在某个位置新创建一个文件夹（假设为 FirstProject）作为项目文件夹，右击新创建的项目文件夹 FirstProject，显示更多选项（Win11才需要），Open Folder as PyCharm Project

注意，第一次使用Pycharm可能是英语界面，切换为中文界面

在这里插入图片描述

点击左上角主菜单

在这里插入图片描述

点击 File—Settings…——Plugins，可以搜索 Chinese (Simplified) Language Pack / 中文语言包，如果已经预先安装了，Enable即可，如果没有，先安装一下，最后重启 IDE 即可。

再打开项目

在这里插入图片描述

关键！！！点击左下角配置解释器（没有解释器PyCharm就是个编辑器，无法执行Python程序）

在这里插入图片描述

选择添加新的解释器——添加本地解释器…

在这里插入图片描述

选择 Virtualenv 环境——新建，填写位置和基础解释器，位置是虚拟环境（例如各种包）存放的位置，默认是在你当前项目文件夹下，基础解释器，选择之前我们下载Python存放的文件夹的python.exe，默认也是可以给你自动识别出来的，基本这两项都不用自己填，注意一些就行。

点击确定，左下角变为 Python 3.13 (FirstProject)，解释器配置成功，项目文件夹出现 .venv 文件夹存放包（即虚拟环境）

在这里插入图片描述

下面做一个项目，正弦波可视化，需要安装 numpy 和 matplotlib 包。

我们在项目文件夹下新建一个Python文件，右击FirstProject——新建——Python文件，命名为first，我们写入两句导包代码

在这里插入图片描述

发现 numpy、matplotlib 下面是红色波浪线，原因是没有下载此包（或者没找到包）

下面开始安装包，点击左下角终端按钮

在这里插入图片描述

在光标闪烁处通过以下命令安装它们

pip install numpy
pip install matplotlib

⚠️注意，可以切换成国内的清华镜像源（也有其他的镜像源），速度更快，不切换可能速度非常墨迹，半天下不动

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple numpy
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple matplotlib
# 下载任何包都可以在前面加上 pip install -i https://pypi.tuna.tsinghua.edu.cn/simple

或者一起安装

pip install numpy matplotlib
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple numpy matplotlib

在这里插入图片描述

然后你发现波浪线消失，说明包成功下载并导入，在 .venv 文件夹你可以发现 numpy、matplotlib 文件夹生成在这里了，.venv 文件夹就是来管理各种包的。

完成剩余的代码

import numpy as np
import matplotlib.pyplot as plt

# 设置参数
frequency = 1  # 频率
sampling_rate = 100  # 采样率
duration = 2  # 持续时间（秒）

# 生成时间轴
t = np.linspace(0, duration, int(sampling_rate * duration), endpoint=False)

# 生成正弦波
y = np.sin(2 * np.pi * frequency * t)

# 绘制图形
plt.figure(figsize=(10, 4))
plt.plot(t, y, label='Sine Wave', color='b')
plt.title('Sine Wave')
plt.xlabel('Time [s]')
plt.ylabel('Amplitude')
plt.axhline(0, color='black', lw=0.5, ls='--')
plt.axvline(0, color='black', lw=0.5, ls='--')
plt.grid()
plt.legend()
plt.show()

点击右上角绿色的▷按钮，运行

在这里插入图片描述

成功

如果你感兴趣，可以再创建一个项目，你会深刻感受到，当我们开始着手一个新的Python项目时，通常会涉及到使用多个第三方库，每个库可能需要特定的版本或依赖关系。同时，不同项目可能需要不同的Python版本。这时，虚拟环境就发挥了关键作用，我们让每个项目都单独使用各自的虚拟环境，这样可以更好地隔离项目之间的库，并避免全局Python环境的混乱。在虚拟环境中，你可以轻松地更新和卸载库，而不会影响其他项目。

Linux远程项目开发

大多数情况，假设要把本地的项目（以之前 FirstProject 为例）放到Linux服务器上运行（例如 AI 模型训练等等）

你可以先在Linux适当位置创建一个文件夹管理你的项目，比如我创建了 /home/FirstProjectLinux（记住，等会要用）

首先，Linux服务器上需要安装 Python

更新软件包列表

sudo apt update
sudo apt upgrade

安装 Python 和 pip（一定要安装 pip，否则无法用pip安装其他的包）

sudo apt install python3
sudo apt install python3-pip

查看Python版本，我这里是 Python 3.10.12

python3 --version

查看 Python 位置，我这里是 /usr/bin/python3，等会要用

which python3

打开FirstProject项目

点击右下角解释器——添加新的解释器——SSH…

在这里插入图片描述

填写自己Linux服务器的主机和用户名和端口号（没有让管理员帮你创建一个账户）

在这里插入图片描述

下一步，输入密码，内省完成，再下一步

在这里插入图片描述

按提示填写，最后创建

在这里插入图片描述

注意，这个.venv文件是Linux上隐藏文件，ls命令看不到（xftp也看不到），你可以改成 venv（更好）

点击右下角解释器，发现解释器变为服务器上的了

在这里插入图片描述

目前/home/FirstProjectLinux下还没文件，我们没有同步文件夹，点击左上角主菜单——工具——部署——上传到…，弹出选择你要上传到的服务器，选择自己的即可

在这里插入图片描述

由于我们刚刚已经设置过映射关系，所以会上传到/home/FirstProjectLinux文件夹，如果不放心，可以查看部署——配置…，或者你可以重新设置映射位置

在这里插入图片描述

上传完成后，我们可以在PyCharm打开Linux终端

在这里插入图片描述

cd /home/FirstProjectLinux
ls

可以看到出现 first.py 文件，说明成功上传

发现，first.py 又缺少包了，因为尽管本地虚拟环境有，但远程Linux服务器没有下载

在这里插入图片描述

使用PyCharm打开Linux终端（注意不是本地终端），输入命令

首先激活虚拟环境（非常重要）

cd /home/FirstProjectLinux
source .venv/bin/activate

可以看到命令提示前面多了(.venv) ，说明进入了虚拟环境

再安装

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple numpy matplotlib

等待更新解释器，如果不自动的话，手动点击右下角重新选择一下解释器，发现波浪线消失，安装成功

运行，成功

我们要修改py文件或者新建py文件（或其他文件），都是在某个py文件部署上传即可，远程py文件就更新了，或者你可以选择自动上传。

四、VSCode 下载安装

见 https://blog.youkuaiyun.com/shayudiandian/article/details/152359377?spm=1011.2415.3001.5331

五、VSCode 创建第一个项目并配置环境

待更新…