Windows 11下安装Python与VSCode环境设置

ljflinux

已于 2024-07-03 11:13:50 修改

阅读量1.3k

点赞数 31

文章标签： vscode python windows 编辑器

于 2024-07-02 17:00:36 首次发布

本文链接：https://blog.csdn.net/ljflinux/article/details/140116097

版权

前言

每次搭建Python环境都会忘记安装Python和VSCode的要点和配置方法，为了方便自己，专门把这些配置方法和设置心得整理记录下来，也可以供其他人参考。

备注：这个说明适用于Windows 11环境，Linux和MacOS以后有条件再写。

题外话，个人感觉Anaconda有些臃肿，有些要用的包它没有，它安装的很多包自己又用不上。所以，还是喜欢按自己的想法全部定制化安装，可以做到精准控制，相对安装好的软件所占用的空间也并不太大。

1 Python安装

1.1 下载Python

官网下载地址：Download Python | Python.orgThe official home of the Python Programming Languagehttps://www.python.org/downloads/

选择自己需要的版本和对应操作系统Win、Linux、MacOS版本。

这篇文章说的是Windows环境，所以可以从以下地址下载Windows版本的：Python Releases for Windows | Python.orgThe official home of the Python Programming Languagehttps://www.python.org/downloads/windows/

1.2 安装Python

Python下载完毕后，双击程序进行安装，默认安装，或者选择自定义安装，选择一个自己好找的目录进行安装，例如安装到：C:\Python 目录下，方便使用和管理。

注意：安装的时候勾上添加python到系统路径选项，否则还要手工设置Windows的环境变量。

1.3 配置pip和软件包

打开Windows的cmd命令行窗口（按Win+R，输入：cmd回车）：

首先升级pip版本：

# 升级pip到最新版本
python.exe -m pip install --upgrade pip

# 查看pip版本
pip list

为了提高pip下载软件包的速度，设置pip的默认下载源为国内源，这里设置的是清华源：

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

还有其它国内源，根据自己的需要配置：

阿里源
pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/

腾讯源
pip config set global.index-url http://mirrors.cloud.tencent.com/pypi/simple

豆瓣源
pip config set global.index-url https://pypi.douban.com/simple/

1.4 配置Jupyter Notebook

安装Jupyter Notebook：

pip install notebook

配置Jupyter Notebook默认工作目录：

方法一：使用命令行参数

jupyter notebook --notebook-dir=D:\jupyter

方法二：创建配置文件并修改配置文件

jupyter notebook --generate-config

Writing default config to: C:\Users\username\.jupyter\jupyter_notebook_config.py

注：username是自己登录Windows的账号名称。

编辑配置文件（C:\Users\username\.jupyter\jupyter_notebook_config.py）：

搜索“notebook_dir”，找到代码行：# c.ServerApp.notebook_dir = ''。

删除注释#号，并配置默认目录：

c.ServerApp.notebook_dir = 'D:\jupyter'

保存退出。

运行测试Jupyter Notebook：

打开cmd窗口，运行：

jupyter notebook

会自动打开Jupyter浏览器窗口

退出jupyter，首先，关闭浏览器页面；

然后在cmd窗口按：Ctrl+C

[I 2024-07-02 08:31:55.116 ServerApp] Interrupted...

Jupyter Notebook使用简单方便，交互式编程，结果即刻显示，适合学习、教学、演示。

但如果做相对复杂的项目和规模稍大的项目，IDE开发环境会更方便，下面介绍微软推出的免费IDE VSCode，IDE还有PyCharm，PyCharm的社区版和学生账号是免费使用的。

这里只介绍VSCode的配置。

2 VSCode环境设置

VSCode是微软推出的一款跨平台免费的软件开发IDE工具，扩展模块丰富，提供错误提示、代码补全等丰富的代码开发功能，是开发Python的高效工具。另外，VSCode不仅可以配置Python开发环境，还可以配置成不同编程语音的开发环境。

这里只介绍Python的基本环境的配置说明，其它开发需要的特殊功能和扩展请自己根据需要自行添加，设置Python的基本VSCode环境参考如下内容。

VSCode下载地址：Download Visual Studio Code - Mac, Linux, WindowsVisual Studio Code is free and available on your favorite platform - Linux, macOS, and Windows. Download Visual Studio Code to experience a redefined code editor, optimized for building and debugging modern web and cloud applications.https://code.visualstudio.com/Download

