Windows 安装 pylint：最稳妥的 3 种方法，新手也能一次装好

问题分析

pylint 是 Python 里很常用的代码检查工具，主要用来帮你找出代码里的语法问题、命名不规范、潜在 bug、风格错误等。
很多人在 Windows 上安装 pylint 时会遇到这些情况：

• pip install pylint 后提示命令找不到
• Python 装了好几个版本，不知道该装到哪个环境里
• VS Code 里提示没检测到 pylint
• 安装成功了，但运行时还是报错

这类问题大多数都不是 pylint 本身有问题，而是 Python 环境、pIP、PATH 路径、虚拟环境 没配置好。

下面直接给你整理成最实用的安装方案，从最简单到最稳妥，照着做就行。

---

解决方案

一、先确认你的 Windows 已经装好 Python

pylint 依赖 Python，所以第一步不是装它，而是先确认 Python 正常。

1. 打开命令提示符

按下：

• Win + R
• 输入 cmd
• 回车

2. 输入下面命令检查 Python

python --version

如果返回类似下面内容，说明 Python 已安装：

Python 3.11.6

如果提示：

• python 不是内部或外部命令
• 或者直接跳到微软商店

那说明 Python 没装好，或者环境变量没配好。

3. 再检查 pip

pip --version

正常情况下会显示类似：

pip 24.0 from ... (python 3.11)

如果 pip 也不能用，先别装 pylint，先把 Python 和 pip 修好。

---

二、最推荐的安装方式：用 python -m pip 安装

这是 Windows 上最稳的办法，比直接用 pip install pylint 更不容易出错。

1. 打开命令提示符或 PowerShell

然后输入：

python -m pip install pylint

如果你的系统里有多个 Python 版本，也可以用：

py -m pip install pylint

这个 py 是 Windows 的 Python 启动器，很多时候比直接敲 python 更靠谱。

2. 安装完成后验证

输入：

pylint --version

如果输出了版本号，说明安装成功，例如：

pylint 3.x.x
astroid ...

---

三、如果提示权限问题，换成当前用户安装

有些 Windows 电脑会因为权限限制，普通安装失败。

你可以用这个命令：

python -m pip install --user pylint

这个方式不会装到系统目录，而是装到当前用户目录，适合：

• 公司电脑
• 没有管理员权限的电脑
• 不想影响全局环境的情况

安装后如果 pylint 命令还是找不到，通常是因为脚本目录没进 PATH。

---

四、最稳妥的做法：在虚拟环境里安装 pylint

如果你是开发者，或者项目比较多，强烈建议用虚拟环境。
这样不会把不同项目的依赖搞乱。

1. 进入你的项目目录

例如：

cd D:\myproject

2. 创建虚拟环境

python -m venv .venv

3. 激活虚拟环境

如果你用的是 CMD：

.venv\Scripts\activate

如果你用的是 PowerShell：

.venv\Scripts\Activate.ps1

如果 PowerShell 提示执行策略问题，可以先执行：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

然后再激活。

4. 在虚拟环境中安装 pylint

pip install pylint

5. 检查是否成功

pylint --version

6. 使用示例

pylint your_script.py

这会直接检查你的 Python 文件。

---

Windows 上常见问题与修复方法

1. 输入 pylint 提示“不是内部或外部命令”

原因

通常是 pylint.exe 所在目录没有加入环境变量 PATH。

解决方法

先看 pylint 是否真的装上了：

python -m pip show pylint

如果能显示安装路径，说明装好了，只是命令找不到。

处理方式一：直接用 Python 调用

python -m pylint your_script.py

这是最省事的临时方案。

处理方式二：把 Scripts 目录加入 PATH

一般路径类似：

C:\Users\你的用户名\AppData\Roaming\Python\Python311\Scripts

或者：

C:\Users\你的用户名\AppData\Local\Programs\Python\Python311\Scripts

把这个目录加入系统环境变量后，重新打开命令行，再试：

pylint --version

---

2. pip install pylint 提示 SSL、网络失败

原因

