WebStorm 安装全攻略 (2025 最新版)
WebStorm 是 JetBrains 公司出品的一款功能强大的 JavaScript IDE,为前端开发提供了顶级的代码编辑、调试和项目管理体验,本教程将引导你完成从零开始的安装和配置。

(图片来源网络,侵删)
第一部分:准备工作
在开始安装之前,请确保你已经:
-
一台可用的电脑:
- 操作系统:Windows 10/11, macOS 10.15+, 或主流 Linux 发行版 (如 Ubuntu, Fedora)。
- 内存:建议至少 8GB,推荐 16GB 或以上,以保证流畅运行。
- 硬盘空间:至少需要 2GB 的可用空间。
-
一个 JetBrains 账户:
- 这是必须的,因为 WebStorm 是付费软件,你需要一个账户来下载、激活和管理许可证。
- 访问 JetBrains 官网 点击 "Sign In / Sign Up" 创建一个免费账户。
第二部分:下载 WebStorm
-
访问官网:
(图片来源网络,侵删)- 打开浏览器,访问 WebStorm 官方下载页面:https://www.jetbrains.com/webstorm/download/
-
选择版本:
- Stable Channel (稳定版):这是大多数用户的选择,经过充分测试,非常稳定,推荐新手和日常开发使用。
- EAP (Early Access Program, 预览版):包含最新功能,但可能存在不稳定的问题,适合希望体验新功能的开发者。
- 我们以 稳定版 为例进行讲解。
-
选择操作系统:
- 网站会自动检测你的操作系统,并提供对应的下载选项。
- Windows: 提供
.exe安装程序。 - macOS: 提供
.dmg磁盘映像文件。 - Linux: 提供
.tar.gz压缩包。
-
下载:
点击 "Download" 按钮开始下载。
(图片来源网络,侵删)
第三部分:安装步骤 (分操作系统详解)
A. Windows 系统安装 (以 .exe 为例)
-
运行安装程序:
- 下载完成后,找到
WebStorm-<version>.exe文件,双击运行。 - 如果系统弹出“用户账户控制”对话框,点击“是”以允许程序对计算机进行更改。
- 下载完成后,找到
-
选择安装选项:
- Destination Folder:选择安装路径,默认路径即可,如果你 C 盘空间不足,可以更改为其他盘符。
- 64-bit launcher:勾选此项,为 64 位系统创建快捷方式。
- Create Desktop Shortcut:勾选此项,在桌面创建快捷方式。
- Update PATH variable (restart needed):强烈建议勾选此项,这会将 WebStorm 添加到系统环境变量中,你就可以在任何目录下通过命令行启动 WebStorm。
-
开始安装:
点击 "Install" 按钮,等待安装进度条完成。
-
完成安装:
- 安装完成后,点击 "Next" -> "Finish"。
- 如果勾选了 "Update PATH",此时需要重启电脑使配置生效。
B. macOS 系统安装 (以 .dmg 为例)
-
挂载 DMG 文件:
- 下载完成后,双击
WebStorm-<version>.dmg文件,它会挂载成一个虚拟磁盘。
- 下载完成后,双击
-
拖拽到应用程序:
- 在弹出的窗口中,你会看到一个名为 "WebStorm" 的图标,还有一个名为 "Applications" (应用程序) 的文件夹图标。
- 将 WebStorm 图标直接拖拽到 Applications 文件夹图标中,这是 macOS 应用安装的标准方式。
-
打开 WebStorm:
- 打开你的 "应用程序" 文件夹,找到 WebStorm,双击打开。
- 首次打开时,系统可能会提示你“来自身份不明的开发者”,无法打开,这是因为你从官网下载,未经过 Apple 的公证。
- 解决方法:
- 进入 系统偏好设置 > 安全性与隐私。
- 在通用标签页下,你会看到一条关于 WebStorm 的警告信息。
- 点击 “仍要打开” 或解锁后点击 “允许来自以下位置的应用”,然后选择 WebStorm。
-
完成安装:
之后就可以正常启动和使用 WebStorm 了。
C. Linux 系统安装 (以 .tar.gz 为例)
在 Linux 上,推荐使用 tar.gz 压缩包进行安装,这种方式最通用,不会污染系统包管理器。
-
下载并解压:
- 打开终端,使用
cd命令进入你下载文件的目录。 - 执行以下命令进行解压(请将文件名替换为你实际下载的文件名):
tar -xzf WebStorm-<version>.tar.gz
- 解压后,会生成一个名为
WebStorm-<version>的文件夹。
- 打开终端,使用
-
移动到 opt 目录 (推荐):
- 为了方便管理,通常会将大型软件移动到
/opt目录下。sudo mv WebStorm-<version> /opt/webstorm
- 为了方便管理,通常会将大型软件移动到
-
创建桌面快捷方式:
- 为了能像其他应用一样方便地启动,我们创建一个
.desktop文件。 - 创建一个文件,
webstorm.desktop:sudo nano /usr/share/applications/webstorm.desktop
- 在文件中输入以下内容(请确保路径正确):
[Desktop Entry] Version=1.0 Type=Application Name=WebStorm Icon=/opt/webstorm/bin/webstorm.svg Exec="/opt/webstorm/bin/webstorm.sh" %f Comment=A powerful IDE for modern web development Categories=Development;IDE; Terminal=false StartupNotify=true
- 保存并退出 (在
nano中是Ctrl+X,然后按Y,再按Enter)。
- 为了能像其他应用一样方便地启动,我们创建一个
-
赋予执行权限:
- 为了能通过命令行启动,需要给启动脚本添加执行权限。
sudo chmod +x /opt/webstorm/bin/webstorm.sh
- 你可以在应用菜单中找到 WebStorm,或者在终端中输入
webstorm来启动它。
- 为了能通过命令行启动,需要给启动脚本添加执行权限。
第四部分:激活与配置
安装完成后,首次启动 WebStorm 会要求你进行激活和配置。
-
启动 WebStorm:
双击桌面快捷方式或在应用菜单中打开 WebStorm。
-
选择导入设置:
- 如果是第一次使用,选择 "Do not import settings"。
- 如果你之前安装过其他 JetBrains 产品(如 IntelliJ IDEA),可以选择从那里导入设置。
-
激活 WebStorm:
- 这是最关键的一步,弹出的激活窗口提供了几种方式:
- Trial (30天免费试用):如果你只是想先试用一下,可以选择此选项,试用期结束后,你需要购买许可证才能继续使用。
- License server:
- 这是最受欢迎的激活方式之一,使用一个公共的许可证服务器地址,可以免费激活 JetBrains 全家桶。
- 注意:公共 License Server 地址可能随时失效或被封禁,你需要在网上搜索最新的、可用的 License Server 地址(通过搜索引擎搜索 "JetBrains License Server 2025")。
- 在 "License server address" 输入框中填入你找到的有效地址,然后点击 "Activate"。
- Activation code:
如果你购买了正版许可证,会收到一个激活码,在这里输入即可。
- Account:
登录你的 JetBrains 账户,如果你的账户下有有效的许可证(你个人购买的,或公司/学校提供的),会自动激活。
- 这是最关键的一步,弹出的激活窗口提供了几种方式:
-
配置主题和插件:
- 成功激活后,WebStorm 会引导你完成一些初始配置。
- Appearance (外观):选择你喜欢的主题,如 "IntelliJ Light"(亮色)、"Darcula"(暗色)或 "High contrast"(高对比度),暗色主题是开发者的最爱。
- Plugins (插件):WebStorm 已经包含了开箱即用的核心功能,但你还可以安装更多插件来增强功能。
- 推荐插件:
- Prettier: 代码格式化工具,保持代码风格统一。
- ESLint: 代码质量检查工具,发现潜在问题。
- Vue.js: 如果你开发 Vue 项目,安装此插件可以获得更好的支持。
- React: 如果你开发 React 项目,安装此插件。
- 你可以在
Settings/Preferences>Plugins中搜索并安装。
- 推荐插件:
第五部分:首次使用与技巧
-
创建新项目:
File>New>Project...- 选择你想要创建的项目类型,如
HTML5,Node.js Express,React,Vue等,然后选择项目路径和包管理器(npm, yarn, pnpm),点击 "Create"。
-
常用快捷键:
- Windows/Linux:
Ctrl + Shift + A: 搜索任何操作或设置。Ctrl + N: 快速查找类/文件。Ctrl + Shift + N: 快速查找文件。Ctrl + Alt + L: 格式化代码。Ctrl + /: 注释/取消注释代码。Alt + Enter: 智能修复代码问题。
- macOS:
Cmd + Shift + A: 搜索任何操作或设置。Cmd + O: 快速查找类/文件。Cmd + Shift + O: 快速查找文件。Cmd + Option + L: 格式化代码。Cmd + /: 注释/取消注释代码。Alt + Enter: 智能修复代码问题。
- Windows/Linux:
-
更新 WebStorm:
Help>Check for Updates...,WebStorm 会定期检查并提供更新。
恭喜!现在你已经成功安装并配置好了 WebStorm,它是一个功能极其丰富的工具,随着你使用的深入,你会发现越来越多能极大提升开发效率的特性,如果你在使用过程中遇到任何问题,可以随时查阅 WebStorm 官方文档,或者使用 Ctrl+Shift+A 搜索功能,它几乎能回答你所有关于 IDE 操作的问题。
祝你编码愉快!