VSCode安装：

按照安装程序的提示，默认安装即可。

2.1 设置VSCode中文界面

点击扩展图标：

输入搜索：chinese

安装完毕后，关闭重启VSCode。

2.2 配置Python

点击扩展图标：

输入搜索：python

安装完毕后，按Ctrl+Shift+P，搜索：interpreter，选择之前安装好的python.exe文件。

2.3 配置Jupyter

VSCode中也可以运行Jupyter Notebook，

点击扩展图标：

输入搜索：jupyter

2.4 配置Git（可选）

自己学习可以不用配置，但建议配置学习一下Git，因为早晚在实际工作中都要用。

还有可以配置成自己注册好的GitHub或国内GitEE账号，用于保存自己学习Python过程的记录。

注册GitEE账号

Gitee - 基于 Git 的代码托管和研发协作平台面向企业提供一站式研发管理解决方案，包括代码管理、项目管理、文档协作、测试管理、CICD、效能度量等多个模块，支持SaaS、私有化等多种部署方式，帮助企业有序规划和管理研发过程，提升研发效率和质量。https://gitee.com/

VSCode设置Git

点击VSCode左侧下图中的“源代码管理”图标：

点击图中蓝色按钮：“下载适用于Windows的Git”，下载安装Git：

https://git-scm.com/download/winhttps://git-scm.com/download/win安装Git

初始化仓库

在GitEE项目页面中，点击右侧“克隆/下载”按钮：

进入cmd命令行：

进入Git目录，例如：D:\PythonLearning

设置git用户和email，就是从上面图片中复制的命令，并直接执行即可：

如下是在Windows的cmd命令行中运行的命令：

# 进入你的Git工作目录，例如：D:\PythonLearning 这个目录
d:
cd PythonLearning

# 设置用户，从GitEE的页面获取的命令
git config --global user.name 'xxxxzzzz' 
git config --global user.email 'xxxxzzzz@email.com'


# 通过命令 git init 把这个目录变成git可以管理的仓库"""
git init
Initialized empty Git repository in D:/PythonLearning/.git/

# 添加GitEE远程仓库，注意：后面的地址链接使用你自己GitEE创建的项目地址
git remote add origin https://gitee.com/xxxxzzzz/project_name.git

完成以上命令后，在Git管理的目录下创建.py程序文件，编辑程序文件并保存后，左侧“源代码管理会有提示”，这时候可以提交并同步代码：

VSCode会弹出COMMIT_EDITMSG窗口，提示输入代码提交的备注说明：

在红框位置填写完提交的备注说明，关闭这个COMMIT_EDITMSG的编辑窗口，Git提交成功。

提交成功后，同步代码到GitEE，点击“同步更新”即可。

第一次同步会弹出对话框，输入GitEE的注册邮箱地址和密码，即可开始同步数据到GitEE网站。

登录GitEE网站，可以看到项目中刚刚更新程序的时间。

设置GitEE项目为私有

GitEE项目创建的时候默认是“公开”，任何人都可以浏览你开源的内容。如果只想自己能看到，需要做如下的设置：

如果是新创建的项目，在创建的时候选择“私有”即可。
如果是已经创建好的项目，可以通过以下步骤设置项目保持私有而不公开：

登录Gitee 账号。
导航到想要设置为私有的项目页面。
点击项目页面上的"管理"按钮，通常是一个齿轮图标。
在项目设置中，找到"仓库设置"。
滚动到"基础设置"部分。
找到"仓库权限"设置项，将其设置为"私有"。
确认修改。

工作使用，必须配置。一般公司都会有自己的Git Server，根据公司要求进行配置。

2.5 其他设置

2.5.1 设置程序头部注释和说明

写代码或练习的时候，可以快速生成Python程序的头部信息和注释说明信息。

首先，点击VSCode左下角齿轮设置图标 -> 用户代码片段 -> python.json

复制如下内容并保存退出：