常见于网络不稳定、公司代理、镜像源设置异常。

解决方法

可以换国内镜像源安装：

python -m pip install pylint -i https://pypi.tuna.tsinghua.edu.cn/simple

如果还是慢，可以加上超时参数：

python -m pip install pylint -i https://pypi.tuna.tsinghua.edu.cn/simple --timeout 100

---

3. 安装成功但 VS Code 里没识别 pylint

原因

VS Code 选错了 Python 解释器，或者没有装对应环境里的 pylint。

解决方法

1. 打开 VS Code
2. 按 Ctrl + Shift + P
3. 输入 Python: Select Interpreter
4. 选择你安装 pylint 的那个 Python 或虚拟环境
5. 再打开终端，执行：

python -m pip install pylint

如果你用的是虚拟环境，最好在该虚拟环境里安装 pylint。

还要检查 VS Code 设置

在 settings.json 里可以启用 pylint 检查：

"python.linting.enabled": true,
"python.linting.pylintEnabled": true

不过新版 VS Code Python 扩展里，静态检查方式会有变化，通常只要解释器选对，安装好 pylint 就能正常识别。

---

4. Python 装了多个版本，导致装错环境

原因

Windows 很容易同时存在：

• Python 3.10
• Python 3.11
• Anaconda
• Microsoft Store 版本

这会导致你装到 A 环境，运行却在 B 环境。

解决方法

先查看当前使用的是哪个 Python：

where python

再查看对应版本：

python --version

如果你想明确安装到某个版本，可以用：

py -3.11 -m pip install pylint

这个写法可以指定 Python 3.11 环境安装。

---

建议的标准安装流程

如果你是普通用户，最推荐按这个顺序来：

方法一：全局安装

python -m pip install pylint

方法二：网络慢时换源

python -m pip install pylint -i https://pypi.tuna.tsinghua.edu.cn/simple

方法三：项目开发推荐虚拟环境

python -m venv .venv
.venv\Scripts\activate
pip install pylint

---

使用 pylint 的基本命令

安装完成后，常用命令如下：

检查单个文件

pylint test.py

指定某个 Python 版本安装的环境

py -3.11 -m pylint test.py

查看版本

pylint --version

生成配置文件

如果你想自定义规则，可以生成一个配置文件：

pylint --generate-rcfile > .pylintrc

然后你可以按项目需要修改 .pylintrc。

---

注意事项

1. 不建议直接乱删 Python 目录

很多人安装失败后会直接删 Python 文件夹，结果把环境搞得更乱。
正确做法是先确认：

• Python 是否正常
• pip 是否正常
• PATH 是否正确
• 是否装错环境

2. 尽量不要混用多个 Python 管理方式

比如：

• 官方 Python
• Anaconda
• Microsoft Store Python

这些混着用，最容易出问题。
如果你是日常开发，建议优先用官方 Python + 虚拟环境。

3. 项目级开发优先用虚拟环境

这样每个项目都有自己的 pylint 版本，不容易冲突。

4. 终端不要开太多种

建议优先用：

• CMD
• PowerShell
• VS Code 集成终端

不要在不同终端里反复切换，容易看不清环境。

---

一套最适合小白的操作顺序

如果你完全不熟，直接照这 5 步做：

第 1 步：检查 Python

python --version

第 2 步：安装 pylint

python -m pip install pylint

第 3 步：检查是否成功

pylint --version

第 4 步：检查文件

pylint your_script.py

第 5 步：如果命令找不到，就用

python -m pylint your_script.py

---

总结

在 Windows 上安装 pylint，最稳的方式就是：

python -m pip install pylint

如果有多个 Python 版本，用：

py -m pip install pylint

如果网络慢，加镜像源：

python -m pip install pylint -i https://pypi.tuna.tsinghua.edu.cn/simple

如果是项目开发，建议直接上虚拟环境，这样最干净、最不容易冲突。

只要 Python 和 pip 正常，pylint 基本都能顺利装好。问题通常出在环境变量、解释器选择、多个 Python 版本冲突这几类地方。