企业官网建设流程全解析

1. 当Android Studio终端突然罢工：从cmd到PowerShell的转变

最近升级Android Studio后，突然发现Terminal里熟悉的gradlew命令报错了？这不是你的问题，而是Android Studio悄悄把默认终端从cmd换成了PowerShell。这个变化看似微小，却让不少开发者踩了坑。我自己在升级到Dolphin 2021.3.1版本时就中招了，明明昨天还能正常运行的构建脚本，今天突然提示"无法将'gradlew'项识别为cmdlet"。

PowerShell和cmd虽然都是Windows下的命令行工具，但它们的执行机制完全不同。cmd是传统的命令提示符，而PowerShell是更现代的脚本环境。最明显的区别就是：在cmd中可以直接输入gradlew执行脚本，但在PowerShell中必须加上./前缀。这就好比在cmd里你喊一声"开灯"就能亮灯，而在PowerShell里必须说"请执行开灯操作"才行。

2. 为什么PowerShell这么"矫情"？安全机制详解

2.1 执行策略的差异

PowerShell有个很重要的安全特性叫执行策略(Execution Policy)，它决定了哪些脚本可以运行。默认情况下，PowerShell不允许直接执行当前目录下的脚本，这是为了防止恶意脚本的自动执行。你可以通过以下命令查看当前策略：

Get-ExecutionPolicy

常见的策略包括：

• Restricted：默认设置，禁止所有脚本执行
• AllSigned：只允许运行受信任发布者签名的脚本
• RemoteSigned：本地脚本可以直接运行，远程脚本需要签名
• Unrestricted：允许所有脚本运行（不推荐）

2.2 路径解析的玄机

另一个关键区别是路径解析方式。在cmd中，输入gradlew时系统会自动在当前目录查找可执行文件。但PowerShell不会自动搜索当前目录，除非你把当前目录加入$env:PATH环境变量。这就是为什么必须使用.\gradlew的语法——那个点斜杠(./)明确告诉PowerShell："就在当前目录找这个文件"。

这其实是个好设计，避免了恶意程序通过在当前目录放置同名可执行文件进行攻击。想象一下，如果你cd到一个陌生目录，不小心运行了恶意伪造的gradlew脚本，后果可能很严重。

3. 一劳永逸的解决方案：让PowerShell乖乖听话

3.1 临时解决方案：正确使用./前缀

最简单的解决方法就是在gradlew前加上./：

.\gradlew assembleDebug

注意斜杠方向也很重要：

• Windows风格：.\gradlew
• Unix风格：./gradlew（在PowerShell中也有效）

3.2 永久解决方案：修改PowerShell配置

如果你觉得每次加./太麻烦，可以修改PowerShell的配置文件：

1. 首先创建配置文件（如果不存在）：

if (!(Test-Path -Path $PROFILE )) { New-Item -Type File -Path $PROFILE -Force }

2. 用记事本打开配置文件：

notepad $PROFILE

3. 添加以下内容，将当前目录加入PATH：

$env:Path += ";."

4. 保存后重新加载配置：

. $PROFILE

不过要注意，这样做会降低安全性，因为PowerShell现在会在当前目录搜索可执行文件了。

3.3 更优雅的替代方案：创建别名

另一个折衷方案是创建gradlew的别名：

function RunGradlew { .\gradlew @args } Set-Alias -Name gradlew -Value RunGradlew

把这行也加入你的$PROFILE文件，之后就可以直接输入gradlew了，实际上PowerShell会在背后帮你加上./。

4. 深入理解：为什么gradlew在cmd能直接运行？

4.1 cmd的查找机制

在传统cmd中，当你输入gradlew时，系统会按照以下顺序查找：

1. 内部命令
2. 当前目录下的.exe/.com/.bat文件
3. PATH环境变量中的目录

所以即使不加./，cmd也能找到当前目录下的gradlew.bat文件。

4.2 gradlew.bat的奥秘

打开项目中的gradlew.bat文件，你会发现它其实是个Windows批处理脚本，主要做两件事：

1. 检查Java环境
2. 调用gradle wrapper的jar包

而gradlew文件（无扩展名）是Unix/Linux下的shell脚本。PowerShell能够识别并执行这两种文件，但必须明确指定路径。

5. 其他你可能遇到的PowerShell"怪癖"

5.1 文件编码问题

如果你在PowerShell中看到gradlew脚本报编码错误，可能是因为文件保存的编码格式不对。gradlew脚本应该使用UTF-8 without BOM编码保存。可以用以下命令转换：

Get-Content gradlew | Out-File -Encoding utf8 gradlew_fixed mv -Force gradlew_fixed gradlew

5.2 行尾符差异

Windows使用CRLF(\r\n)，而Unix使用LF(\n)。如果从Git检出的gradlew脚本报错，可能是行尾符问题。解决方法：

git config --global core.autocrlf input git rm --cached -r . git reset --hard

5.3 权限问题

第一次运行gradlew时可能会遇到权限错误，因为新下载的脚本默认没有执行权限。修复方法：

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass .\gradlew --version

这只会临时修改当前PowerShell进程的执行策略，不会影响系统全局设置。

6. 终极建议：适应PowerShell的新特性

虽然初期可能会遇到些兼容性问题，但长期来看PowerShell比cmd强大得多。它支持管道对象（而不仅仅是文本）、丰富的命令集、更好的脚本功能等。建议可以：

1. 学习基本的PowerShell命令如Get-ChildItem(类似ls)、Where-Object(类似grep)
2. 利用Tab键自动补全功能
3. 探索PowerShell的脚本调试能力

我在项目组全面转向PowerShell后，发现很多原本需要复杂批处理的任务现在用几行PowerShell脚本就能搞定，特别是处理JSON输出、调用REST API等场景。