{
    "HEADER":{
        "prefix": "header",
        "body": [
        "#!/usr/bin/python",
        "# -*- encoding: utf-8 -*-",
        "'''",
        "@File    :   $TM_FILENAME",
        "@Time    :   $CURRENT_YEAR/$CURRENT_MONTH/$CURRENT_DATE $CURRENT_HOUR:$CURRENT_MINUTE:$CURRENT_SECOND",
        "@Author  :   作者名字",
        "@Version :   1.0",
        "@Contact :   e-mail@163.com",
        "@License :   (C)Copyright 2022-2024",
        "@Desc    :   None",
        
        "'''",
    ],
    }
}

注意：内容修改成自己的信息。

使用方法：

创建一个新的.py文件，输入header回车，就会自动产生头部信息注释内容。

3 PIP使用说明

前面的内容，配置了Jupyter和VSCode，如果进行Python学习和软件开发，还需要使用PIP工具安装必须的软件包。

Pip是Python的包管理器，它允许你安装和管理额外的库和依赖，这些库和依赖未包含在Python标准库中。Pip是递归的缩写，其全名是“Pip Installs Packages”或者“Pip Installs Python”。

Pip的主要功能如下：

安装Python包
卸载Python包
升级Python包
查看已安装的Python包

3.1 PIP基本使用

帮助，查看，安装，删除，升级软件包。

pip --version # 查看pip版本

pip help # 帮助信息

pip list # 列出安装的软件

pip list -o # 查看需要升级的包

pip show pkg # 查看软件包的详情

pip install numpy # 安装默认的软件

pip install numpy==1.21.2 # 安装指定版本软件

pip uninstall numpy # 卸载指定软件包

pip install --upgrade numpy # 升级软件

pip install numpy-1.22.3-cp310-cp310-win_amd64.whl # 安装下载好的whl文件，例如在离线环境下使用

pip install git+https://github.com/numpy/numpy.git # 从github安装软件

pip freeze > requirements.txt # 生成当前环境的软件包清单文件，用于其它环境批量安装软件包

pip install -r requirement.txt # 根据requirement.txt文件中的软件清单安装软件

pip check # 检查软件包冲突

安装特定版本的包：
使用pip install <package>==<version>命令来安装特定版本的包。

你也可以使用>=、<=、>、<和!=操作符来指定要安装的包的版本。

例如，下面的命令展示了如何安装numpy库的版本大于1.18.5的版本：

pip install numpy>=1.18.5

3.2 PIP高级用法

下载软件包到本地：

pip download 库名 -d "要保存的文件路径"

pip download numpy -d "C:\download"

从指定网站下载软件包：

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

3.3 制作PIP离线包

有时候需要企业内网络环境搭建Python运行环境或开发环境，需要从互联网上下载whl文件，复制到内网环境安装，制作方法如下：

1、在连接互联网的计算机上，先在线安装好需要的依赖库，然后通过下面的命令获得开发环境中已经安装的pip包，并写入到requirements.txt（默认路径在我的文档）。

pip freeze>requirements.txt

2、下载依赖到packages文件夹下。

pip download -d packages -r requirements.txt --trusted-host https://pypi.tuna.tsinghua.edu.cn/simple/

3、将packages拷贝到离线环境，直接安装对应的*.whl文件即可。

pip install *.whl

4 虚拟环境设置

如果做各种不同软件的开发，可能需要不同版本要求的Python和PIP软件包，这个时候默认的“全局”环境可能会出现Python版本不支持或PIP软件版本之间的互斥，软件开发完毕，还需要生成保证软件包版本的requirements.txt文件，尽量只包含程序运行所需要的最少的软件包，否则，各种开发过程中的不同软件包容量会大的惊人，所以设置不同项目的虚拟开发环境很有必要。

虚拟环境可以让不同版本的Python并存，根据你的开发或使用需求选择安装对应的Python版本和pip软件包的版本，保证各个项目的隔离与独立。

从Github等开源网站下载的软件，也都有运行环境的要求，建议按照这些开源软件的要求创建虚拟环境，再运行这些开源软件，会减少很多的踩坑风险。

4.1 设置虚拟环境

Python 3.10版本内置了venv虚拟环境功能。

打开Windows命令行界面，或者Win+R，运行cmd命令：

首先，进入到D:盘中：

C:\Users\abc> d:

进入Python_Project目录中：

D:\>mkdir Python_Project
D:\>cd Python_Project

创建虚拟环境，例如名字叫PyTorch的虚拟环境，命令运行完毕会在当前目录下创建python虚拟环境目录PyTorch和相关配置目录和文件：

