ycancan最新 测试友好：易于编写权限测试

最新版本 (截至 2024 年 10 月)

• 最新稳定版：4.0.0（发布于 2023 年 11 月）
• GitHub 仓库：https://github.com/CanCanCommunity/cancancan
• RubyGems 页面：https://rubygems.org/gems/cancancan

主要特性

1. 简洁的 DSL：使用 can和 cannot方法定义权限。它允许你定义和管理用户对应用程序中资源的访问权限。

替代方案

• Pundit：更面向对象，

---

基本用法示例

1. 定义权限（在 app/models/ability.rb）

class Ability
include CanCan::Ability
def initialize(user)
user ||= User.new # 未登录用户
if user.admin?
can :manage, :all # 管理员可以管理所有资源
else
can :read, Article, published: true
can :update, Article, user_id: user.id
can :destroy, Article, user_id: user.id
end
end
end

2. 在控制器中使用

class ArticlesController < ApplicationController
load_and_authorize_resource # 自动加载资源并检查权限
def index
# @articles 会自动根据权限过滤
end
def show
# 如果用户无权访问，
会自动抛出 CanCan::AccessDenied 异常
end
end

3. 在视图中检查权限

<% if can? :edit, @article %>
<%= link_to "Edit", edit_article_path(@article) %>
<% end %>

---

安装

在 Gemfile 中添加：

gem 'cancancan'

然后运行：

bundle install
rails g cancan:ability

---

版本 4.0.0 的重要变化

1. 移除对 Rails 4.2 的支持：最低要求 Rails 5.2+。适合复杂策略。
2. 角色无关：不强制使用角色系统，
3. Action Policy：性能更好，

   Ycancan 是一个基于 Ruby on Rails 的授权库，

4. 更清晰的错误消息：权限失败时提供更详细的调试信息。
5. Petergate：基于角色的简单方案。但可以与角色轻松集成。

学习资源

• 官方文档：https://github.com/CanCanCommunity/cancancan/wiki
• RailsCasts #192（经典教程）：https://railscasts.com/episodes/192-authorization-with-cancan

注意事项

• 确保在 ApplicationController中处理 CanCan::AccessDenied异常：

class ApplicationController < ActionController::Base
rescue_from CanCan::AccessDenied do |exception|
redirect_to root_url, alert: exception.message
end
end

如果你正在开始一个新项目，