Profile 是什么
Profile 是 PowerShell 每次启动时自动执行的脚本，用来预置别名、函数、模块导入、编码与提示符等个人环境。它最容易被忽略的地方是「作用范围」：同一台机器上可能同时存在当前用户/所有用户、当前宿主/所有宿主共四个文件，生效的那一个决定了你的设置能不能被别的宿主或别的账户看到。排查「换台机器命令就不好使」，第一步就是确认 Profile 在哪、加载没加载。
基本信息
| 适用平台 | Windows PowerShell 5.1（Documents\WindowsPowerShell）与 PowerShell 7（Documents\PowerShell）各自独立 |
|---|---|
| 当前用户 | $PROFILE 为当前用户当前宿主，$PROFILE.CurrentUserAllHosts 对全部宿主生效 |
| 所有用户 | $PROFILE.AllUsersCurrentHost 与 $PROFILE.AllUsersAllHosts 位于 $PSHOME 下，需提权维护 |
| 查看路径 | 直接在命令行输入 $PROFILE 回车即可看到实际路径 |
| 加载条件 | 受执行策略限制；禁用脚本执行时 Profile 不生效 |
| 常见宿主 | 控制台、ISE、VS Code 集成终端各有自己的 CurrentHost Profile |
典型使用场景
- 统一别名：把常用长命令简化为短别名，减少重复输入
- 自定义函数：放日志封装、批量查询、编码修正等日常工具函数
- 环境初始化：设置默认输出编码、历史记录、代理与网络凭据提示
- 模块预加载：常用模块与自定义脚本路径一次性导入
- 提示符定制：在提示符里显示当前目录、Git 分支或时间
常用示例
常用示例
$PROFILE # 查看当前用户当前宿主的 Profile 路径
$PROFILE | Format-List * # 四个 Profile 路径一次看全
if (-not (Test-Path $PROFILE)) { New-Item -ItemType File -Path $PROFILE -Force } # 首次创建
notepad $PROFILE # 编辑（也可用 code $PROFILE）
powershell -NoProfile # 跳过 Profile 启动，用于对照排查
Get-ExecutionPolicy -List # 查看各作用域执行策略
. $PROFILE # 改完不重启会话，手工重新加载一次四个 Profile 的取舍
| Profile | 文件名 | 适用建议 |
|---|---|---|
| CurrentUserCurrentHost | Microsoft.PowerShell_profile.ps1 | 个人日常设置，最常用的一个 |
| CurrentUserAllHosts | profile.ps1 | 需要控制台、ISE、VS Code 都生效时 |
| AllUsersCurrentHost | $PSHOME 下同名文件 | 全机器统一设置，需提权、可能被组策略覆盖 |
| AllUsersAllHosts | $PSHOME\profile.ps1 | 影响面最大，改动前务必评估影响 |
Windows PowerShell 5.1 与 PowerShell 7 的 Profile 目录不同（WindowsPowerShell 与 PowerShell），在一侧设置别名后另一侧不生效是正常现象，两边都要配。
Profile 里的报错不会阻止会话启动，但每次开新窗口都会重放一遍错误，累积拖慢启动。用 -NoProfile 对比启动即可确认问题是否来自 Profile。
排查加载问题
排查加载问题
Test-Path $PROFILE # 文件是否存在
$PROFILE.CurrentUserAllHosts # 核对是否改错了作用域
Get-ExecutionPolicy -List # 检查是否有作用域被限制
powershell -NoProfile -Command '$PROFILE' # 非交互方式查看路径
Get-Command YourAlias -ErrorAction SilentlyContinue # 确认别名/函数是否真的加载服务、计划任务以非交互方式运行的 PowerShell 默认不加载 Profile。依赖 Profile 里自定义函数的脚本，在这些场景会直接报「无法识别的命令」，脚本必须自带依赖或显式导入模块。