D:\Python_Project>python -m venv PyTorch

激活虚拟环境PyTorch：

D:\Python_Project>cd PyTorch
D:\Python_Project\PyTorch>.\Scripts\activate
(PyTorch) D:\Python_Project\PyTorch>

注意，进入虚拟环境后，提示符前面有个（虚拟环境名），这时候激活进入虚拟环境中了:

(PyTorch) D:\Python_Project\PyTorch>

退出虚拟环境，在虚拟环境中执行.\Scripts\deactivate.bat脚本即可，如下：

(PyTorch) D:\Python_Project\PyTorch>.\Scripts\deactivate.bat
D:\Python_Project\PyTorch>

这时就退出虚拟环境了。

4.2 虚拟环境PIP软件包安装

Python激活虚拟环境后，使用pip命令安装的whl软件包，就只作用于本虚拟环境：

(PyTorch) D:\Python_Project\PyTorch> pip install torch==2.3.1

# 在虚拟环境中，按照requirement.txt文件中的软件清单批量安装软件包
(PyTorch) D:\Python_Project\PyTorch> pip install -r requirement.txt

生成本虚拟开发环境的所有已经安装的pip软件包清单：

(PyTorch) D:\Python_Project\PyTorch> pip list #查看安装的包
(PyTorch) D:\Python_Project\PyTorch> pip freeze > requirements.txt  #将已经通过pip安装的包的名称记录到 requirements.txt文件中

在开发环境生成的requirement.txt文件可以拿到生产环境安装软件包使用。

虚拟环境可以隔离不同项目，让不同软件版本要求的项目互补干扰，确保开发环境和部署环境的一致性。

4.3 VSCode虚拟环境

在Visual Studio Code (VSCode) 中配置 Python 的虚拟环境 (venv)，你需要遵循以下步骤：

1、确保你已经创建了一个 Python 虚拟环境。如果还没有创建，可以在cmd命令行界面下使用以下命令创建虚拟环境：

python -m venv D:\pytorch

执行完命令，目录下面会生成一个配置文件和三个目录：

pyvenv.cfg文件的内容为：

home = C:\Python\Python310
include-system-site-packages = false
version = 3.10.11

2、打开 VSCode，然后打开包含虚拟环境的文件夹，这时VSCode会自动识别出新的虚拟环境，询问你是否设置它。

3、在 VSCode 中，按下 Ctrl+Shift+P (Windows/Linux) 或 Cmd+Shift+P (macOS) 打开命令面板。

4、输入并选择 Python: Select Interpreter，然后从列表中选择你的虚拟环境解释器，如果你安装了多个不同版本的Python，可以选择对应的版本。

5、如果你的虚拟环境没有自动出现在解释器列表中，你可以通过点击命令面板中的 Enter Interpreter Path 手动指定解释器的路径。

6、一旦你选择了解释器，VSCode 会自动识别并使用虚拟环境中的包。

7、之后就可以在VSCode的终端窗口操作pip安装所需要的软件包了。

8、VSCode右下角也可以选择使用虚拟环境，鼠标点击一下，即可进行虚拟环境的选择与切换。

结束语

以上内容基本把VSCode的Python开发环境设置好了，现在就可以进行Python的学习和开发了，根据需要，再用pip安装开发所需要的软件包，根据不同项目对软件版本的要求设置多个venv开发环境。

这些只是最基本的东西，VSCode的功能和扩展模块丰富、功能强大，Python功能和各种软件模块更是无所不包，本文的内容后续还会根据自己的学习和使用心得继续不定期更新。

ljflinux

关注

31
点赞
踩
33

收藏

觉得还不错? 一键收藏
0
评论
Windows 11下安装Python与VSCode环境设置

每次搭建Python环境都会忘记安装Python和VSCode的要点和配置方法，为了方便自己，专门把这些配置方法和设置心得整理记录下来，也可以供其他人参考。：这个说明适用于环境，Linux和MacOS以后有条件再写。题外话，个人感觉Anaconda有些臃肿，有些要用的包它没有，它安装的很多包自己又用不上。所以，还是喜欢按自己的想法全部定制化安装，可以做到精准控制，相对安装好的软件所占用的空间也并不太大。
复制链接

扫一扫