安装编程环境需依次完成Python安装、创建隔离虚拟环境、配置VS Code编辑器并验证连通性;未正确配置会导致命令未找到或模块导入失败。

在笔记本电脑中安装编程环境,意味着你要让机器具备运行代码、调试程序、管理依赖的能力,而不是只装一个编辑器就以为万事大吉。这一步没做对,后续写十行代码都可能卡在“命令未找到”或“模块导入失败”上。
确认系统是否已预装Python
打开终端(Windows用CMD或PowerShell,macOS/Linux用Terminal),输入:
python3 --version
若返回类似 【Python 3.9.18】 的结果,说明系统自带Python3,可跳过下载;若提示“不是内部或外部命令”,则需手动安装。macOS自12.3起已移除系统级Python2,但Python3仍不预装;Linux发行版如Ubuntu通常预装python3,但CentOS Stream 9默认不带。
下载并安装Python官方解释器
方法一:Windows用户直接去 python.org/downloads 下载最新稳定版(当前为3.12.7),运行安装包时必须勾选“Add Python to PATH”,否则后续所有命令行操作都会失败。
方法二:macOS用户推荐用Homebrew安装,先在终端执行:
brew install python@3.12
该方式安装的python3会自动软链到 /opt/homebrew/bin/python3,且不会干扰系统路径。
方法三:Ubuntu/Debian系Linux用户执行:
sudo apt update && sudo apt install python3.12 python3.12-venv python3.12-dev
注意不要只装 python3,那通常是系统包管理器绑定的旧版本,开发时容易冲突。
创建隔离的项目环境
第一步:在命令行中进入你的项目文件夹,例如:
cd ~/projects/my_first_app
第二步:用Python 3.12自带的venv模块创建干净环境:
python3.12 -m venv .venv
第三步:激活该环境:
Windows PowerShell中执行:.\.venv\Scripts\Activate.ps1(首次需先运行 set-executionpolicy RemoteSigned -scope CurrentUser)
macOS/Linux中执行:source .venv/bin/activate
此时命令行提示符前会出现 (.venv),代表你已进入隔离环境。所有pip install安装的包只会存在这个文件夹里,不会污染全局Python。
选择并配置代码编辑器
Visual Studio Code(免费、轻量、插件生态成熟)是当前最稳妥的选择。下载安装后,必须安装Microsoft官方Python扩展,否则无法语法高亮、无法调试、无法智能补全。
安装扩展后,按 Ctrl+Shift+P(Windows)或 Cmd+Shift+P(macOS),输入“Python: Select Interpreter”,从列表中选择你刚创建的 .venv/bin/python(macOS/Linux)或 .venv\Scripts\python.exe(Windows)。这一步【必须手动指定,不能依赖自动检测】,否则VS Code会默认调用系统Python,导致你装在venv里的库全部不可见。
验证整个链条是否打通
在VS Code中新建 test.py,写入:
print("Hello from Python " + __import__("sys").version.split()[0])
保存后,按 Ctrl+F5 运行。如果终端输出类似 Hello from Python 3.12.7,且没有 ModuleNotFoundError,说明Python解释器、虚拟环境、编辑器三者已正确连通。











